CDYNE Phone Notify! API StatusChangePostURL
One of the great features of CDYNE Phone Notify! API is the ability to customize call logic exactly the way your business needs it. It handles complex call scripts, responds to call actions in real time, and can be programmed to deliver relevant communications exclusive to your customers or clients. For many Phone Notify! applications, it is important to know when a call is placed, the call status has changed, the call is finished, or when a call is received. The best way to automate this process is to use the StatusChangePostURL command. With a StatusChangePostURL in place, Phone Notify! will post phone call information to a URL you designate.
What information does the StatusChangePostURL command post?
Phone Notify! utilizes a command called StatusChangePostURL, which will post back information about the phone call to your server. Once you’ve created a web page to handle postbacks, the URL can be set to recieve this information automatically. The following values are posted:
- QueueID – Contains the ID of the Call
- ResponseCode – 1 = Call Answered, 2 or more – Call Unanswered (see all status codes here)
- StartTime – Start time in Universal Time (UTC)
- EndTime – End time in Universal Time (UTC)
- Duration – Call Length in Seconds
- machinedetection – Currently only HUMAN, MACHINE, or FAX
- AC – Contains a status code – this is for advanced problem solving with Tech Support
- digitsdialed – contains all the digits dialed during a call
- incoming – contains true if the call was an incoming call
- [Any Variables you collected] – any additional variables that you collected during the call
Where do I assign the StatusChangePostURL?
There are three scenarios for assigning the StatusChangePostURL command. The first is when using the Advanced methods of Phone Notify! API. You can pass it in the NotifyPhoneAdvanced and NotifyMultiplePhoneAdvanced programming operations. Each operation contains a parameter named, “StatusChangePostURL” where the URL can be input. A URL must be in lower case.
The Basic methods of Phone Notify! do not contain the “StatusChangePostURL” parameter, so an alternative is to assign the URL in the script. In this case, you can include the URL within your script by using the ~StatusChangePostURL(posturl)~ command. This should be placed at the beginning of your script.
The last scenario includes incoming phone calls. To set the URL in this case, you can log into your account online and specify a URL for each dedicated phone number assigned to your license key as shown in the image below:
For more information about CDYNE Phone Notify! API, please contact an account representative at 1-800-984-3710, inquire by email, or initiate a chat for more details.
Or sign up for a free trial license key to test CDYNE Phone Notify! API.
Developers find CDYNE Phone Notify! API integration details on the CDYNE developer’s wiki.