Skip to content

Commit 606b072

Browse files
uchebuzz-codergithub-actions[bot]uzair401
authored
Zoom meeting manager (#237)
Signed-off-by: Uzair Ullah <uzairullahmail@gmail.com> Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: Uzair Ullah <uzairullahmail@gmail.com>
1 parent db52a74 commit 606b072

3 files changed

Lines changed: 934 additions & 0 deletions

File tree

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
# Zoom Meeting Manager
2+
3+
![Community](https://img.shields.io/badge/OpenHome-Community-orange?style=flat-square)
4+
![Author](https://img.shields.io/badge/Author-@uchebuzz-coder--lightgrey?style=flat-square)
5+
6+
## What It Does
7+
8+
Voice access to your Zoom schedule, meeting details, and cloud recordings. Ask what is next on Zoom, get join links and passcodes, cancel meetings, or (on Pro+) list recordings, summarize transcripts, and play recordings.
9+
10+
## Suggested Trigger Words
11+
12+
- "Zoom meetings"
13+
- "my Zooms"
14+
- "Zoom schedule"
15+
- "today's Zooms"
16+
- "next Zoom"
17+
- "Zoom link"
18+
- "Zoom passcode"
19+
- "cancel Zoom"
20+
- "Zoom recording"
21+
- "summarize Zoom"
22+
- "Zoom transcript"
23+
24+
Configure additional phrases in the OpenHome dashboard for this ability.
25+
26+
## Setup
27+
28+
### Zoom plan requirements
29+
30+
This ability works with **any Zoom plan** for schedule management (view meetings, details, cancel meetings).
31+
32+
**Cloud recording features** (list recordings, summarize transcript, play recording) require **Zoom Pro or higher**. On the free plan, recording-related commands are unavailable; the ability tells you when a feature needs Pro.
33+
34+
### Zoom Server-to-Server OAuth app
35+
36+
1. Go to [marketplace.zoom.us](https://marketplace.zoom.us)
37+
2. Click **Develop****Build App**
38+
3. Choose **Server-to-Server OAuth**
39+
4. Name it (for example, "OpenHome")
40+
5. Under **Scopes**, add:
41+
- `meeting:read:list_meetings:admin` — list and view meetings
42+
- `meeting:delete:meeting:admin` — delete meetings
43+
- `cloud_recording:read:list_account_recordings:admin` — list cloud recordings
44+
- `cloud_recording:read:recording:admin` — view a recording
45+
- `cloud_recording:read:meeting_transcript:admin` — read meeting transcript
46+
- `user:read:user:admin` — read user profile (plan detection)
47+
6. Activate the app
48+
7. Copy your **Account ID**, **Client ID**, and **Client Secret**
49+
50+
### Credentials in OpenHome
51+
52+
Add those values in the OpenHome dashboard under this ability's settings. For local development you can set `ZOOM_ACCOUNT_ID`, `ZOOM_CLIENT_ID`, and `ZOOM_CLIENT_SECRET`. Credentials are stored in the ability's persistent storage; access tokens stay in memory and refresh automatically.
53+
54+
## How It Works
55+
56+
After you trigger the ability, it uses the Zoom REST API with Server-to-Server OAuth. It can list today's meetings, find your next meeting (including join details when the start is soon), look up a meeting by time or topic, cancel a meeting with confirmation, and on Pro+ accounts list cloud recordings, fetch transcripts for summaries, and stream or play recordings. Exit words such as "stop" or "exit" end the session.
57+
58+
## Example Conversation
59+
60+
> **User:** "What's my next Zoom?"
61+
> **AI:** "Your next meeting is Team standup at 2:00 PM. It starts in about ten minutes. Here's the join link…"
62+
63+
> **User:** "Cancel my 11 o'clock Zoom"
64+
> **AI:** "I found 'Project sync' at 11:00 AM. Say yes to cancel it or no to keep it."
65+
> **User:** "Yes"
66+
> **AI:** "Done. That meeting has been cancelled."
67+
68+
> **User:** "Any Zoom recordings from this week?"
69+
> **AI:** *(Pro+)* "You have two recordings…"
70+
> *(Free plan)* "Cloud recordings need a Zoom Pro or higher plan. I can still help with your schedule."

community/zoom-meeting-manager/__init__.py

Whitespace-only changes.

0 commit comments

Comments
 (0)