# AZCHESS Zoom Integration - User Documentation

Last updated: 2026-03-27
Product: AZCHESS (JBA Group LLC)
Support: https://www.azchess.az/az/support

## Overview

AZCHESS allows users to connect their own Zoom account, create classroom meetings, and join meetings inside the AZCHESS interface.

Zoom remains the communication provider. AZCHESS provides classroom workflow and UI.

## 1) Adding the App (Required)

### Prerequisites

- AZCHESS account with active login session
- Zoom account that can authorize OAuth and create meetings
- Desktop browser recommended for reviewer/tester flows

### Step-by-step: Connect Zoom in AZCHESS

1. Open https://www.azchess.az and sign in.
2. Go to the Zoom landing/integration entry: `https://www.azchess.az/az/zoom`.
3. Open classroom live page: `/az/labs/study/classroom/coach/live`.
4. In the Zoom section, click Connect Zoom.
5. Authorize the app in Zoom OAuth consent screen.
6. Return to AZCHESS and verify status shows Zoom account linked.

If you encounter issues while connecting, see the Troubleshooting Guide.

## 2) Usage (Required)

### Feature/Action Matrix

Feature / Action | Use Case | Prerequisites | How to Use
--- | --- | --- | ---
Connect Zoom account | Allow AZCHESS to perform Zoom actions on behalf of user | AZCHESS login + Zoom account | Classroom live page -> Zoom card -> Connect Zoom
Create Zoom meeting | Host creates lesson meeting directly from classroom | Zoom account linked | Zoom card -> Create via Zoom API
Save meeting to classroom | Persist meeting link/passcode for class participants | Meeting URL available | Zoom card -> Save
Join in-app (embedded) | User joins Zoom without leaving AZCHESS UI | Valid meeting saved | Zoom card -> Open Zoom in class
Join in new tab (fallback) | Fallback path if browser constraints affect embed | Valid meeting saved | Zoom card -> Open Zoom in new tab
Unlink Zoom | Disconnect AZCHESS from user Zoom account | Zoom previously linked | Zoom card -> Unlink Zoom

## 3) Removing the App (Required)

### A) Remove connection from AZCHESS

1. Sign in to AZCHESS.
2. Open classroom live page and locate Zoom card.
3. Click Unlink Zoom.

### B) Revoke authorization from Zoom account

1. Sign in to Zoom with the authorized account.
2. Open Zoom App Marketplace installed apps management.
3. Locate AZCHESS app and remove/revoke access.

### Implications of De-authorization

- AZCHESS can no longer create new Zoom meetings using that account.
- AZCHESS can no longer refresh Zoom access tokens for that account.
- In-app Zoom actions require reconnecting Zoom authorization.

### How AZCHESS removes user data

- On unlink/de-authorization, AZCHESS removes stored Zoom OAuth link data for that AZCHESS user (access/refresh token and linked profile metadata).
- Existing classroom meeting links previously saved by user are not automatically deleted from classroom records unless user clears/removes them in UI.

## 4) Troubleshooting Guide

- OAuth popup blocked: allow popups for `www.azchess.az` and retry.
- Token expired / reconnect required: click Reconnect Zoom in Zoom card.
- Embed join issues: try Open Zoom in new tab fallback.
- Missing required scope behavior: use test plan matrix at https://www.azchess.az/zoom-marketplace-test-plan.html .