Integrazioni Webhook

    Invia lead acquisiti ed eventi a qualsiasi sistema esterno in tempo reale. Collega PilotAgent al tuo CRM, ai tuoi strumenti di notifica o ai tuoi endpoint. Disponibile con Enterprise ed Enterprise+.

    Usi un CRM per concessionari? Aggiungi l'email lead del tuo CRM in Impostazioni lead, e i nuovi lead arrivano direttamente in formato ADF/XML.

    Come funzionano i webhook

    Un webhook è un URL che riceve dati automaticamente quando qualcosa accade in PilotAgent. Quando un contatto viene acquisito o un messaggio viene inviato, PilotAgent invia i dettagli al tuo URL webhook istantaneamente.

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

    Configurazione dei webhook

    1. 1Nella tua dashboard, apri Lead e poi Impostazioni lead
    2. 2Incolla il tuo URL webhook (da Zapier, Make, n8n o dal tuo server)
    3. 3Spunta gli eventi da inviare: nuovi contatti, nuove conversazioni, ogni risposta inviata
    4. 4Premi Invia evento di prova per controllare che il tuo URL lo riceva, poi salva

    Eventi supportati

    lead.captured

    Quando un acquirente condivide i suoi recapiti: nome, email, telefono e indirizzo

    message.sent

    Ogni risposta che PilotAgent invia: il messaggio dell'acquirente, la risposta, tutta la chat e i recapiti

    conversation.started

    La prima volta che PilotAgent risponde a un acquirente: il suo primo messaggio, l'annuncio e la chat

    Ogni evento ha un campo event e un'intestazione X-Webhook-Event. Gli eventi di conversazione contengono tutta la chat come l'ha letta PilotAgent, così il tuo sistema può sempre ricostruire la conversazione completa. Facebook non mostra l'ora di ogni messaggio, quindi le righe della chat non ce l'hanno; l'evento e la risposta sì. In message.sent, reply.confirmed è true quando PilotAgent ha visto la risposta comparire nella chat (estensione 2.0 e successive). Le versioni precedenti lo inviano appena la risposta è scritta, con confirmed a false.

    Integrazioni comuni

    HubSpot / Salesforce

    Crea automaticamente contatti dai contatti acquisiti

    Google Sheets

    Aggiungi una nuova riga per ogni contatto acquisito tramite Zapier

    Slack / Avvisi email

    Ricevi notifiche in tempo reale quando arrivano contatti di alto valore

    Logica di ripetizione

    Se il tuo server non risponde con uno stato 2xx, PilotAgent riprova fino a 3 volte: dopo 1, 5 e 15 secondi.