Skip to main content

​
Use cases

  • Add context (dynamic variables) to inbound calls.
  • Inbound call system records.

​
Dashboard

You can set the inbound call webhook url from the SigmaMind Dashboard. Head over to the Phone Numbers section, and under Inbound Call Settings you will see the option to set the Inbound Webhook URL. Screenshot2026 02 02at1 00 42PM

​
Webhook specifications

The webhook sends a POST request to your endpoint and waits up to 10 seconds for a response. If no successful response is returned within that period, the system will retry the request up to 3 additional times. If a successfull response is not received after 3 retrials then the call will not be connected to the agent.

​
Request payload

The payload will include the following fields :
  • event: the event which triggered the webhook (“inbound_call” in this case).
  • from_number: identifies the caller so you can process the call or SMS appropriately.
  • to_number: identifies the recipient so you can process the call or SMS appropriately.
{
  "event": "inbound_call",
  "from_number": "+12345678912",
  "to_number": "+12345678913"
}

​
Response

Your endpoint should return a JSON response with a 2xx status code, containing dynamic variables organized under dynamic_variables. The following field is available:
  • dynamic_variables: use this to define dynamic variables specific to this inbound call
Here’s a sample response for inbound call: 
{
"dynamic_variables": {
        "first_name": "Jim",
		"last_name": "Smith"
    }
}

​
FAQ

The call would remain in a ringing state.
The webhook waits up to 10 seconds for a response. If no successful response is returned within that period, the system will retry the request up to 3 additional times. If a successfull response is not received after 3 retrials then the call will not be connected to the agent and it will be disconnected. During this timeperiod the call will remain in a ringing state.
Once successfull response is received the call gets connected to the agent.
Then the webhook will not be triggered and the call will get directly connected to the agent.