Managing your Incoming Calls

In this section, you will be acquainted with receiving Incoming calls on a particular caller ID, creating an Incoming Voice Application is necessary.

📘

Refer to Getting Started with Unifonic

📘

Alternatively, you may use Flow Management to easily create an IVR Flow on a Caller ID.

To start receiving inbound calls on a particular caller ID

1. Plan out your IVR Flow and how you want it to look.

2. Create a GET API that will return an IVR instruction on call handling.
   We will handle each call exactly how you define it in your API response.

{
  "play":"kasjdjkln-34jnjdkfvs83-osmfklsd",
  "responseUrl":"https://gatherresponses.com/1",
  "speechCollectionLanguage":"english",
  "loop": 3
}

📘

In this code sample, we will play an audio file, which is characterized by the audio ID, and collect a response, which will be sent to you by calling the responseUrl. This URL will be called with POST method with no Authorization required. If the parameter speechCollectionLanguage is present, then it represents that you would like to collect a response via user speech. If this parameter is not present, then the response collection activity will be done by DTMF.

3. POST/responseUrl: not every field in this code sample will be present. If your response collection activity is speech, there will be a confidence level and speechResult sent to the responseUrl. Otherwise, it will just be digits. Recipients and callerId will always be sent so that you are able to map a user response to a user.

{
“confidence”:0.6, //refers to accuracy of this speech recognition activity
“speechResult”:”one”,
“digits”: “1”,
“recipient”: “+966XXXXXXXXX”,
“callerId”: “+966XXXXXXXXX”
}

4. Provide us with a response to this POST request: a response is required as it tells us what is the next IVR instruction after you have analyzed the IVR response. It can be a simple thank you, which will then result in a call completion. Or, you can conduct another response collection activity by simply providing another responseUrl.

{
  "say":"thank you",
  "language":"english",
  "voice":"male"
}

5. Host the APIs on your API Server and expose them to your inbound voice application on the Unifonic Console.

Alternatively, you can skip all of these and simply make use of the Flow Studio.