Recording Transcription

Recording Transcription allows you to get a transcript of any session recording stored in Whereby-provided storage

Recording Transcription is a supplementary feature of our paid Whereby Embedded plans. You can review the pricing and options on our site.

Recording Transcription is available by default for all session recordings stored in Whereby-provided storage and there is no need to enable or configure this feature. Recording transcripts are derived from recordings and saved as text files accessible through the customer portal or via the API. They can be used as a standalone resource (eg. for compliance purposes) or sent to an external service for post processing (eg. to derive key topics or create a session summary).

In order to produce a transcript from a recording of Whereby session you need to follow these steps:

  1. Create a Whereby room with cloud recording enabled and configured to use Whereby-provided storage.

  2. Record the session.

  3. Trigger the transcription for the recording.

You can use Recording Transcription manually through the customer portal, or programatically with the combination of API requests and webhook events.

Manual Transcriptions

In order to use Recording Transcription you need to first configure meeting recordings to use cloud recording with Whereby-provided storage. Go to “Configure” → “Recording” section of your customer portal and choose "Whereby-hosted cloud recording" option with the trigger and recording format of your choice. Learn more about recording options.

When configuring cloud recording options via the customer portal, they will be applied as default settings for all rooms and meetings. However, you can override the defaults by specifying different preferences in the POST requests used to create meetings.

When the sessions get recorded, you can access all recordings saved in the Whereby-provided storage from the “Recordings” page of your customer portal. Find the session that you want to transcribe and choose the "Start transcription" option from the Actions column.

The transcription process may take some time, especially for recordings longer than 30 minutes. Once the transcript is ready, you can download it. The transcript is downloaded as an .md file.

You can also download or delete transcriptions that have been already created from the “Recordings” page of your customer portal.

Programmatic Recording Transcriptions

If you want to automate the process of transcribing recorded Whereby sessions, you can do so with a combination of API requests and webhook events.

Configure session recoding

First make sure that meetings are configured to use cloud recording with Whereby-provided storage:

  • If you want to use cloud recording with Whereby-provided storage globally for all rooms, go to “Configure” → “Recording” section of your customer portal and choose "Whereby-hosted cloud recording" option with the trigger and recording format of your choice.

  • If you prefer to set the recording type for each room or meeting individually, create the meeting with POST /meetings request using the following parameters for recording (with the "startTrigger" and "fileFormat" of your choice):

"recording": {
    "type": "cloud",
    "destination": {
      "provider": "whereby",
      "fileFormat": "mp4"
    },
    "startTrigger": "none"
   },       

Record and transcribe the session

Depending on the type of recording trigger specified for the meeting, it will be recorded automatically or the host will need to start the recording manually.

When the recording is completed, Whereby sends a recording.finished webhook event. Hook onto that event to fetch the recordingId of the session that you want to transcribe.

Then send a POST /transcriptions request with the recordingId to start the transcription job.

The transcription process may take some time, especially for recordings longer than 30 minutes. Once the transcript is ready, Whereby sends a transcription.finished webhook event. Hook onto that event to fetch the transcriptionId of the session that you want to transcribe.

Send a GET /transcriptions/{transcriptionId}/access-link request to get the download link of the transcription file. Transcripts are downloaded as .md files.

Delete the recording and transcription files

Both the recording and the transcript of the session will be stored in the Whereby-provided storage until you delete them. If you want to optimise the cost or minimise the time when your sessions' content is stored in the Whereby-provided storage you can delete the assets with 2 API requests:

Supported Languages

Recording Transcriptions feature automatically identifies the dominant language spoken in the session and creates a transcript in this language. The following languages are supported: Chinese, Dutch, English, French, German, Hindi, Indonesian, Italian, Japanese, Korean, Portuguese, Russian, Spanish, Swedish, Turkish, Ukrainian.

Known limitations

Recording Transcriptions are only available for session recordings stored in Whereby-provided storage. If you store session recordings in your own Amazon S3 bucket, it will be not possible to trigger transcriptions for these recordings.

Since recording transcripts are derived from recordings saved in Whereby-provided storage, this feature is not considered to be HIPAA compliant. Avoid using recording transcription in order to maintain HIPAA compliance of your Whereby sessions. Learn more about Whereby HIPAA compliant setup.

Recording Transcriptions sometimes fail for recordings of sessions longer than 45 minutes, so it is recommended to use this feature for shorter sessions. We will not charge you for failed transcriptions.

Last updated