Skip to main content

Webhooks

Receive real-time event payloads to your server

Outgoing Webhooks
Listen for chat and lead events happening in your workspace

Configure endpoint URLs in Dashboard and receive signed HTTP POST requests whenever selected events happen in your bots.

Supported Events:

  • chat.started - A user initiates a new conversation
  • chat.message.received - A bot receives a message
  • chat.message.sent - A bot responds to a message
  • lead.captured - A bot successfully identifies and captures user contact info

How to Register:

  1. Open Dashboard → Webhooks.
  2. Create an endpoint with your destination URL and select event subscriptions.
  3. Copy the signing secret and verify request signatures in your server.
  4. Send a test event and confirm delivery logs in the dashboard.

Requests include x-kodda-signature and x-kodda-timestamp headers. Verify signatures using HMAC-SHA256 with your endpoint secret.