Zoom Integration Guide

This page explains how authorized ATMA practitioners add, use, and remove the ATMA AI Zoom integration. Configure URL (after sign-in): https://atma10.com/settings/integrations/zoom.

Who can connect Zoom

Only an authorized ATMA practitioner (staff) user can connect their own Zoom account. Clients do not connect Zoom. Installation starts from the ATMA site after you sign in — not as a silent background install.

How to connect Zoom to ATMA

Sign in to your ATMA practitioner account at https://atma10.com/staff-login.
Open Settings → Integrations → Zoom, or open https://atma10.com/settings/integrations/zoom.
Select Connect Zoom.
Sign in to your Zoom account when prompted.
Review the requested permissions.
Select Allow to authorize the connection.
Return to ATMA and confirm that the integration status is Connected.

If Zoom shows that the connection expired or was removed, select Connect Zoom again to re-authorize. ATMA will display: “Zoom connection expired or was removed. Please reconnect Zoom.”

Permissions requested and why

ATMA uses Zoom OAuth 2.0 (authorization code + PKCE). Tokens are stored encrypted on the server and are not shown in the browser. We request only the scopes needed for the features below.

user:read:user — Identify the practitioner’s Zoom account after authorization.
user:read:token — Obtain a host join token so the practitioner can open the meeting in the ATMA workspace.
meeting:write:meeting — Create a Zoom meeting for an ATMA counseling session or group game when the practitioner requests it.
meeting:read:meeting — Read meeting details needed to display status and join information in ATMA.
meeting:update:meeting — Adjust meeting settings required for the ATMA workspace (for example waiting-room behaviour).
meeting:update:status — End the live Zoom meeting when the practitioner ends the ATMA session.
meeting:write:invite_links — Create participant join links for clients or game players.
meeting:read:meeting_audio — Receive live meeting audio through Zoom RTMS when the practitioner starts listening / transcription.
meeting:read:meeting_transcript — Read transcript-related meeting data where Zoom exposes it for the authorized meeting.
meeting:update:participant_rtms_app_status — Start or stop RTMS for the meeting when the practitioner uses Listen / Auto / Stop.
rtms:read:rtms_started — Receive the event that RTMS has started so ATMA can process the live audio stream.
rtms:read:rtms_stopped — Receive the event that RTMS has stopped.
cloud_recording:read:list_recording_files — List cloud recording files after a session if cloud recording was enabled.
cloud_recording:read:recording — Download the practitioner-requested cloud recording into ATMA storage so it can be shared with the client when the practitioner chooses.

How to use Zoom-connected features

After Zoom is Connected, a practitioner can:

create an ATMA counseling session or group game with a Zoom meeting from their account;
open the meeting in the ATMA workspace (Meeting SDK) or via the Zoom start link;
send join links to clients or players (the practitioner remains the Zoom host);
start listening / transcription for that ATMA meeting (Zoom RTMS → transcript in the practitioner workspace);
review optional AI-assisted drafts generated from the transcript or notes;
after the meeting, fetch a cloud recording if it was enabled, and optionally send session materials to the client.

These features are practitioner-controlled. ATMA does not diagnose, treat, or replace your professional judgment. Obtain any required participant notices and consents before recording or transcribing a session.

How to disconnect Zoom in ATMA

Sign in to ATMA.
Open Settings → Integrations → Zoom.
Select Disconnect Zoom.
Confirm the disconnection.

The Zoom authorization is revoked. ATMA will no longer access Zoom data under that authorization. To request deletion of data already stored in ATMA, email privacy@atma10.com.

How to remove ATMA AI from Zoom

You can also remove the app in Zoom: Zoom App Marketplace or your Zoom account’s installed apps. After that, ATMA will show that the connection expired or was removed until you reconnect.

Zoom account apps: marketplace.zoom.us/user/installed.

Support

support@atma10.com — we aim to respond within 2 business days. See Support.

Privacy and client-consent guidance

Data handling is described in the Privacy Policy. Practitioners must not enable transcription or recording unless participants have been informed and any required consent has been obtained. Do not paste real client files into support tickets.

Architecture

Download diagram (SVG)

The practitioner accesses ATMA AI through a web browser over HTTPS. The browser communicates with ATMA backend services through authenticated API requests. Zoom account authorization is performed through OAuth 2.0. Zoom OAuth tokens are stored encrypted on ATMA server-side infrastructure and are not exposed to the browser. ATMA uses Zoom APIs only after practitioner authorization and only for the scopes required by the enabled features. Live audio is received via Zoom RTMS only when the practitioner starts listening. Speech-to-text and AI draft requests are made server-side and limited to data necessary for the practitioner-requested feature.

How to connect Zoom to ATMA AI