IVR · Developer Tools
Connect Every Call to Your Own Systems — Automatically
CloudShope's API Webhooks let you call your own custom endpoints before, during, and after any call — no manual work, no polling, no missed events. Sync your CRM, send instant SMS/WhatsApp alerts, or log every call the moment it happens.
- Incoming Call
- Pre API
- Call Connects
- Call Connected API
- Call Ends
- Post API
- Your Server
Real-time triggers — fired the instant each call event happens, not on a delay
Any endpoint, any stack — plain HTTP GET/POST/PUT/DELETE to any URL you own
14+ dynamic placeholders — caller number, agent, duration, recording link, and more, injected automatically
Custom headers supported — pass your own auth tokens or API keys with every request
How it works
Three moments in every call, each one able to reach your systems.
Step 1
Pre API Webhook
Triggered right before an incoming call starts.
Fire off logic the moment a call begins ringing — before it's even answered. Perfect for pulling up caller context, logging the attempt, or pre-warming your CRM record.
Step 2
Call Connected API Webhook
Triggered immediately when the call connects successfully.
Know the exact second an agent and a customer are actually talking. Use it to start a timer, notify a supervisor dashboard, or kick off a live-call widget.
Step 3
Post API Webhook
Triggered after the call is completed or terminated.
Get the full picture once the call ends — final status, total duration, agent duration, and a link to the recording — so you can close the loop in your own system automatically.
Pre API Webhook
Runs before the call is answered. Use it to look up the caller in your CRM, log the incoming attempt, or route custom logic before the agent even picks up.
Call Connected API Webhook
Fires the instant the call is answered and connected. Ideal for starting call timers, pushing a “live call” notification, or triggering screen-pop tools for your agents.
Post API Webhook
Fires once the call ends, with the full call outcome — status, duration, recording link, and more. Use it to update your CRM, send a follow-up SMS/WhatsApp, or log analytics.
Built for developers, simple for everyone
Any HTTP method — GET, POST, PUT, or DELETE, your choice per webhook
Custom query parameters — build your own URL with any parameter names you like
Dynamic placeholders — auto-filled with real call data on every request (full list below)
Custom headers — attach your own auth headers (API keys, bearer tokens) to every outgoing request
Independent toggles — turn Pre / Call Connected / Post webhooks on or off individually per number
Test button — verify your endpoint responds correctly before going live
Dynamic placeholders
Build your webhook URL with any parameter names you want — just drop in these placeholders anywhere in the query string and CloudShope fills them in automatically with real call data.
| Placeholder | Represents |
|---|---|
%from% | Caller's number |
%to% | Number the call was made to |
%time% | Time of the call |
%unix% | Call time as a Unix timestamp |
%uniqueid% | Unique ID for the call |
%agent_name% | Name of the agent on the call |
%agent_number% | Agent's extension/number |
%status% | Final call status (e.g. answered, missed) |
%total_duration% | Total call duration |
%agent_duration% | Duration the agent was on the call |
%operator% | Caller's telecom operator |
%circle% | Caller's telecom circle/region |
%extension% | IVR extension the call reached |
%recording% | Link to the call recording |
Only the placeholder tokens above are replaced automatically — you can add any additional custom parameters to your URL, and they'll be passed through as-is.
Example Webhook URL
http://yourapp.com/call-handler.php? from=%from%&to=%to%&time=%time%&unix=%unix% &uniqueid=%uniqueid%&agent_name=%agent_name%&agent_number=%agent_number% &status=%status%&total_duration=%total_duration%&agent_duration=%agent_duration% &operator=%operator%&circle=%circle%&extension=%extension%&recording=%recording%CloudShope replaces every placeholder with real values and calls this URL automatically — no polling, no delays.
What people wire it into
CRM Auto-Sync
Push every call outcome straight into your CRM the moment a call ends.
Instant SMS/WhatsApp Alerts
Notify a customer or manager automatically after a call.
Call Logging & Analytics
Feed your own BI/analytics tool in real time, no exports needed.
Custom Call Routing Logic
Trigger internal systems the second a call starts ringing.
Questions
What HTTP methods are supported for webhooks?
GET, POST, PUT, and DELETE — pick whichever your endpoint expects, independently for each of the three webhooks.
Can I send custom headers, like an API key?
Yes. Each webhook supports custom request headers, so you can pass authentication tokens or any other headers your endpoint requires.
Do I have to enable all three webhooks?
No — Pre, Call Connected, and Post webhooks are toggled independently, so you can enable only the ones you need.
Will my own custom URL parameters be preserved?
Yes. You can add any parameter names you like to the URL — only the recognized placeholders (like %from% or %time%) get replaced; everything else passes through unchanged.
Can I test a webhook before going live?
Yes, each webhook has a built-in test action so you can confirm your endpoint responds correctly before enabling it for real calls.
Wire your calls into any system you already use.
Set it up once — every call fires your webhooks automatically, forever.