Webhooks

Wat zijn webhooks?

Webhooks stellen je in staat om real-time updates te ontvangen over leads en gesprekken in je chatbot. Deze updates worden automatisch naar een door jou gespecificeerd endpoint gestuurd.

Configuratie

Basis instellingen

• Webhooks inschakelen: Zet webhooks aan of uit
• Webhook URL: Het endpoint waar de webhooks naartoe worden gestuurd
• Lead Types:
  • Ontvang webhooks voor alle leads
  • Ontvang alleen webhooks voor bevestigde leads

Webhook formaat

Webhooks worden verzonden als JSON met de volgende structuur:

{
    "event": "potential_lead", // of "confirmed_lead"
    "conversation_id": "12345", // unieke ID van het gesprek
    "conversation": [
        {
            "time": "2024-01-20T14:30:00Z",
            "question": "Willen jullie mij mailen op naam@bedrijf.nl",
            "answer": "Zeker, we zullen zo snel mogelijk contact met je opnemen!"
        }
    ],
    "lead_contact_info": "naam@bedrijf.nl"
}

Event types

• potential_lead: Wanneer de AI mogelijk contactgegevens detecteert in een gesprek
• confirmed_lead: Wanneer een bezoeker het leadformulier heeft ingevuld

Implementatie tips

• Endpoint beveiliging

  • Zorg dat je endpoint HTTPS gebruikt
  • Implementeer authenticatie waar nodig
  • Verwerk de webhook asynchroon

• Error handling

  • Zorg voor proper error handling
  • Implementeer retry logic
  • Log alle ontvangen webhooks

• Testing

  • Test je endpoint met verschillende scenario's
  • Verifieer de verwerking van beide event types
  • Controleer je logging en monitoring

Maatwerk

Wil je het webhookformaat aanpassen aan jouw specifieke behoeften? Bijvoorbeeld:

• Extra velden toevoegen
• Andere event types
• Aangepaste payload structuur

Neem dan contact op met ons support team. We kunnen het webhookformaat aanpassen aan jouw specifieke use case.