用途:为 Zoom Team Chat 构建消息集成与交互式聊天机器人,覆盖两套互不兼容的 API,需先按场景选型。Team Chat API(用户类型)以真实认证用户身份发消息,使用 User OAuth(authorization_code),端点族为 /v2/chat/users/...,示例端点 POST https://api.zoom.us/v2/chat/users/me/messages,作用域 chat_message:write、chat_channel:read。Chatbot API(机器人类型)以机器人身份发消息,使用 Client Credentials(client_credentials),端点族为 /v2/im/chat/messages,作用域 imchat:bot(自动添加)。
主要能力:Team Chat API 支持发送消息、列出/创建频道、线程回复、编辑删除消息;Chatbot API 支持富消息卡片(标题、图片、字段、按钮、表单、下拉、日期选择)、斜杠命令、按钮回调、表单提交及与 LLM 集成。Webhook 事件包括 bot_notification、bot_installed、interactive_message_actions、chat_message.submit、app_deauthorized。
使用方式:需 Zoom 账号并启用 Zoom for developers,在 Marketplace 创建 General App(OAuth),不要用 Server-to-Server OAuth 建聊天机器人。凭据含 Client ID、Client Secret、Account ID、Bot JID、Secret Token。Chatbot 回复须用 client_credentials 令牌,并保留 webhook 载荷中的 toJid、userJid、accountId。Webhook 返回 200 仅表示收到事件,需检查 /im/chat/messages 的 HTTP 状态与响应体。本地可用 ngrok http 4000 暴露端点。
限制:消息长度 4096 字符,文件 512 MB,每频道 10000 成员,每用户 500 频道。需验证 x-zm-signature 签名、使用 HTTPS、避免硬编码凭据。401 且 code 7010 通常为开发/生产凭据或 Bot JID 混用。