Zoom

使用scripts/zoom.py与 Zoom 的 REST API 进行交互。

前提条件

pip3 install requests PyJWT --break-system-packages

认证

在技能的.env文件中设置以下内容（从.env.example复制）：

• ZOOM_ACCOUNT_ID— 账户 ID（来自 Zoom Marketplace 应用）
• ZOOM_CLIENT_ID— OAuth 客户端 ID
• ZOOM_CLIENT_SECRET— OAuth 客户端密钥
• ZOOM_USER_EMAIL— 要作为操作对象的 Zoom 用户邮箱（S2S 应用必需；如果未设置，默认为me）
• ZOOM_RTMS_CLIENT_ID— RTMS Marketplace 应用的客户端 ID（为rtms-start/rtms-stop; 这是一个独立于S2S OAuth应用的应用）

在https://marketplace.zoom.us/创建一个服务器到服务器OAuth应用以获得完整的API访问权限。 详细设置指南请参见references/AUTH.md。

命令

会议

# List upcoming meetings
python3 scripts/zoom.py meetings list

# List live/in-progress meetings (requires Business+ plan with Dashboard)
python3 scripts/zoom.py meetings live

# Start RTMS for a live meeting (requires ZOOM_RTMS_CLIENT_ID)
python3 scripts/zoom.py meetings rtms-start <meeting_id>

# Stop RTMS for a live meeting
python3 scripts/zoom.py meetings rtms-stop <meeting_id>

# Get meeting details
python3 scripts/zoom.py meetings get <meeting_id>

# Schedule a new meeting
python3 scripts/zoom.py meetings create --topic "Standup" --start "2026-01-28T10:00:00" --duration 30

# Schedule with options
python3 scripts/zoom.py meetings create --topic "Review" --start "2026-01-28T14:00:00" --duration 60 --agenda "Sprint review" --password "abc123"

# Delete a meeting
python3 scripts/zoom.py meetings delete <meeting_id>

# Update a meeting
python3 scripts/zoom.py meetings update <meeting_id> --topic "New Title" --start "2026-01-29T10:00:00"

日历（即将到来的日程）

# Today's meetings
python3 scripts/zoom.py meetings list --from today --to today

# This week's meetings
python3 scripts/zoom.py meetings list --from today --days 7

录制内容

# List cloud recordings
python3 scripts/zoom.py recordings list

# List recordings for date range
python3 scripts/zoom.py recordings list --from "2026-01-01" --to "2026-01-31"

# Get recording details
python3 scripts/zoom.py recordings get <meeting_id>

# Download recording files (video/audio)
python3 scripts/zoom.py recordings download <meeting_id>
python3 scripts/zoom.py recordings download <meeting_id> --output ~/Downloads

# Download transcript files only
python3 scripts/zoom.py recordings download-transcript <meeting_id>
python3 scripts/zoom.py recordings download-transcript <meeting_id> --output ~/Downloads

# Download AI Companion summary as markdown
python3 scripts/zoom.py recordings download-summary <meeting_uuid>
python3 scripts/zoom.py recordings download-summary <meeting_uuid> --output ~/Downloads

# Delete a recording
python3 scripts/zoom.py recordings delete <meeting_id>

AI会议摘要（AI Companion）

# List meeting summaries
python3 scripts/zoom.py summary list
python3 scripts/zoom.py summary list --from "2026-01-01" --to "2026-01-31"

# Get AI summary for a specific meeting
python3 scripts/zoom.py summary get <meeting_id>

用户

# Get my profile
python3 scripts/zoom.py users me

# List users (admin)
python3 scripts/zoom.py users list

团队聊天

# List chat channels
python3 scripts/zoom.py chat channels

# List messages in a channel
python3 scripts/zoom.py chat messages <channel_id>

# Send a message to a channel
python3 scripts/zoom.py chat send <channel_id> "Hello team!"

# Send a direct message
python3 scripts/zoom.py chat dm <email> "Hey, are you free?"

# List contacts
python3 scripts/zoom.py chat contacts

电话（Zoom Phone）

# List call logs
python3 scripts/zoom.py phone calls --from "2026-01-01" --to "2026-01-31"

所需权限范围

对于服务器到服务器OAuth，请在您的Zoom Marketplace应用中启用这些权限范围。 请仅添加您需要的权限范围——每个命令组都需要特定的权限范围：

如果你遇到权限范围错误请前往https://marketplace.zoom.us/→ 你的应用 → 权限范围页面，根据错误提示添加缺失的权限范围。

速率限制

Zoom API 设有速率限制（不同接口限制不同，通常为每秒30-100次请求）。脚本会自动重试以处理429响应。