Zoom OAuth Overview

Use Recall's Zoom OAuth integration to enable automatic recording permission when joining calls.

📘

Automatic Recording Privileges

The Zoom OAuth integration is specifically for allowing bots to be able to record meetings without the host needing to manually grant recording access every meeting. The bot will also be able to bypass the waiting room.

If you don't use this integration, Zoom bots will fall back to the default behavior of prompting the host for explicit recording permission every meeting.

🚧

This flow requires the bot to join a call using an OBF or ZAK token

This flow uses the Zoom Meeting SDK, so you still need a Zoom OBF token or a Zoom ZAK token in addition to the join token callback.

It also requires you to (re)submit a Zoom app and go through the Zoom app review process.

To be compliant with Zoom's requirements for meeting bots, meeting bots need permission from the host to record

If the you don't want the host to grant permission to record every time, you can instead use Recall's "Zoom OAuth integration" where Recall will handle fetching the required tokens for bots to automatically start recording after joining the meeting even if the host is not present

❗️

What this integration doesn't do

The integration does not:

  • Automatically send bots to calls - Bots will only be sent to calls if the bot is created with the Create Bot endpoint or via the Calendar Integration.
  • Allow the bot to join sign-in required meetings - You will need to implement the Zoom Signed-in Bots Guide to allow the bot to join sign-in required meeting

How Recall manages Zoom OAuth (under the hood)

The integration does the following things:

  1. Manages OAuth credentials, such as access and refresh tokens
  2. Maintains a mapping between meeting IDs and Zoom OAuth credentials which are authorized to create a Join Token for that meeting ID
  3. Automatically fetches a Join Token and provides it to the bot when sending the bot to a call. This means that when the bot joins the call, it will be able to start recording automatically instead of needing to ask the host for permission.
End user connects account, Recall receives webhooks from Zoo

Bot is sent to end user's meeting, fetching a join token based on the ZoomMeetingToCredential mapping.

Did this page help you?