Intégrations webhook

    Envoyez les leads capturés et les événements vers n'importe quel système externe en temps réel. Connectez PilotAgent à votre CRM, à vos outils de notification ou à vos propres endpoints. Disponible sur Enterprise et Enterprise+.

    Vous utilisez un CRM de concessionnaire ? Ajoutez l'e-mail de leads de votre CRM dans Réglages des leads, et les nouveaux leads y arrivent directement au format ADF/XML.

    Comment fonctionnent les webhooks

    Un webhook est une URL qui reçoit des données automatiquement lorsque quelque chose se produit dans PilotAgent. Lorsqu'un lead est capturé ou qu'un message est envoyé, PilotAgent transmet les détails à votre URL de webhook instantanément.

    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" } }

    Configurer les webhooks

    1. 1Dans votre tableau de bord, ouvrez Leads, puis Réglages des leads
    2. 2Collez votre URL de webhook (depuis Zapier, Make, n8n ou votre propre serveur)
    3. 3Cochez les événements à envoyer : nouveaux leads, nouvelles conversations, chaque réponse envoyée
    4. 4Cliquez sur Envoyer un événement test pour vérifier que votre URL le reçoit, puis enregistrez

    Événements pris en charge

    lead.captured

    Quand un acheteur partage ses coordonnées : nom, email, téléphone et adresse

    message.sent

    Chaque réponse envoyée par PilotAgent : le message de l'acheteur, la réponse, toute la discussion et ses coordonnées

    conversation.started

    La première fois que PilotAgent répond à un acheteur : son premier message, l'annonce et la discussion

    Chaque événement a un champ event et un en-tête X-Webhook-Event. Les événements de conversation contiennent toute la discussion telle que PilotAgent l'a lue, votre système peut donc toujours reconstruire la conversation complète. Facebook n'affiche pas l'heure de chaque message, donc les lignes n'en ont pas ; l'événement et la réponse, si. Dans message.sent, reply.confirmed vaut true quand PilotAgent a vu la réponse apparaître dans la discussion (extension 2.0 et suivantes). Les versions plus anciennes l'envoient dès que la réponse est écrite, avec confirmed à false.

    Intégrations courantes

    HubSpot / Salesforce

    Créez automatiquement des contacts à partir des leads capturés

    Google Sheets

    Ajoutez une nouvelle ligne pour chaque lead capturé via Zapier

    Slack / Alertes email

    Recevez des notifications en temps réel lorsque des leads de grande valeur arrivent

    Logique de réessai

    Si votre serveur ne répond pas avec un statut 2xx, PilotAgent réessaie jusqu'à 3 fois : après 1, 5 et 15 secondes.