Download a recording
In this code snippet you see how to download a recording.
Example
Replace the following variables in the example code:
| Key | Description |
|---|---|
VOICE_RECORDING_URL | The URL of the recording to download. You typically get this from the JSON response received on the |
Prerequisites
Execute the following command at your terminal prompt to create the JWT for authentication:
Run your code
Save this file to your machine and run it:
Prerequisites
Create a file named download-a-recording.js and add the following code:
const { FileClient } = require('@vonage/server-client');
const fileClient = new FileClient({
applicationId: VONAGE_APPLICATION_ID,
privateKey: VONAGE_PRIVATE_KEY,
});Write the code
Add the following to download-a-recording.js:
fileClient.downloadFile(
VOICE_RECORDING_URL,
VOICE_RECORDING_DESTINATION,
)
.then(() => console.log(`File Downloaded to ${VOICE_RECORDING_DESTINATION}`))
.catch((error) => console.error(error));Run your code
Save this file to your machine and run it:
Prerequisites
Add the following to build.gradle:
Create a file named DownloadRecording and add the following code to the main method:
Run your code
We can use the application plugin for Gradle to simplify the running of our application. Update your build.gradle with the following:
Run the following gradle command to execute your application, replacing com.vonage.quickstart.kt.voice with the package containing DownloadRecording:
Prerequisites
Add the following to build.gradle:
Create a file named DownloadRecording and add the following code to the main method:
VonageClient client = VonageClient.builder()
.applicationId(VONAGE_APPLICATION_ID)
.privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
.build();Write the code
Add the following to the main method of the DownloadRecording file:
/*
* A recording webhook endpoint which automatically downloads the specified recording to a file in the
* current working directory, called "downloaded_recording.mp3"
*/
Route downloadRoute = (req, res) -> {
EventWebhook event = EventWebhook.fromJson(req.body());
String recordingUrl = event.getRecordingUrl().toString();
Path recordingFile = Paths.get("downloaded_recording.mp3");
System.out.println("Downloading from " + recordingUrl);
client.getVoiceClient().saveRecording(recordingUrl, recordingFile);
return "OK";
};
Spark.port(3000);
Spark.post("/recording", downloadRoute);Run your code
We can use the application plugin for Gradle to simplify the running of our application. Update your build.gradle with the following:
Run the following gradle command to execute your application, replacing com.vonage.quickstart.voice with the package containing DownloadRecording:
Prerequisites
Prerequisites
Write the code
Add the following to index.php:
require_once __DIR__ . '/../../vendor/autoload.php';
$keypair = new \Vonage\Client\Credentials\Keypair(file_get_contents(VONAGE_APPLICATION_PRIVATE_KEY_PATH), VONAGE_APPLICATION_ID);
$client = new \Vonage\Client($keypair);
$recordingUrl = 'https://api.nexmo.com/v1/files/'.VONAGE_RECORDING_ID;
$data = $client->voice()->getRecording($recordingUrl);
file_put_contents(VONAGE_RECORDING_ID .'.mp3', $data->getContents());Run your code
Save this file to your machine and run it:
Prerequisites
Run your code
Save this file to your machine and run it:
Prerequisites
Run your code
Save this file to your machine and run it:
Try it out
You will need a Recording URL from which to download the recording file. You typically get this from the JSON response received on the /webhooks/recordings endpoint when the record action is used when recording a call, connecting another call and so on. A typical JSON response will resemble the following:
{'conversation_uuid': 'CON-ddddaaaa-bbbb-cccc-dddd-0123456789de',
'end_time': '2018-08-10T11:19:31Z',
'recording_url': 'https://api.nexmo.com/v1/files/aaaaaaaa-bbbb-cccc-dddd-0123456789ab',
'recording_uuid': 'ccccaaaa-dddd-cccc-dddd-0123456789ab',
'size': 162558,
'start_time': '2018-08-10T11:18:51Z',
'timestamp': '2018-08-10T11:19:31.744Z'}
1.2.3.4 - - [10/Aug/2018 11:19:31] "POST /webhooks/recordings HTTP/1.1" 200 -
When you run the script, the recording located at the recording URL will be downloaded. You can then listen to the recording.
Further Reading
- Transcription - This guide shows you how to use the Amazon Transcribe API to transcribe a phone conversation recorded with the Vonage Voice API.