Integrações Webhook

    Envie leads capturados e eventos para qualquer sistema externo em tempo real. Ligue o PilotAgent ao seu CRM, às suas ferramentas de notificação ou aos seus próprios endpoints. Disponível no Enterprise e no Enterprise+.

    Usa um CRM de concessionária? Adicione o e-mail de leads do seu CRM em Definições de leads, e os novos leads chegam direto a ele no formato ADF/XML.

    Como os Webhooks Funcionam

    Um webhook é um URL que recebe dados automaticamente quando algo acontece no PilotAgent. Quando um lead é capturado ou uma mensagem é enviada, o PilotAgent envia os detalhes para o seu URL de webhook instantaneamente.

    POST https://your-api.com/webhook Content-Type: application/json X-Webhook-Event: message.sent { "event": "message.sent", "timestamp": "2026-09-30T10:00:31.000Z", "conversation": { "id": "5b0e8f7a-2c1d-4e4b-9a57-3f1c2d8e6a10", "threadId": "1953209448598174", "url": "https://www.facebook.com/messages/t/1953209448598174", "buyerName": "Sarah", "listing": { "title": "4 bed house, Northwest Hills", "id": "1829285625158180", "url": "https://www.facebook.com/marketplace/item/1829285625158180/" }, "startedAt": "2026-09-30T09:58:12.000Z" }, "buyerMessage": { "text": "Can I view it on Saturday?", "readAt": "2026-09-30T10:00:05.000Z" }, "reply": { "text": "Yes, Saturday works. Is 10am good for you?", "writtenAt": "2026-09-30T10:00:05.000Z", "sentAt": "2026-09-30T10:00:31.000Z", "confirmed": true }, "transcript": [ { "from": "buyer", "name": "Sarah", "text": "Is this still available?" }, { "from": "pilotagent", "text": "Hi Sarah, yes it is. Would you like to view it?" }, { "from": "buyer", "name": "Sarah", "text": "Can I view it on Saturday?" }, { "from": "pilotagent", "text": "Yes, Saturday works. Is 10am good for you?" } ], "lead": null, "agent": { "id": "c2f4a9d1-7e3b-4a8c-b6d5-1e9f0a2b3c4d", "name": "Main account" }, "user": { "id": "9d8c7b6a-5f4e-4d3c-2b1a-0f9e8d7c6b5a", "email": "you@yourcompany.com" } }

    Configurar Webhooks

    1. 1No seu painel, abra Leads e depois Definições de leads
    2. 2Cole o seu URL de webhook (do Zapier, Make, n8n ou do seu próprio servidor)
    3. 3Marque os eventos a enviar: novos leads, novas conversas, cada resposta enviada
    4. 4Carregue em Enviar evento de teste para confirmar que o seu URL o recebe e guarde

    Eventos Suportados

    lead.captured

    Quando um comprador partilha os seus contactos: nome, email, telefone e morada

    message.sent

    Cada resposta que o PilotAgent envia: a mensagem do comprador, a resposta, a conversa toda e os contactos

    conversation.started

    A primeira vez que o PilotAgent responde a um comprador: a primeira mensagem, o anúncio e a conversa

    Cada evento tem um campo event e um cabeçalho X-Webhook-Event. Os eventos de conversa trazem a conversa toda tal como o PilotAgent a leu, por isso o seu sistema consegue sempre reconstruir a conversa completa. O Facebook não mostra a hora de cada mensagem, por isso as linhas não a têm; o evento e a resposta têm. Em message.sent, reply.confirmed é true quando o PilotAgent viu a resposta aparecer na conversa (extensão 2.0 ou posterior). As versões anteriores enviam-no assim que a resposta é escrita, com confirmed a false.

    Integrações Comuns

    HubSpot / Salesforce

    Criar automaticamente contactos a partir de leads capturados

    Google Sheets

    Adicionar uma nova linha para cada lead capturado via Zapier

    Slack / Alertas por Email

    Receba notificações em tempo real quando leads de alto valor chegam

    Lógica de Repetição

    Se o seu servidor não responder com um estado 2xx, o PilotAgent tenta de novo até 3 vezes: após 1, 5 e 15 segundos.