LinuxBox PBX API: PBX Notifications

Built: 2024-03-28 14:06:07

Event StartCall

Start call (usually for incoming call, the call has came from provider to PBX and starts to route).

Attributes:

caller_type - caller type (internal, originate, external)

caller_num - caller number

caller_userid - caller agent user ID

dialed_num - dialed number

target_num - target number (same as dialed number, deprecated)

call_id - unique call ID

cel_id - unique event ID

caller_userid - agent ID (only for caller_type internal)

http://server/start_call?caller_type=internal&caller_num=591166223&caller_userid=linuxbox&dialed_num=591166200&target_num=591166200&call_id=1541078811.98&cel_id=28254912

Event QueueIn

Call has entered the queue.

Attributes:

caller_num - caller number

dialed_num - dialed number

queue_name - name of the queue

call_id - unique call ID

cel_id - unique event ID

custom_call_id - custom call identifier

http://server/queue_in?caller_num=591166223&dialed_num=591166200&queue_name=helpdesk&call_id=1541078811.98&cel_id=28254912&custom_call_id=Wua4kaib

Event QueueOut

Call has left the queue.

Attributes:

queue_name - name of the queue

call_id - unique call ID

cel_id - unique event ID

custom_call_id - custom call identifier

http://server/queue_out?queue_name=helpdesk&call_id=1541078811.98&cel_id=28254912&custom_call_id=Wua4kaib

Event StartIntDial

Start of the call ringtone on internal line.

Attributes:

caller_num - caller number

dialed_num - dialed number (only for caller_type external, dialer)

line_num - number of dialed line

line_name - name of dialed line

line_userid - dialed agent user ID

custom_call_id - custom call identifier

call_id - unique call ID

cel_id - unique event ID

caller_type - caller type (external, originate, dialer)

queue_name - queue name (only for caller_type external)

http://server/start_int_dial?caller_num=591166223&dialed_num=591166200&line_num=101&line_name=martin&line_userid=linuxbox&custom_call_id=Wua4kaib&call_id=1541078811.98&cel_id=28254912&queue_name=helpdesk&caller_type=external&queue_name=helpdesk

Event StartExtDial

Start of the call ringtone on external line.

Attributes:

caller_num - caller number

dialed_num - dialed number

line_num - number of calling line

line_name - name of calling line

line_userid - user ID of calling agent

custom_call_id - custom call identifier

call_id - unique call ID

cel_id - unique event ID

http://server/start_ext_dial?caller_num=591166223&dialed_num=591166200&line_num=101&line_name=martin&line_userid=linuxbox&custom_call_id=Wua4kaib&call_id=1541078811.98&cel_id=28254912

Event AnsweredInternalCall

The call has been picked up by internal line.

Attributes:

caller_num - caller number

dialed_num - dialed number

line_num - number of answering line

line_name - name of answering line

line_userid - user ID of answering agent

custom_call_id - custom call identifier

call_id - unique call ID

cel_id - unique event ID

caller_type - caller type (external, originate, dialer, internal)

http://server/answered_internal?caller_num=591166223&dialed_num=591166200&line_num=101&line_name=martin&line_userid=linuxbox&custom_call_id=Wua4kaib&call_id=1541078811.98&cel_id=28254912&caller_type=external

Event AnsweredExternalCall

The call has been picked up by remote side.

Attributes:

caller_num - caller number

dialed_num - dialed number

line_num - number of calling line

line_userid - user ID of answering agent

custom_call_id - custom call identifier

call_id - unique call ID

cel_id - unique event ID

http://server/answered_external?caller_num=591166223&dialed_num=591166200&line_num=101&line_name=martin&line_userid=linuxbox&custom_call_id=Wua4kaib&call_id=1541078811.98&cel_id=28254912

Event Hangup

Hang-up of the call.

Attributes:

line_num - number of hanged line

line_userid - user ID of agent on hanged line

custom_call_id - custom call identifier

call_id - unique call ID

cel_id - unique event ID

http://server/hangup_internal?line_num=101&line_userid=linuxbox&custom_call_id=Wua4kaib&call_id=1541078811.98&cel_id=28254912

Event CallEnd

End of the call.

Attributes:

call_id - unique call ID

cel_id - unique event ID

custom_call_id - custom call identifier

http://server/call_end?call_id=1541078811.98&cel_id=28254912&custom_call_id=Wua4kaib

Event AgentLogin

Agent has been logged in.

Attributes:

userid - agent user ID

exten - agent extension

http://server/pbx_agent_login?userid=linuxbox&exten=121

Event AgentLogout

Agent has been logged out.

Attributes:

userid - agent user ID

reason - logout reason

http://server/pbx_agent_logout?userid=linuxbox&reason=pause

Event AgentSetState

Agent has changed his state.

Attributes:

userid - agent user ID

state_name - name of changed state

http://server/pbx_agent_set_state?userid=linuxbox&state_name=pause

Event CallSpyStart

Call wiretapping started.

Attributes:

call_id - unique call ID

spying_exten - number initiated the wiretapping

spying_target_exten - wiretapped number

spying_userid - agent user ID initiated the wiretapping

spying_target_userid - wiretapped agent user ID

spy_type - spy type (spy, bargein, whisper)

http://server/call_spy_start?call_id=1541078811.98&spying_exten=101&spying_target_exten=102&spying_userid=linuxbox&spying_target_userid=sales_agent1&spy_type=spy

Event CallSpyEnd

End of call wiretapping.

Attributes:

call_id - unique call ID

spying_exten - number initiated the wiretapping

spying_target_exten - wiretapped number

spying_userid - agent user ID initiated the wiretapping

spying_target_userid - wiretapped agent user ID

spy_type - spy type (spy, bargein, whisper)

http://server/call_spy_end?call_id=1541078811.98&spying_exten=101&spying_target_exten=102&spying_userid=linuxbox&spying_target_userid=sales_agent1&spy_type=spy

Event ExtenPausedUnaswered

Exten paused due unaswered call in queue

Attributes:

call_id - unique call ID

exten - called number

reason - unanswered queue call (unanswered_queue_call)

http://server/exten_paused?call_id=1541078811.98&exten=101&reason=unanswered_queue_call