| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Event Triggers
...
Event Triggers let you set up Switchvox to interact with external web-based applications. When certain events occur in Switchvox, it can do an HTTP POST that includes information about the event, and then respond to XML that is returned. Click Save Event Triggers when finished.
System Default URL
You can enter a Default URL so that you do not have to enter a full URL for each event. But, you can choose to use the default URL or not, so you still have flexibility on each event.
Event Specific URLs
There are some Switchvox events that trigger an HTTP POST. You can choose to Append URL variables and to use the Default URL (YES/NO).
...
On Agent Logged In Event URL. Triggered when a queue member logs into a queue.
On Agent Logged Out Event URL. Triggered when a queue member logs out of a queue.
On Call Hangup Event URL. Triggered when a call is hung up. This event can be used in conjunction with the JOB_ID variable to record the completion of calls that invoked previous URL events. Note: Setting XML values in the response to this request results in undefined behavior. Return empty XML for this request.
On Outgoing Call Event URL. Triggered when a call is created. This event applies to calls to external numbers and all Switchvox extensions.
URL Variables
Switchvox events can submit various information about calls. To do this, you use variables in the URL. Not every variable is available in every event (check the Acceptable Variables dropdown on each event), so be prepared to handle an empty variable. Here is the complete list of all of the variables for all event types:
...
JOB_ID. Unique ID of the call. Note: This string of digits is not a numerical value: 99.100 is not equal to 99.1. This variable is useful for correlating multiple events (and also certain IVR requests).
XML Response
For some events, the remote web application can return XML that instructs Switchvox to perform operations on the call. Here is a sample of an XML response:
...