Integraciones webhook

    Envía leads capturados y eventos a cualquier sistema externo en tiempo real. Conecta PilotAgent con tu CRM, tus herramientas de notificaciones o tus propios endpoints. Disponible en Enterprise y Enterprise+.

    ¿Usas un CRM de concesionario? Agrega el correo de leads de tu CRM en Ajustes de leads, y los leads nuevos le llegarán directamente en formato ADF/XML.

    Cómo funcionan los webhooks

    Un webhook es una URL que recibe datos automáticamente cuando algo ocurre en PilotAgent. Cuando se captura un lead o se envía un mensaje, PilotAgent envía los detalles a tu URL de webhook al instante.

    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. 1En tu panel, abre Leads y luego Ajustes de leads
    2. 2Pega tu URL de webhook (de Zapier, Make, n8n o tu propio servidor)
    3. 3Marca los eventos que quieres enviar: nuevos leads, nuevas conversaciones, cada respuesta enviada
    4. 4Pulsa Enviar evento de prueba para comprobar que tu URL lo recibe y guarda

    Eventos compatibles

    lead.captured

    Cuando un comprador comparte sus datos de contacto: nombre, email, teléfono y dirección

    message.sent

    Cada respuesta que envía PilotAgent: el mensaje del comprador, la respuesta, todo el chat y los datos de contacto

    conversation.started

    La primera vez que PilotAgent responde a un comprador: su primer mensaje, el anuncio y el chat

    Cada evento lleva un campo event y una cabecera X-Webhook-Event. Los eventos de conversación incluyen todo el chat tal como lo leyó PilotAgent, así tu sistema siempre puede reconstruir la conversación completa. Facebook no muestra la hora de cada mensaje, así que las líneas del chat no la llevan; el evento y la respuesta sí. En message.sent, reply.confirmed es true cuando PilotAgent vio la respuesta en el chat (extensión 2.0 o posterior). Las versiones anteriores lo envían en cuanto se escribe la respuesta, con confirmed en false.

    Integraciones comunes

    HubSpot / Salesforce

    Crea contactos automáticamente a partir de leads capturados

    Google Sheets

    Añade una nueva fila por cada lead capturado a través de Zapier

    Slack / Alertas por correo

    Recibe notificaciones en tiempo real cuando lleguen leads de alto valor

    Lógica de reintentos

    Si tu servidor no responde con un estado 2xx, PilotAgent vuelve a intentarlo hasta 3 veces: a los 1, 5 y 15 segundos.