Webhook Setup
Webhooks let BotForge send real-time notifications to your own systems when events happen in conversations.
What Are Webhooks?
Think of webhooks as automated messages BotForge sends to your server when something happens — like a new lead, a conversation ending, or a customer asking to speak with a human.
Setting Up Webhooks
- Go to Dashboard → Settings → Webhooks
- Click "Add Webhook URL"
- Enter your endpoint URL (must be HTTPS)
- Choose which events to receive
- Save
Events You Can Subscribe To
- conversation.started — A visitor starts a chat
- conversation.ended — A chat session ends
- lead.captured — A visitor provides their email
- human.requested — Someone wants to talk to a human
- checkout.completed — A customer purchases a plan
Webhook Payload Example
{
"event": "lead.captured",
"timestamp": "2026-03-24T12:00:00Z",
"data": {
"email": "customer@example.com",
"bot_id": "abc123",
"conversation_id": "conv_xyz"
}
}
💡 Testing Webhooks
Use a service like webhook.site to get a temporary URL for testing before connecting your real system.
⚠️ Security
Always verify webhook signatures to confirm requests come from BotForge. Each webhook includes a signature header you should validate.
Troubleshooting
Not receiving webhooks? Check that your endpoint is publicly accessible and returns a 200 status code.
Getting wrong data? Verify you're parsing the JSON payload correctly on your end.