v1

latestOpenAPI 3.1.02026-07-2414238909.1 KB

Perform a voice conversation

post/voice/conversation

Headers

Content-Typestring required

application/json

Authorizationstring required

Bearer {access_token}

Request body

fromstring required

The sender id for the call. NOTICE: Alphanumeric sender is not supported by all networks (e.g. Greek networks). Check restrictions and features here: https://go.routee.net/#/management/restrictions-and-features.

dialPlanUrlstring

The url which contains a combination of action verbs to be executed. Use either "dialPlanUrl" or "dialPlan".

hangupDelayinteger

The time to wait for the call to be answered. Min value: 1. Max value: 60.

maxDurationinteger

Defines the maximum duration. Min value: 1

Response

200

trackingIdstring

directionstring

fromstring

createdAtstring

Example response

{
  "trackingId": "9effb0b5-99e2-434a-bc69-093398ec083e",
  "direction": "Outbound",
  "from": "Routee",
  "to": {
    "phone": "+306911111111"
  },
  "dialPlans": [
    {
      "verbs": [
        {
          "type": "PLAY",
          "fileURL": "http://xxx.xxxxxxxx.xxx/example.wav"
        }
      ]
    }
  ],
  "createdAt": "2017-12-21T13:12:31.582Z",
  "machineDetection": {
    "strategy": "Hangup"
  }
}