Question
People commonly ask on the Zoom Developer Forum:
Why isn’t the recording.transcript_completed webhook firing for a specific user, even though other events like recording.completed are received and the transcript file exists? What additional settings or permissions could block this webhook, especially when other events like meeting.summary_completed are working?
Answer
If you are experiencing issues with the recording.transcript_completed webhook not firing, despite receiving other webhooks like recording.completed, there are several key areas to check to troubleshoot the problem effectively.
-
Plan Eligibility: Ensure that the affected user is on a paid Zoom plan (Pro, Business, Education, or Enterprise). The recording.transcript_completed event requires a paid plan, as specified in Zoom’s documentation.
-
Cloud Recording and Transcription Settings:
- Confirm that Cloud Recording is enabled for the host.
- Check that the “Create audio transcripts” option is enabled in the host's settings. This is crucial for the transcript to be generated.
-
Meeting Host Verification: Make sure that the meeting is started by the authenticated host associated with your app installation. The host must be the one who initiated the meeting for the webhook to function correctly.
-
Webhook Subscription and Permissions:
- Verify that your Marketplace app is subscribed to the recording.transcript_completed event.
- Ensure that the user has granted the necessary OAuth permissions to your app. If other events are working, this is likely configured correctly.
- Webhook Logs and Delivery:
- Check your Zoom Marketplace Webhook app logs to see if the recording.transcript_completed event appears there.
- If it does appear, the webhook is firing, and the issue might be with delivery to your CRM. In this case, review Zoom’s guidance on delivery failures: Zoom API Webhook Delivery Failures.
- If the event does not appear in the logs, re-validate that the meeting generated a Cloud Recording transcript and that the correct app/environment is subscribed and active.
-
Endpoint Validation: Ensure that your delivery endpoint is correctly set up. It should return a 2xx response, be reachable, and not time out or block requests from Zoom.
-
Understanding Different Events: Note that the recording.transcript_completed event is specifically for Cloud Recording transcripts. It is possible for e.g. the meeting.summary_completed event to succeed while the transcript_completed event does not, especially if the prerequisites for Cloud Recording transcription are not met.
If you have checked all the above and the event still does not fire for the specific user, it may be necessary to reach out to Zoom Support with detailed information about the issue.
Zoom Developer Forum Examples
Some examples of this question are:
- https://devforum.zoom.us/t/recording-transcript-completed-event-not-firing-webhook/136188
- https://devforum.zoom.us/t/recording-transcript-completed-event-is-not-firing/137644
