How to activate recording

In the Create Room API you can select the recording type:

• none (default): recording not enabled
• manual: recording can be started and stopped by admin participants through the dedicated tool in the call UI. Go to "More Tools" (three dots button) > "Start Recording"
• automatic: recording starts at the beginning of a session and stopped at the end of a session.
  Each room session will have its separate recording file.

(BETA) if you set "offline_transcription": true you can enable the transcription feature on the recording file.

How to download recording files

1. Get all sessions of a given room id:

   

2. For each session, get the recording download link. The link is temporary. The expire time is expressed in seconds and is a number between 30 and 3600.

   
   

   Keep in mind that recording files are not immediately available at the end of a session. Processing can require up to 24 hours.
   In order to be notified when a recording file becomes available you can leverage the webhook with event on_recording_available, specifying in the url parameter the endpoint of your service which will be notified.

Transcription service (BETA)

Transcription Service can be enabled/disabled per company. If not enabled, final customers will receive API errors when trying to create a new room with transcription enabled or when they try to get transcriptions.

1. Create a room with Create Room API
   • recording enabled (either manual or automatic)
   • "offline_transcription": true
2. After a recording has finished processing, it will trigger the transcription service
3. After the transcription has finished processing the recording, on_transcription_available event is fired. You can receive the event by registering a webhook with Create Webhook API
4. Get the transcription of a session: Get Session Transcription API