Documentation for Developer/Administrators
HomeAccount PortalPricing
Search…
About this Documentation
Overview
Table of Content
Introduction
Welcome Kit
DIDforSale Portal
Register a new account
Dashboard
Reporting
Phone Numbers
Interconnection
Tools/Settings
Account
SIP Trunking
Configuration of Phone Numbers
SIP Trunking
DIDForSale Softphone
Grandstream Wave Application Configuration
Voice and SMS APIs
Getting the API key and Token
Voice
Big Picture
Quick Start
didML Reference Doc
Voice API Request Params
Voice API Response
didML Verbs
SMS
UC Editor
UC Editor
FAX via Email
Send & Receive FAX via Email
Powered By GitBook
Voice API Response
Our system expect a response from your application in didML formate.

DIDforSale Collects Response

In the previous Step you saw how DIDforSale makes HTTP request to your URL as soon as your phone number is called. Now as a result the server is trying to access the <didML> file which stores all the instructions that have been programmed by you. In other words system is figuring out what the next step is? Whether to greet the caller by name, or play music on hold or connect the call etc. Whatever is being stated in the file is the Response from your URL to the Request that was sent by DIDforSale.
Response collected from the application
<didML> collects the response from the URL and DIDforSale executes the instructions. Within the code any instruction that is passed within the <response> parameter is what <didML> looks for. With the use of various Verbs, you can create a complex dial plan to meet your unique needs.

Here is an example

If someone calls your number, DIDforSale will look up for the URL specified for that number and make a request. Web server will then send the instructions on what to do with that call. Say you want to play a Company Greeting, or Forward the call to a cell phone etc.
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Say>Please hold while we connect your call.</Say>
<Dial>19499300366<dial/>
<hangup/>
</Response>
As soon as DIDforSale gets access to <didML> document, phone system will convert the text to audio and play the messages to the caller. Once the message is played it will forward the call to another number as specified in the instructions. Please Note: Only one document can be served at one time, but you can link other documents based on input from the user. This way you can build a complex voice application. Like if Press 1 to do this, or Press 2 to do that else hangup.
Learn more about all the verbs you can use in the application.
​
Previous
Voice API Request Params
Next
didML Verbs
Last modified 3yr ago
Copy link
Outline
DIDforSale Collects Response
Here is an example