How-toadvancedadmin
Webhook Setup Guide
Configure outbound webhooks to integrate Botonom with your stack.
3 min read4,900 viewsUpdated 2026-02-05
Creating a webhook
Go to Settings → Webhooks → Add Endpoint. Enter the URL, choose events, and click Save.
Available events:
agent.task.completed— fired when an agent finishes a taskagent.status.changed— fired on any status transitionagent.error— fired on agent errorsbilling.invoice.created— fired when a new invoice is generatedskill.installed— fired when a skill is installed on an agent
{
"endpoint": "https://hooks.yourapp.com/botonom",
"events": [
"agent.task.completed",
"agent.error"
],
"secret": "whsec_..."
}
Verifying webhook signatures
Every webhook payload includes an X-Botonom-Signature header. Verify it using your webhook secret:
const crypto = require('crypto');
function verifyWebhook(payload, signature, secret) {
const expected = crypto
.createHmac('sha256', secret)
.update(payload)
.digest('hex');
return crypto.timingSafeEqual(
Buffer.from(signature),
Buffer.from(expected)
);
}
Always verify signatures in production. Unverified webhooks can be spoofed.
webhookintegration
Was this helpful?
More questions? Contact support