Developers
Real-time webhooks
Get notified the instant something happens in your workspace. BotForge POSTs signed JSON to your endpoint and retries on failure.
Events
Add an endpoint under Developers → Webhooks and subscribe to any of these events.
order.createdorder.paidorder.cancelledcustomer.joinedticket.createdticket.repliedticket.closedbroadcast.sentreferral.created
Payload & signature
Each delivery is a JSON POST signed with HMAC-SHA256 over the raw body, using your endpoint's secret, in the X-BotForge-Signature header.
// verify in your handler
const expected = "sha256=" +
crypto.createHmac("sha256", endpointSecret)
.update(rawRequestBody)
.digest("hex");
// timing-safe compare to the X-BotForge-Signature headerRetries
Non-2xx responses are retried up to 6 times with backoff. After the final failure, the endpoint owner is notified in-app.
| Attempt | Delay |
|---|---|
| 1 | Immediate |
| 2 | 10 seconds |
| 3 | 60 seconds |
| 4 | 5 minutes |
| 5 | 30 minutes |
| 6 | 1 hour |