Webhook events
Webhooks push events to your own endpoint the moment they happen, so you can act in real time without polling. Ovellan sends three, and each is a plain JSON POST.
The three events
- lead, a visitor submitted their details through the bot.
- handover, a visitor asked to talk to a person.
- conversation, a chat ended (this one fires a few minutes after it goes quiet).
What the payload looks like
Every event is Content-Type: application/json and carries an event_type plus the fields for that event. A captured lead, for example, arrives like this:
Two ways to subscribe
The simple way: paste one endpoint URL on your bot's Zapier & webhooks page and it receives all three events. The programmatic way: subscribe per event with the Zapier endpoints, authenticating with your sync key. Either way, we POST the instant an event fires.
Payloads are not signed, there is no signature header to verify against. So treat the endpoint URL itself as a secret: serve it over HTTPS and do not expose it anywhere public.