Custom Webhook Endpoint

Configure a custom webhook endpoint to receive Conversation API events, allowing your own third-party integration to generate automated responses to messages received in the Easy Dialog app.

Each inbound event is POSTed to your webhook URL as a JSON payload containing the serviceUuid, dialogUuid, source channel, the inbound message (text, picture, audio, video, file, location, contact, etc.), and the sender's contact data. Requests are signed with the configured signature key using HMAC-SHA512, base64-encoded and sent in the X-BM-Signature header, so your endpoint can verify authenticity before processing.

Your endpoint is expected to respond with a messages array describing one or more outbound messages to send back to the user; an empty array means no reply. When Debug mode is enabled on the Conversation account, a rejected response triggers a follow-up request containing only error details, which is useful for troubleshooting malformed webhook responses.