Introduction
Delacon’s “Live Call Data Push” API enables integrating partners to manage the call tracking data produced by the Delacon system to be stored in their own integrated CRM. This approach is most suitable when there is a need for interpreting call tracking data in the CRM system leading to further analysis and reporting.
Setup and configuration
The following steps will be required:
- you would need to develop a system to accept the data that Delacon sends (as defined further below under API specifications). Please review publicly available guides on how to set up a webhook.
- The system will need a public URL to accept the data eg. https://www.*yourdomain*.com/services/calldata/create
- Map the webhook URL against each service in the Delacon portal
- After the mapping has been completed, all calls will be sent to your defined end point URL. Note the format will be in JSON.
API Specification
Overview:
- Once a call is initiated in the Delacon system, the Delacon system will ‘POST’ following JSON data to a URL provided by you:
{
"PLA_Call_Id":"1122334",
"PLA_Caller_Phone_Number":"+61444444444",
"PLA_Exchange":"abc",
"PLA_City":"abc",
"PLA_State":"abc",
"PLA_Number_Dialed":"0288889999",
"PLA_Dealer_ID":"abc",
"PLA_Dealer_Name":"abc",
"PLA_Dealer_Category":"abc",
"PLA_Search_Engine_Used":"abc",
"PLA_Search_Type":"abc",
"PLA_Keywords_Searched":"abc",
"PLA_URL":"abc",
"PLA_CID":"123",
"PLA_SESSID":"Cuei212417iiyskskiidfsikks",
"PLA_UAID":"123456.4567",
"PLA_CallStartTime":"00000001556755937003",
"PLA_Landing_Page":"https://www.delaconconcorp.com.au?gclid=C152ddsa12213123132",
"PLA_Page_Called_From":"https://www.delaconcorp.com/contact_us"
}
- Once a call ends in the Delacon system, the Delacon system will ‘POST’ following JSON data to a URL provided by you:
{
"PLA_Call_Id":"1122334",
"PLA_CID":"123",
"PLA_Answering_Point":"029898989",
"PLA_CallResult":"Answered",
"PLA_Duration":"50s",
"PLA_VoicemailLeft":"Yes",
"PLA_SurveyOutcome":"Sale",
"PLA_SurveySaleAmount":"abc",
"PLA_Converted":"Y",
"PLA_dtmf":"1234",
"PLA_RecordingFile":" https://vxml5.delacon.com.au......abc.wav",
}
- This URL needs to return the response in the following format:-
{
"PLA_Call_Id":"1122334",
"success":"true [OR] false",
"error":"[if error]"
}
Note: The link shared by the webhook is used to play the recording from the URL bar of the browser. If you would like to play the audio recording in the HTML5 audio player, you can achieve the desired output by patching a parameter "&mode=direct" to the link shared via webhook.
Please Note
CRM/endpoint configuration is not within Delacon's scope, and a $500 charges will apply for any technical support/troubleshooting required.
If you do need our support and agree to the $500 charge, please fill in the below order form and return to Delacon at orders@delaconcorp.com.
Order form:
I ______________________________have the authority on behalf of ____________________ and accept to pay the charges of $500 to help me with the setup of LiveCallDataPush_API.
Signed:
_______________
Date:
_______________
Please contact your account manager if you require more information.
Data fields
| PLA_Call_Id | |
| PLA_Caller_Phone_Number | |
| PLA_Exchange | |
| PLA_City | |
| PLA_State | |
| PLA_Number_Dialed | |
| PLA_Dealer_ID | |
| PLA_Dealer_Name | |
| PLA_Dealer_Category | |
| PLA_Search_Engine_Used | |
| PLA_Search_Type | |
| PLA_Keywords_Searched | |
| PLA_URL | |
| PLA_CID | |
| PLA_SESSID | |
| PLA_UAID | |
| PLA_CallStartTime | |
| PLA_Landing_Page | |
| PLA_Page_Called_From | |
| PLA_ExtraTracking | |
| PLA_CallResult | |
| PLA_Duration | |
| PLA_VoicemailLeft | |
| PLA_SurveyOutcome | |
| PLA_SurveySaleAmount | |
| PLA_Converted | |
| PLA_dtmf | |
| PLA_RecordingFile |
Map the webhook URL against each service in the Delacon portal
1. Log into the Delacon portal
2. Navigate to Services > List Services
3. Click on Edit for the service for which you want to enable the webhook.
4. Under Data Integration, set the toggle to Push live data through to the webhooks provided and add the create and update URLs.
Related Articles
Comments
0 comments
Please sign in to leave a comment.