Testing Your Zoom OAuth Integration

Test and debug your Zoom OAuth integration.

Once you've gone through the Zoom OAuth Setup and either Recall-Managed or Customer Managed OAuth, you should test your integration.

This guide walks you through the questions to answer to ensure your integration is working properly.

Can Users Complete the OAuth Flow Successfully?

Use your own Zoom account or a test account and ensure it can go through the OAuth flow as expected.

After going through the flow, call the List Zoom OAuth Credentials endpoint and ensure your credentials are being created in Recall properly.

Are Zoom Meetings Synchronized Properly?

You can make a request to the List Zoom Meeting to OAuth Credential Mappings endpoint to see the list of meetings the Recall integration has synced, along with the OAuth credentials that were used to sync the meetings.

To test if your meetings are being created properly in Recall for your OAuth'ed Zoom account:

Any meetings in this list will be automatically recorded by bots sent to them.

curl -X GET <https://us-east-1.recall.ai/api/v2/zoom-meetings-to-credentials>  
	-H 'Authorization: Token YOUR-RECALL-API-KEY'

// Response
{  
  "next": null,  
  "previous": null,  
  "results": [  
    {  
      "meeting_id": 12347589873,  
      "credential": "dadcc9c3-2a6d-4f9a-9467-ff3a2b02a82f",  
      "synced_at": "2023-08-03T06:38:39.011715Z"  
    },  
    {  
      "meeting_id": 84731728293,  
      "credential": "dadcc9c3-2a6d-4f9a-9467-ff3a2b02a82f",  
      "synced_at": "2023-08-03T06:38:39.009752Z"  
    }  
  ]  
}

Can a Bot Record Zoom Meetings Automatically?

Since you've confirmed your Zoom account is registered with the Recall Zoom OAuth integration, and that all your upcoming meetings are be automatically synced, any bots sent to these meetings should be able to record automatically.

  1. Create an instant Zoom meeting (make sure the account is the same as the one you OAuth'ed)
  2. Sending a bot to the meeting by calling Create Bot
  3. Make sure the bot joins the meeting, and records properly with no popup.

Bot Logs


There are a few Bot Logs related to Zoom specifically:

  • zoom_join_token_fetch_using_zoom_oauth_failed
  • zoom_third_party_recording_token_fetch_using_zoom_oauth_failed
Error CodeExplanation
zoom_join_token_fetch_using_zoom_oauth_failedThe bot attempted to fetch a join token for local recording using the Zoom OAuth Integration OAuth and failed.

If you are using the Zoom OAuth Integration , this could indicate the meeting host has not installed your OAuth app, or something else went wrong.

If you are not using the Zoom OAuth integration, this can be safely ignored.

The bot will fall-back to prompting the host for recording permission manually.
zoom_third_party_recording_token_fetch_using_zoom_oauth_failedThis indicates that the bot attempted to fetch a Zoom 3rd Party Recording Token using OAuth and failed.

This could indicate the 3rd Party Recording Token feature is not enabled on the meeting host's Zoom account, but may also indicate that the credentials have become invalidated.

If you are not using the 3rd party recording token, this can be safely ignored.

The bot will fall-back to prompting the host for recording permission manually.