AI Bridge webhooks
Get notified about calls handled by your AI Bridge, and (for supported AI providers) receive a summary of what the caller said.
Where to set it up
- Go to Premium Features > AI Bridge and open the AI Bridge you want to edit.
- Open the Settings tab and scroll to Webhooks & alerts.
- Enter your address in Webhook URL.
- Optional: enter a Webhook secret.
- Save your settings.
Expand Show webhook payload example and Show conversation payload example on the same tab to see example messages.
Important: this webhook is Crazytel sending call events to you. It is not the same as the "accept" webhook your AI provider (such as OpenAI) may ask you to host. That one is set up with your AI provider.
For creating the bridge and routing a number, see AI Bridge setup guide.
Events you will receive
| Event | When it is sent |
|---|---|
ai_bridge.started | A call arrived at the AI Bridge. |
ai_bridge.bridged | The caller was connected to the AI. |
ai_bridge.completed | The call finished normally. |
ai_bridge.failed | The call could not be connected to the AI, or failed part-way through. |
ai_bridge.rejected | The call was rejected before reaching the AI. The reason is included in the message. |
aibridge.conversation | A summary of what the caller told the AI, such as their name, company and reason for calling. Available for Gemini Live bridges. |
SIP-based AI Bridges send call lifecycle events only (no conversation summary).
The conversation summary is handy for posting a quick note to a chat tool or bot (for example Telegram) so your team knows who called and why.
Example messages
Call completed
{
"event": "ai_bridge.completed",
"account_code": "295327",
"ai_bridge_uuid": "550e8400-e29b-41d4-a716-446655440000",
"call_uuid": "550e8400-e29b-41d4-a716-446655440030",
"status": "ended",
"caller_id": "61400111222",
"original_did": "61298786988",
"created_at": "2026-06-07T00:03:00Z"
}Conversation summary
{
"event": "aibridge.conversation",
"account_code": "295327",
"aibridge_uuid": "550e8400-e29b-41d4-a716-446655440000",
"call_uuid": "550e8400-e29b-41d4-a716-446655440010",
"status": "bridged",
"created_at": "2026-09-11T00:00:20Z",
"caller_id": "61400111222",
"original_did": "61290001111",
"conversation": {
"caller_name": "Alex",
"company": "Northwind",
"reason": "Callback about an invoice"
},
"data": {
"source": "tool",
"provider": "gemini_live"
}
}Security
If you set a secret, each request includes:
X-Crazytel-Signature-256: sha256=<signature>
User-Agent: Crazytel-AIBridge-Webhook/1.0