Digium Switchvox (Event Notifications). SMDR/CDR data format and connection settings


This data is being extracted with help of the "Advanced PBX Data Logger" software only. It may not applicable for other software titles.

Overview

The Event Notifications are set up in the Switchvox Admin Tool Suite: https://your_switchvox/admin

Log into the Admin Suite and use the URL Manager page (System Setup > URL Manager).

For more information about using the Admin Suite and the URL Manager, see the Switchvox Administrator Manual.

You can set up Switchvox to notify your Web-based applications when a particular event occurs in Switchvox. Switchvox can submit information about the event, and then accept return XML that includes instructions to set a Caller ID for that call, transfer the call to an extension, and/or set a display URL for use in the Switchboard.

URLs

For each event that you want a notification, you can set up a URL to your application. Those URLs can include variables that will resolve to event-specific data. When the event happens, Switchvox builds the URL with the event's data, then posts a request to the newly formed URL.

Also, you can set up a Default URL so that you do not have to enter a full URL for every event. Then for each event, you can choose to use that Default URL, or a different URL.

For detailed description visit Digium's Wiki

URL format

Our parser is designed for the following default URL:

http://192.168.0.100/route.cgi?date=%VM_DATE%&event=%EVENT_TYPE%&ext=%EXTENSION%&cid_number=%CALLER_ID_NUMBER%&cid_name=%CALLER_ID_NAME%&did=%INCOMING_DID%&duration=%VM_DUR%&data=%FEATURE_DATA%&vm_msgnum=%VM_MSGNUM%&dialed=%DIALED_NUMBER%&endofdata

You need to verify your PBX settings before using our software as a data collection server. 192.168.0.100 - should be replaced with the IP address of a computer where our software is installed.

Configuring Advanced PBX Data Logger as a TCP server

Advanced PBX Data Logger should be configured to the TCP server mode and listen on 0.0.0.0:80 (see below). The IP address 0.0.0.0 allows receiving data from all network connections on your computer. The port number should match the value from the SMDR settings in your Switchvox.

1. Add a new configuration with the TCP data source (if you didn't it before).

TCP/IP Data Interface

2. Configure the TCP settings as shown below.

TCP Server Mode for Switchvox

80

80

Selecting the correct parser for Digium Switchvox (Event Notifications)

Parser Selection For (none)

Digium Switchvox (Event Notifications)

Digium Switchvox (Event Notifications)

Data items

DescriptionData typeColumn name
Call timedatetimeCALL_TIME
Call typestringCALL_TYPE
ExtensionstringEXT
Caller numberstringCALLER_PHONE
Caller namestringFLAG1
DNISstringFLAG2
Call duration (s)integerCALL_DURATION_S
Call durationdatetimeCALL_DURATION
Call datastringFLAG3
Voice message numberstringFLAG4
Dialed numberstringDIALED_PHONE
DirectionstringDIRECTION

Interested in reports for PBX usage?

We offer the PBX Reports utility with various manual, scheduled and email reports, built-in web-server, and other features. Look here

Want PBX call logs in a database?

This is the standard feature. The logger captures exports SMDR or CDR data in real-time to your database. Follow this link

Note: Products and companies mentioned here are used only for definition and identification purposes and can be trademarks and/or registered trademarks of the respective companies.