Meeting Transcription
Dyte's meeting transcription allows you to transcribe your Dyte meetings in real-time, making it easy to capture important discussions and refer back to them later. This guide will walk you through how to use this feature effectively.
Control transcriptions for participants using presets​
You can control whether or not a participant's audio will be transcribe with the help of the transcription_enabled
flag in the participant's preset.
All participants with the transcription_enabled
turned on in their preset will be able to generate transcripts in real-time in a Dyte meeting.
You can create a new preset on our Developer Portal, or using our REST API.
Consuming transcripts​
There are 3 ways in which these transcripts can be consumed.
- Client core SDK: The transcripts can be consumed on the client-side using the Dyte SDK that's suitable for your platform. These transcripts are generated on the server in real-time.
- Webhooks: The meeting transcript can be consumed via a webhook after the meeting ends.
- REST API: The meeting transcript can also be fetched via the rest API.
Consuming transcripts in real-time​
For consuming transcripts in real-time on the client SDK of your choice, you just need to ensure that the transcription_enabled
flag is enabled in the preset.
Transcripts for all the participants having this flag set will be broadcasted in the meeting.
You can use the meeting.ai
object to access the transcripts.
console.log(meeting.ai.transcripts);
The transcripts are also emitted by the meeting.ai
object, so a listener can be attached to it.
meeting.ai.on('transcript', (transcriptData) => {
console.log('Transcript:', transcriptData);
});
Consume transcript via a post-meeting webhook​
You can configure a webhook with the meeting.transcript
event enabled to receive the meeting transcript after the meeting has ended.
You can do this either on our Developer Portal, or using a REST API.
You can see the webhook format here.
Fetch the meeting transcript​
You do not need to rely on the webhook to get the transcript for a meeting. Dyte provides a REST API using which you can obtain the transcripts for a particular session. You can use this API to get the transcript for a meeting at a later time. Dyte stores the transcript of a meeting for 7 days since the start of the meeting.
The transcript is received in the form of a CSV. Here is the format of the said CSV:
Timestamp, Participant ID, User ID, Custom Participant ID, Participant Name, Transcript
The following is a description of all the fields specified in the above CSV.
- Timestamp: An ISO 8601 format string indicating the time of utterance (or the time of speech).
- Participant ID: An identifier for individual peers in the meeting. For instance, if the participant joins the meeting twice, both the "peers" will have the same User ID but different Participant IDs.
- User ID: An identifier for a participant in the meeting, as returned by the add participant API call.
- Custom Participant ID: An identifier that you can specify to identify a user. This can be sent in the request body of the add participant API call.
- Participant Name: The display name of the user.
- Transcript: The transcribed utterance.
Testing transcription​
Once you have configured a preset and a webhook according to the instructions above, you can proceed to test whether meeting transcription is working for your organization. To test if meeting transcription has been configured for your organization, perform the following steps.
- Create a meeting.
- Add a participant to the meeting. Make sure that the preset you use was configured according to this guide.
- Join the meeting with the
authToken
you just obtained. As you unmute and speak, your speech should be getting transcribed in real-time for all the participants in the meeting. - Once the meeting ends, you will be getting a webhook with the event
meeting.transcript
. The body of this webhook will consist of the entire meeting transcript.