Webhook-events
Webhooks pushen events naar je eigen endpoint zodra ze gebeuren, zodat je in real time kunt reageren zonder te pollen. Ovellan stuurt er drie, elk een simpele JSON-POST.
De drie events
- lead, een bezoeker heeft zijn gegevens via de bot achtergelaten.
- handover, een bezoeker vroeg om een persoon te spreken.
- conversation, een chat is afgelopen (deze vuurt een paar minuten nadat het stil wordt).
Hoe de payload eruitziet
Elk event heeft Content-Type: application/json en bevat een event_type plus de velden voor dat event. Zo ziet een vastgelegde lead er bijvoorbeeld uit:
Twee manieren om je te abonneren
De simpele manier: plak één endpoint-URL op de Zapier & webhooks-pagina van je bot en die ontvangt alle drie de events. De programmatische manier: abonneer je per event met de Zapier-endpoints en authenticeer met je sync key. Hoe dan ook, we POSTen zodra een event vuurt.
Payloads zijn niet gesigneerd, er is geen signature-header om tegen te verifiëren. Behandel de endpoint-URL dus zelf als een geheim: serveer hem over HTTPS en maak hem nergens publiek toegankelijk.