incoming_call_start

Triggered when a new incoming call is initiated on your SIPSIM phone number. This is the first event in the incoming call lifecycle — the phone has started ringing but has not yet been answered.

When This Event Fires

• A caller dials one of your SIPSIM phone numbers
• The PBX begins routing the call to the configured dial chain

Payload

Field	Type	Description
event	string	Always "incoming_call_start"
caller	string	Caller phone number (e.g. "+33612345678")
receiver	string	Called SIPSIM phone number (e.g. "+33198765432")
time	string	Timestamp of the event
pbx_id	string	Unique call identifier in the PBX

Example Payload

{
  "event": "incoming_call_start",
  "caller": "+33612345678",
  "receiver": "+33198765432",
  "time": "2025-01-15T10:30:00Z",
  "pbx_id": "call_abc123"
}

Call Lifecycle

This is typically the first event you receive for an incoming call. The full sequence is:

1. incoming_call_start — call initiated
2. incoming_call_start_chain_member_call — each chain member starts ringing
3. incoming_call_answer — call answered
4. incoming_call_end — call completed

Related Events

• incoming_call_answer — when the call is answered
• incoming_call_end — when the call ends
• outgoing_call_start — equivalent event for outgoing calls