Webhooks

Send project Flow events to external HTTP endpoints.

2 min read

Webhooks send supported BotDojo events to an external HTTP endpoint. Open Advanced → Webhooks to review each webhook's source, type, method, URL, enabled state, retry limit, and timestamps.

The light-mode Webhooks page before an endpoint has been configured

Webhook settings

Setting	What it does
Name	Identifies the webhook to project administrators.
Description	Explains which external system receives the event and why.
Method	Uses `GET` or `POST` for delivery. Choose the method required by the endpoint.
Headers	Adds request headers as key-value pairs. Authorization header values are secrets and must not appear in the webhook name, description, or screenshots.
URL	Sets the complete `http` or `https` endpoint. BotDojo validates the URL and tests the webhook before saving.
Webhook Type	Selects the event. The current UI supports `postFlow`, which runs after the selected Flow.
Flow	Selects the Flow associated with a `postFlow` webhook.
Max Retry Count	Sets delivery attempts from 1 through 10. Design the receiver to handle duplicate requests safely.
Enabled	Allows delivery when on without deleting the webhook when off.

Select a webhook name to edit it. Select one or more rows and Archive Webhook to remove them from active use.

Use HTTPS, authenticate the receiver, keep authorization values in secret headers, and verify the receiving endpoint before enabling a production webhook. Archive or disable delivery before retiring the endpoint.