Zoom

Zoom Bot Implementation Guide

View as Markdown

Step 1: Set up your Zoom app in the Zoom App Marketplace

Follow the steps below to create and configure your Zoom app.

1

Login to the Zoom App Marketplace

Sign in or sign up to access the Zoom App Marketplace.

Open Zoom App Marketplace

Go to the Zoom Marketplace

Recommendation

Use a dedicated/service account to avoid ownership issues later.

2

Create a new app

  1. Go to the Develop tab on the top right of the page
  2. Click the dropdown and select Build App
  3. Select General App
Zoom App Marketplace
Zoom App Marketplace
3

Choose app management type

Select how permissions will be granted:

User-managed

Individual users authorize access to their Zoom account.

Admin-managed

Admins authorize access for the entire organization.

Choose app type
4

Configure OAuth settings

  1. Go to the Basic Information tab
  2. Scroll to OAuth Information
  3. Paste the below Callback URL into the OAuth Redirect URL field
https://api.meetstream.ai/api/v1/admin/zoom/oauth/callback
Callback url paste
  1. Scroll further down in the same page and find OAuth Allow Lists and paste the below URL there
https://meetstream.ai
allow lists url paste
5

Enable Recording SDK

  1. Under Features tab click on Embed, and enable Meeting SDK

The rest can be ignored for now, just following what is mentioned is enough to connect our platform to zoom.

Enable Recording SDK
6

Copy your credentials

  1. Scroll to the top of the menu on the left or go to Basic Information
  2. Find App Credentials
  3. Copy your Client ID and Client Secret
copy credentials

Step 2: Connect Zoom with MeetStream

Prerequisite: Make sure your Zoom app is created and configured by following the above steps.

1

Add credentials to MeetStream

  1. Open the MeetStream Dashboard
  2. Go to the Integrations tab
  3. Navigate to the Zoom section
  4. Paste your Client ID and Client Secret
MeetStream Zoom credentials
2

Authorize the connection

Complete the OAuth authorization flow to connect your Zoom account.

authorise connection

Once authorized, your integration is ready.

MeetStream Zoom credentials
3

Create your first bot

Use the Create Bot API to start a bot.

API Documentation

View full API reference

Endpoint: POST /bots/create_bot

$curl -X POST "https://api.meestream.ai/api/v1/bots/create_bot" \
>  -H "Authorization: Token YOUR_API_KEY" \
>  -H "Content-Type: application/json" \
>  -d '{
>    "meeting_link": "",
>    "bot_name": "",
>    "bot_message": "",
>    "live_audio_required": {
>      "websocket_url": ""
>    },
>    "live_transcription_required": {
>      "webhook_url": ""
>    },
>    "custom_attributes": {
>      "tag": "",
>      "sample": ""
>    },
>    "callback_url": ""
>  }'

Responses:

  • 201: Bot created successfully
  • 400: Invalid request
  • 401: Unauthorized
  • 500: Server error

If recording permission is denied, consider exiting early to avoid missing recordings.

4

View your bot

  1. Go to the Bots section in your dashboard
  2. Find your bot
  3. Click View to monitor and debug
Bot Explorer

The above steps enable working for meetings hosted by your account only, to join meetings hosted by any account follow our Zoom App Production Submission Guide

Troubleshooting

  • Invalid or expired meeting link
  • App is in development mode
  • Waiting room not approved
  • Password-protected meeting
  • Audio not enabled in request
  • No active speakers
  • Permissions not granted by host
  • Processing delay after meeting
  • Invalid API key
  • Incorrect header format (Token YOUR_API_KEY)
  • Missing permissions
  • Rate limits exceeded