Perform a voice conversation

Creates a voice conversation in Routee.

POST

Query

Field selectionChoose which fields should be included in the response. Learn more

string

Comma-separated response fields to include.

Body

Arguments

objectrequired

The recipient of the call. The destination phone number. Format with a '+' and country code e.g., +3069485xxxxx (E.164 format). NOTE: limit 1 reqest per second

stringrequired

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.

object

A combination of action verbs to be executed. Can not be empty. Use either "dialPlanUrl" or "dialPlan".

string

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

object

Defines the notification callback information for the progress of Voice conversation

number

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

number

Defines the maximum duration. Min value: 1

object

It is used to detect if the call is answered by human or machine and define the desired actions (in case of machine).

curl --request POST \ --url "https://connect.mindcloud.co/v1/universal/routee/0.0.5/actions/perform-a-voice-conversation" \ --header "Authorization: Bearer $MINDCLOUD_API_TOKEN" \ --header "Content-Type: application/json" \ --data '{ "connectionId": "$CONNECTION_ID", "to": "", "from": "" }'

{ "success": true, "data": [ { "createdAt": "string", "dialPlans[]": { "verbs[]": { "bargeIn": true, "fileURL": "https://example.com", "repeat": 1, "type": "string" } }, "direction": "string", "from": "string", "machineDetection": { "strategy": "string" }, "to": { "phone": "string" }, "trackingId": "string" } ], "meta": {} }

Query

Body

Every app you connect,one REST pattern