Inbound IVR setup

Let us show you how to set up an Inbound IVR.

Inbound IVR will allow your customers to dial your dedicated voice number (DID) and get into the IVR flow. You can use an inbound IVR to set up surveys, polls, or to automate your customer support processes.

Prerequisites

In order to use the Inbound IVR service you must purchase a number (DID number). Once you have your number you create a scenario, get a ScenarioID, and use it to set up an Inbound IVR action on the number. Once you complete these steps you are ready to advertise this number to your customers.

Use our Numbers API or Customer portal to purchase Voice enabled phone number.

To setup Inbound IVR use this method: Setup Inbound IVR action

Additional methods:

Setup Inbound IVR

This method allows you to set up an Inbound IVR action for a DID number.

POST https://api.infobip.com/

Request parameters:

Property name Type Description
scenarioID string Type of number setup (VOICE_IVR).

Request example

POST /numbers/1/numbers/6FED0BC540BFADD9B05ED7D89AAC22FA/action HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
Accept: application/json

{
 "type" : "VOICE_IVR",
 "scenarioId" : "scenarioId"
}	
  

Response:

{
  "actionKey": "6FED0BC540BFADD9BD89AAC22FA",
  "type": "VOICE_IVR",
  "scenarioId": "scenarioId"
 }	
  

A successful response is represented by an HTTP status code 200 OK.

Get action

The method will return the action that was set up on a specific number (numberKey).

GET https://api.infobip.com/numbers/1/numbers/{numberKey}/actions

Request example

GET /numbers/1/numbers/6FED0BC540BFADD9B05ED7D89AAC22FA/actions HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Accept: application/json	
  

Response

{
  "actions": [
    {
      "actionKey": "6FED0BC540BFADD9BD89AAC22FA",
      "type": "VOICE_IVR"
     }
  ]
}	
  

Delete an Inbound IVR action

This method will delete an Inbound IVR action (actionKey) on a number (numberKey).

DELETE https://api.infobip.com/numbers/1/numbers/{numberKey}/actions/{actionKey}

Request example

DELETE /numbers/1/numbers/6FED0BC540BFADD9B05ED7D89AAC22FA/actions/6FED0BC540BFADD9BD89AAC22FA HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Accept: application/json	
  

A successful response is represented by a 204 No Content HTTP status code. There is no response body.