Introduction
Using Zoom APIs
Pagination
Error Definitions
Rate Limits
Testing Zoom APIs
Accounts
Billing
Chat Channels
Chat Channels (Account-level)
Chat Messages
Chatbot Messages
Contacts
Cloud Recording
Dashboards
Devices
Groups
IM Chat
IM Groups
Meetings
PAC
Phone
Phone Auto Receptionists
Phone Blocked List
Phone Call Queues
Phone Devices
Phone Reports
Phone Shared Line Groups
Phone Site
Common Area Phones
Reports
Roles
Rooms
Rooms Account
Rooms Location
SIP Phone
TrackingField
TSP
Users
Webinars
Rooms Devices
SIP Connected Audio
Deprecated API Endpoints
Data Compliance

Recording Transcript Completed


Zoom supports audio transcription of Cloud Recordings. To utilize audio transcription, users must first enable it. An account owner or a user with admin permissions can enable Cloud Recording for an account or a group of users.

The “Recording Transcript Completed” event is triggered every time the transcript of the recording is made available for one of your app users or account users after the meeting or webinar that was being recorded ends. To receive notifications for this event, you must meet the following prerequisites.

Prerequisites

  • Business, Education, or Enterprise license with Cloud Recording enabled on the account.
  • Event Subscriptions must be enabled for your Marketplace app with the following configurations:
    • A valid Event Notification Endpoint URL.
    • "Recording transcript files have completed" subscription enabled under the Recording event.

The tabs below display the complete schema, payload with data types, and an example of the recording.transcript_completed event notification:

Recording Transcript Completed Event Notification
recording.transcript_completed
object
event
string

Name of the event.

payload
object
download_token
string

Use this token along with the download_url to download the transcript of the Cloud Recording via an OAuth app. This token only lasts for 24 hours after generation and thus, you can only download the file within 24 hours of receiving the “recording.completed” event notification.

You can either include the download_token as a query parameter or pass it as a Bearer token in the Authorization header of your HTTP request.

Using Authorization Header (Recommended)

curl --request GET \
  --url {download_url} \
  --header 'authorization: Bearer {download_token} \
  --header 'content-type: application/json'

Using Query Parameter

The URL to download this type of recording will follow this structure: {download_url}/?access_token={download_token}

Example: https://zoom.us/recording/download/bdfdgdg?access_token=abvdoerbfg