Webhooks Integration
The Webhooks integration pushes real-time HTTP notifications to your server when events occur in your SIPSIM account — incoming calls, completed transcriptions, new voicemails, and more.
What Are Webhooks?
Webhooks are automated HTTP POST requests sent from SIPSIM to your server whenever a specific event occurs. Instead of polling the API for changes, your application receives updates instantly.
SIPSIM sends a POST request to your webhook URL with:
- A JSON body containing event data
X-Webhook-Signatureheader for integrity verificationX-Webhook-Timestampheader with the signing timestamp
Available Events
Incoming Calls
| Event | Description |
|---|---|
incoming_call_start | Triggered when an incoming call is initiated |
incoming_call_start_chain_member_call | Triggered when a dial chain member starts ringing |
incoming_call_end_chain_member_call | Triggered when a dial chain member call ends |
incoming_call_answer | Triggered when an incoming call is answered |
incoming_call_end | Triggered when an incoming call ends |
Outgoing Calls
| Event | Description |
|---|---|
outgoing_call_start | Triggered when an outgoing call is initiated |
outgoing_call_answer | Triggered when an outgoing call is answered |
outgoing_call_end | Triggered when an outgoing call ends |
Additional Events
| Event | Description |
|---|---|
voicemail | Triggered when a voicemail is left |
tags | Triggered when tags are added or updated on a call |
speech | Triggered when speech transcription is completed |
summary | Triggered when a call summary is generated |
sms | Triggered when an SMS is received or sent |
rating | Triggered when a call quality rating is generated |
test | Manually triggered from the dashboard to verify your endpoint |
Quick Start
1. Set Up Your Webhook
Configure your webhook URL and select events from the SIPSIM dashboard. See the Setup guide for step-by-step instructions.
2. Receive Events
Your server will start receiving POST requests with JSON payloads. See Payload Format to understand the data structure.
3. Verify Signatures
Validate the X-Webhook-Signature header to ensure requests are authentic. See Signature Verification for code examples.
Next Steps
Getting Started
Set up your webhook endpoint and start receiving events.
Event Reference
Explore all available webhook events with payload details.
If you also use the API integration, you can manage webhook event subscriptions programmatically.