Chatbot Webhook Setup Guide
Connect your chatbot to external systems with real-time events
Vatdi provides a step-by-step webhook setup process that lets you push real-time chatbot events to any HTTP endpoint. This guide walks you through endpoint configuration, event selection, signature verification, payload handling, and troubleshooting common issues.
How It Works
Register Your Endpoint
In the Vatdi dashboard, go to Settings > Webhooks > Add Endpoint. Enter your HTTPS URL and save. Vatdi generates a unique signing secret.
Select Events and Test
Check the events you want to receive. Click "Send Test Event" to verify your endpoint receives and acknowledges the payload correctly.
Implement Signature Verification
In your server code, compute HMAC-SHA256 of the raw request body using your webhook secret. Compare it to the X-Vatdi-Signature header value to authenticate each delivery.
Endpoint Configuration
Register your HTTPS endpoint URL in the Vatdi dashboard. You can configure multiple endpoints for different event types. Each endpoint receives a unique webhook secret for signature verification. Only HTTPS URLs are accepted to ensure data security in transit.
Event Selection and Filtering
Choose exactly which events trigger deliveries: conversation.started, message.created, lead.captured, handover.requested, conversation.closed, csat.submitted, and more. Filtering reduces noise and ensures your endpoint only processes relevant events.
Payload Verification and Handling
Each webhook delivery includes an X-Vatdi-Signature header containing an HMAC-SHA256 hash. Verify this server-side using your webhook secret to ensure authenticity. Parse the JSON payload, process the event, and return a 200 status code within 10 seconds to confirm receipt.
Frequently Asked Questions
Yes. Failed deliveries are retried up to 5 times with exponential backoff (1s, 5s, 30s, 2m, 15m). You can also manually replay events.
Your endpoint must return a 2xx status code within 10 seconds. Slower responses are treated as failures and retried.
Yes. Use tools like ngrok to expose your local server. Vatdi also provides a test event button that sends sample payloads.
Payloads include the event type, timestamp, chatbot ID, conversation data, visitor profile, and any collected fields relevant to the event.
Yes. Toggle any webhook endpoint off from the dashboard. Missed events during downtime can be viewed in the delivery log.
Set Up Webhooks in Minutes
Push real-time chatbot events to any service with our guided setup.