Gruveo Embed API as well as the mobile SDKs allow you to record the users’ calls, with the composite call recordings uploaded straight into your own Amazon S3 bucket or an FTP/SFTP server. This page explains the necessary prerequisites, recording file properties as well as other important information regarding call recordings.
In order for us to setup call recording for your API account, we will need your client ID (request one here) as well as the following information.
To create an IAM user with the bucket access, follow the steps below:
bucket-name
with the name of your S3 bucket):
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
{ "Version": "2012-10-17", "Statement": [ { "Sid": "ListObjectsInBucket", "Effect": "Allow", "Action": ["s3:ListBucket"], "Resource": ["arn:aws:s3:::bucket-name"] }, { "Sid": "PutObjects", "Effect": "Allow", "Action": "s3:PutObject", "Resource": ["arn:aws:s3:::bucket-name/*"] } ] } |
Once you have the above information ready, please contact us to have call recording set up for your API account.
Once a call has been established, toggling call recording is as simple as calling the corresponding method in the API or the mobile SDK. For example, here is how to start and stop call recording with the Gruveo Embed API:
1 2 3 4 5 |
// Start call recording. embed.toggleRecording(true); // Stop call recording. embed.toggleRecording(false); |
Starting and stopping call recording are asynchronous processes. The Embed API and mobile SDKs notify you of any changes to the current call’s recording state via corresponding events, e.g. the recordingStateChange
event in the Embed API.
All call recordings are made in HD (1280×720) with the H.264 codec for video and AAC for audio. Recording files are composited, meaning that the pictures of the participants are combined, with dynamic maximization of the active speaker’s picture.
You are welcome to check out the recording functionality using the demo API credentials:
Client ID: demo
API secret: W62wB9JjW3tFyUMtF5QhRSbk
When using these demo credentials, all call recordings are uploaded to the publicly accessible gruveo-api-demo-recordings
S3 bucket:
https://s3.amazonaws.com/gruveo-api-demo-recordings/
Check out the Embed API demo for an example of using the call recording functionality.