InboundtoPBX

Sent when a call from outside reaches the PBX, that is at the very beginning of the call flow. At this point the call has not been routed to a queue or an extension yet.

Use it to learn that an inbound call exists: this is where you can start actions such as looking up a record in your CRM by the caller number, opening a screen or creating a call log entry.

Sample body

scenario: InboundtoPBX

{
  "pbx_num": "8501234567",
  "unique_id": "sip1-1767225600.10001",
  "incoming_number": "8501234567",
  "scenario": "InboundtoPBX",
  "customer_num": "05551112233",
  "timestamp": "1767225600000"
}

Send this body to your own address

The sample body above is sent to the address below as a POST request. The request goes from your browser, so the response cannot be read if the receiving endpoint sends no CORS header; the request itself still arrives. Use the cURL equivalent to try it from the server side.

cURL equivalent:

curl -X POST 'https://your-address.example/webhook' \
  -H 'Content-Type: application/json' \
  -d '{"pbx_num":"8501234567","unique_id":"sip1-1767225600.10001","incoming_number":"8501234567","scenario":"InboundtoPBX","customer_num":"05551112233","timestamp":"1767225600000"}'

Fields

Field	Type	Description
scenario	string	Always InboundtoPBX.
pbx_num	string	Your PBX number the call reached.
unique_id	string	Unique identifier of the call. It stays the same in every later event of this call.
incoming_number	string	Your number that was dialed.
customer_num	string	Calling subscriber number.
timestamp	string	Event time (ms, Unix epoch).

No extension information yet

Because the call has not reached an extension at this stage, the internal_num field is not sent. To find out which extension takes the call, wait for the Inbound_call event.