用途:为 Zoom Team Chat 集成提供背景参考,在聊天工作流明确后使用,尤其适合需要区分 Team Chat API 与 Chatbot API 的场景。
主要能力:一是 Team Chat API(用户类型),以真实认证用户身份发消息,使用 User OAuth(authorization_code),端点族为 /v2/chat/users/...,常用端点 POST https://api.zoom.us/v2/chat/users/me/messages,常见 scope 包括 chat_message:write、chat_channel:read,可用于发消息、列出与创建频道、线程回复、编辑删除消息。二是 Chatbot API(机器人类型),以机器人身份发消息,使用 Client Credentials(client_credentials),端点族为 /v2/im/chat/messages,scope 为 imchat:bot(自动添加),支持富卡片(标题、图片、字段、按钮、表单、下拉、日期选择)、斜杠命令、按钮动作与表单提交,并便于接入 Claude、GPT 等 LLM。
使用方式:先按“API Selection Guide”确认路线,再完成环境配置与 OAuth 或 Client Credentials 认证,然后参照示例发送消息或搭建带 Webhook 的机器人。OAuth 端点为 https://zoom.us/oauth/authorize 与 https://zoom.us/oauth/token。Webhook 需用 x-zm-signature 校验签名,本地调试可用 ngrok http 4000。Chatbot 相关凭据包括 Client ID、Client Secret、Account ID、Bot JID 与 Secret Token;创建应用需在 App Marketplace 选择 General App (OAuth),不要使用 Server-to-Server OAuth,因其不支持 Chatbot/Team Chat 功能。
适用场景:CI/CD 或脚本通知、用户自动化发消息、交互式聊天机器人、审批与任务工作流、调度告警、LLM 助手集成。
限制:消息长度 4,096 字符,文件 512 MB,每频道成员 10,000,每用户频道 500;生产 Webhook 必须使用 HTTPS,凭据不可硬编码,需校验 JID 格式并清理消息。样本、错误码、限流等部分条目在资料中标注为待补充。