Webhooks

A webhook sends an HTTP request to your endpoint when a selected event happens in Vivollo.

Supported events

• message.created — a message was sent or received
• conversation.updated — conversation status or state changed
• session.updated — visitor session information changed
• user.updated — customer information changed

Create a webhook

1. Create an HTTPS endpoint in your system.
2. Open Developer and add a webhook.
3. Enter a clear name and the endpoint URL.
4. Select the events.
5. Add a secret custom header for verification.

Your endpoint should return a successful response quickly and process longer work in the background.

Verify and monitor delivery

Check the secret header before trusting the payload. A public endpoint can receive requests from other sources.

Failed deliveries are retried. Use delivery logs to review the request time, payload, response, and errors. Make event handling idempotent so receiving the same event more than once does not repeat an unsafe action.

Use the REST API if the webhook payload does not contain all the details your system needs.

The number of webhooks depends on your plan. See Plans and limits.