Callback server
Set up a callback server for Vivox server-side recording.
Read time 1 minuteLast updated 2 days ago
SSR provides a callback mechanism to notify you when a recording job is complete. This allows you to take action on the recording once it is complete.
Set up a callback server
- To set up a callback server, you need to create a server that can receive a POST request from the SSR API. The request will contain a JSON payload with the job's status.
- SSR makes a request to any URL in the field of the request. If you specify a
callbackUriVivox includes this in the header of the request undercallbackKey.Authorization
Callback payload
The payload of the callback contains the following fields:{ "job_status": "string", "job_id": "string", "code": "string", "metadata": "object"}
- will either be
job_status,complete, orfail.partial- When a job is , this means that not all of the audio recorded or decoded successfully.
partial
- When a job is
- is the ID of the job. It corresponds to
job_idin the response of the original request.job_id - is the error code if the job failed. Refer to error codes for more information.
code - is any metadata you passed in the original request. If you did not set any
metadatathis field will be omitted from the request.metadata
Error codes
Code | Description |
|---|---|
| 2001 | Service is not enabled. |
| 2002 | Internal service error. |
| 2003 | No audio was found for the channel requested. |
| 2004 | Invalid Storage. |
| 2005 | Internal service error. |
| 2006 | No audio decoded due to |
| 2103 | Unsupported audio format. |
| 2107 | AWS bucket is throttled. |