Recording

Routee voice Api offers the ability to record an active call. This action can be achieved in 2 ways:

  • The first one is to add the record option inside a ‘Dial’ verb
  • The second one is to consume the Voice Api start recording an active voice call.

Example of a Dial Verb

{
  "type": "DIAL",
  "from":string,
  "to": object,
  "hangupDelay": int,
  "maxDuration":int,
  "callback": object,
  "record": boolean,
  "recordingFormat": string,
  "recordingCallbackUrl": string,
  "machineDetection":object
}

If the value record is true the call will be recorded. The recording Format can be mp3 or wav and the information of the recorded file will be transferred to the recordingCallbackUrl.

In order to do that with the voice API handling an active voice call, you will need the messageId of the voice call. In case of an inbound call, Routee provides the messageId at the Dialplan Url which the user set at the Number he/she has rent.

Now the user has all the information necessary, to consume the voice Api record an active call.

Example:

curl -X POST \
  https://connect.routee.net/voice/conversation/09a7c9c6-b7e3-45a9-a918-6c947aae8c52/record \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json' \
  -H 'Postman-Token: eb59c046-77b4-4d06-bd4e-15feca56856f' \
  -H 'cache-control: no-cache' \
  -d '{
    "duration": 7,
    "format": "MP3" 
}'
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://connect.routee.net/voice/conversation/09a7c9c6-b7e3-45a9-a918-6c947aae8c52/record",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\n    \"duration\": 7,\n    \"format\": \"MP3\" \n}",
  CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer {access_token}",
    "Content-Type: application/json",
    "Postman-Token: bed24efe-9944-41fa-b266-f50c30ca2cdc",
    "cache-control: no-cache"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n    \"duration\": 7,\n    \"format\": \"MP3\" \n}");
Request request = new Request.Builder()
  .url("https://connect.routee.net/voice/conversation/09a7c9c6-b7e3-45a9-a918-6c947aae8c52/record")
  .post(body)
  .addHeader("Authorization", "Bearer {access_token}")
  .addHeader("Content-Type", "application/json")
  .addHeader("cache-control", "no-cache")
  .addHeader("Postman-Token", "44b3afb2-a307-400e-a618-5f606849b8bd")
  .build();

Response response = client.newCall(request).execute();
var data = JSON.stringify({
  "duration": 7,
  "format": "MP3"
});

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://connect.routee.net/voice/conversation/09a7c9c6-b7e3-45a9-a918-6c947aae8c52/record");
xhr.setRequestHeader("Authorization", "Bearer {access_token}");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.setRequestHeader("cache-control", "no-cache");
xhr.setRequestHeader("Postman-Token", "d9b2e3da-32d5-4705-aa3e-8dd3b2151b47");

xhr.send(data);

Query parameter

Description

messageId

The id of the voice call.

Body parameter

Description

duration

The duration for each record that the user can perform.

format

The record can have a format of a "MP3" or a "WAV" file.