Search…
Using The Plum Voice Suite
10DLC FAQs
Previous Email Notices
Quick References
Upload an Audio Recording to Storage
Plum Fuse makes it easy to generate audio recordings from phone calls. Using the Call Recording module you can record specific segments of a phone call or simply record all audio that occurs during a call. Using the Record module you can record specific caller input, similar to voicemail.
Regardless of how you utilize Fuse's call recording capabilities, the question of how to save those recordings remains.
For security and compliance reasons, Fuse does not save any recording data. All recordings are the client's responsibility and, therefore, are held in temporary memory until the call disconnects. At that point, the audio recording gets erased.
If you want to save one or more audio recordings made during a phone call, you must send the recorded audio to your own web server. Once the audio is on your web server, you can do anything with it you want to do.
In short, the basic workflow for call recording is as follows:
- Fuse captures call audio.
- This step repeats within a given call if you're capturing more than one continuous recording during a call. (See Reminder below)
- Fuse disconnects the call and deletes all call recording data generated during that call.
- Your call recording now resides on your web server.
Uploading Call Recording to Your Web Server
The example below outlines the entire process in simplified terms. It shows how you can collect a call recording, save it via REST API to Amazon S3, and use the file URL returned by the API in an e-mail module. The primary steps are as follows:
- The caller hears two prompts.
- The call recording ends.
Note: If you anticipate the caller hanging up before they get to the end of the call-flow, send the generated audio file using a post-call web service instead of a REST module.
Uploading from Your Web Server to Cloud Storage
Once your audio recording gets uploaded to your web server, you can do whatever you want with the audio file(s). If you want to upload call recording audio from your web server to storage, you can use the SDK for your cloud servers or modify the following PHP sample code to run on your web server so it works with your system(s).
Sample Code
1
<?php
2
$S3_CONFIG = [
3
'key' => '<aws key>',
4
'secret' => '<aws secret key>',
5
'region' => '<aws region>',
6
'bucket' => '<aws bucket name>'
7
];
8
9
header('Content-Type: application/json');
10
if(isset($_POST["filename"]) && isset($_FILES)) {
11
$result = upload_file($S3_CONFIG, $_FILES['recording']['tmp_name'], $_POST["filename"].".wav");
12
echo(json_encode($result));
13
}
14
else {
15
echo json_encode(array("status"=>"failure"));
16
}
17
18
function upload_file($config, $filepath, $new_name) {
19
$retval = [];
20
$ch = null;
21
22
try {
23
$service = 's3';
24
$content_type = 'audio/wav';
25
$filename = $new_name;
26
$file = file_get_contents($filepath);
27
$host = $config['bucket'] . ".$service." . $config['region'] . '.amazonaws.com';
28
$timestamp = gmDate("Ymd\THis\Z"); // Amazon web stamp format
29
$date = gmDate('Ymd');
30
31
// HTTP request headers as key & value
32
$request_headers = [];
33
$request_headers['Content-Type'] = $content_type;
34
$request_headers['Date'] = $timestamp;
35
$request_headers['Host'] = $host;
36
$request_headers['x-amz-content-sha256'] = hash('sha256', $file);
37
// Sort it in ascending order
38
ksort($request_headers);
39
40
41
$canonical_headers = [];
42
foreach($request_headers as $key => $value) {
43
$canonical_headers[] = strtolower($key) . ":" . $value;
44
}
45
$canonical_headers = implode("\n", $canonical_headers);
46
47
48
// Signed headers
49
$signed_headers = [];
50
foreach($request_headers as $key => $value) {
51
$signed_headers[] = strtolower($key);
52
}
53
$signed_headers = implode(";", $signed_headers);
54
55
// Cannonical request
56
$canonical_request = [];
57
$canonical_request[] = "PUT";
58
$canonical_request[] = "/" . $filename;
59
$canonical_request[] = "";
60
$canonical_request[] = $canonical_headers;
61
$canonical_request[] = "";
62
$canonical_request[] = $signed_headers;
63
$canonical_request[] = hash('sha256', $file);
64
$canonical_request = implode("\n", $canonical_request);
65
$hashed_canonical_request = hash('sha256', $canonical_request);
66
67
68
// AWS Scope
69
$scope = [];
70
$scope[] = $date;
71
$scope[] = $config['region'];
72
$scope[] = $service;
73
$scope[] = "aws4_request";
74
75
// String to sign
76
$string_to_sign = [];
77
$string_to_sign[] = "AWS4-HMAC-SHA256";
78
$string_to_sign[] = $timestamp;
79
$string_to_sign[] = implode('/', $scope);
80
$string_to_sign[] = $hashed_canonical_request;
81
$string_to_sign = implode("\n", $string_to_sign);
82
83
84
// Signing key
85
$kSecret = 'AWS4' . $config['secret'];
86
$kDate = hash_hmac('sha256', $date, $kSecret, true);
87
$kRegion = hash_hmac('sha256', $config['region'], $kDate, true);
88
$kService = hash_hmac('sha256', $service, $kRegion, true);
89
$kSigning = hash_hmac('sha256', 'aws4_request', $kService, true);
90
91
// Signature
92
$signature = hash_hmac('sha256', $string_to_sign, $kSigning);
93
94
95
// Authorization
96
$authorization = [
97
'Credential=' . $config['key'] . '/' . implode('/', $scope),
98
'SignedHeaders=' . $signed_headers,
99
'Signature=' . $signature,
100
];
101
$authorization = 'AWS4-HMAC-SHA256' . ' ' . implode( ',', $authorization);
102
103
// Curl headers
104
$curl_headers = [ 'Authorization: ' . $authorization ];
105
foreach($request_headers as $key => $value) {
106
$curl_headers[] = $key . ": " . $value;
107
}
108
109
$url = 'http://' . $host . '/' . $filename;
110
$ch = curl_init($url);
111
curl_setopt($ch, CURLOPT_HEADER, false);
112
curl_setopt($ch, CURLOPT_HTTPHEADER, $curl_headers);
113
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
114
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
115
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
116
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT");
117
curl_setopt($ch, CURLOPT_POSTFIELDS, $file);
118
$response = curl_exec($ch);
119
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
120
121
curl_close($ch);
122
123
$retval['status'] = 'success';
124
$retval['url'] = $url;
125
} catch(Exception $ex) {
126
if(!empty($ch)) {
127
curl_close($ch);
128
}
129
$retval['status'] = 'fail';
130
$retval['message'] = $ex->getMessage();
131
}
132
133
return $retval;
134
}
Copied!
Reminder
The Call Recording module allows you to record specific sections of a call. However, if you want to record multiple, non-consecutive segments in your voice app, you need to follow the process above for each recording.
For example, if you want to record audio on the first and third pages of your Fuse app, you need to upload the recording from the first page before the recording on the third page can start. Therefore, you need to start, stop, and upload the recording on page one. Then follow the same process for page three.
Each non-contiguous segment of recorded audio needs its own REST upload.
If you intend to capture more than one separate audio file in a single call, be sure to plan for multiple REST calls to send recorded audio when building your application.