Zoom + Mattermost Integration – Documentation

Overview

This integration allows users to create and manage Zoom meetings directly from Mattermost channels using secure OAuth 2.0 authentication.

Adding the App (Required)

1. Login to Mattermost
2. Navigate to your team and open a channel
3. Run the command: /zoom connect
4. You will be redirected to Zoom
5. Login and approve the requested permissions
6. Once approved, you will be redirected back to Mattermost

Troubleshooting:

• If you see "Application not found", ensure the app is using Production Client ID
• If login fails, verify your Zoom credentials
• If command not recognized, ensure the plugin is enabled

Usage (Required)

Start a Meeting

Use Case: Quickly start a Zoom meeting from a Mattermost channel.

Command: /zoom start

Prerequisites:

• User must be authenticated with Zoom
• Zoom account must be active

Connect Zoom Account

Use Case: Link your Zoom account to Mattermost.

Command: /zoom connect

Prerequisites:

• Valid Zoom account

Removing the App (Required)

1. Login to Mattermost
2. Run the command: /zoom disconnect (if implemented)
3. Alternatively, revoke access from Zoom account settings

Deauthorization Impact:

• The app will no longer be able to create meetings
• Stored tokens will no longer be valid

Data Handling:

• OAuth tokens are stored securely and encrypted
• Tokens are deleted or invalidated upon disconnection
• No meeting content is stored by the application

OAuth Authorization Flow

1. User runs /zoom connect in Mattermost
2. User is redirected to Zoom authorization page
3. User logs into Zoom and approves permissions
4. Zoom redirects back to Mattermost via configured redirect URL
5. Access token is securely stored for future requests

All authorization uses the Production Client ID.

Scopes Used

• meeting:write – Create Zoom meetings from Mattermost
• meeting:read – Retrieve meeting details
• user:read – Identify the authenticated user

Features Covered in Testing

• OAuth account connection
• Meeting creation via /zoom start
• Posting meeting links into channels
• Multi-user support with individual Zoom accounts

Test Plan (Reviewer Use)

• Mattermost URL: https://mm3.junriyadh1.work
• OAuth Redirect: https://mm3.junriyadh1.work/plugins/zoom/oauth2/complete

Test Credentials:

Mattermost User:
zoomtestuser / TestPassword123!

Admin User:
zoomtestadmin / AdminPassword123!

Zoom Account:
zoomuser1.expanse869@slmail.me / ts8DfqE9tB

Test Steps:

1. Login to Mattermost
2. Navigate to channel #zoom-testing
3. Run /zoom connect
4. Authorize Zoom account
5. Run /zoom start
6. Verify meeting link appears