SuperAPI AI 工具集

build-zoom-team-chat-app

智能体与模型

查看项目

更新于 10-16 06:51

技能介绍

本技能是 Zoom Team Chat 的后台参考,适合在确定聊天工作流后查阅,尤其在需要区分 Team Chat API 与 Chatbot API 时使用。两类集成不可互换:Team Chat API 以真实认证用户身份发送消息,使用 User OAuth(authorization_code),端点族为 /v2/chat/users/...,需要 chat_message:write、chat_channel:read 等权限;Chatbot API 以机器人身份发送消息,使用 Client Credentials(client_credentials),端点为 POST https://api.zoom.us/v2/im/chat/messages,权限 imchat:bot 自动添加。选错类型会导致认证、权限和端点全部不匹配。

主要能力:Team Chat API 支持发送消息、列出与创建频道、线程回复、编辑删除消息;Chatbot API 支持富消息卡片(标题、图片、字段、按钮、表单、下拉、日期选择)、斜杠命令、按钮交互回调、表单提交,以及接入 Claude、GPT 等大模型。Webhook 事件包括 bot_notification、bot_installed、interactive_message_actions、chat_message.submit、app_deauthorized。

使用方式:需 Zoom 账户并启用 Zoom for developers 角色;在 Zoom App Marketplace 创建 General App(OAuth),不要用 Server-to-Server OAuth,后者不支持 Chatbot/Team Chat。需从应用获取 Client ID、Client Secret,Chatbot API 还需 Account ID、Bot JID、Secret Token。OAuth 授权地址为 https://zoom.us/oauth/authorize,令牌地址为 https://zoom.us/oauth/token。本地测试可用 npm install -g ngrok 暴露 HTTPS 端点作为机器人回调地址。

适用场景:CI/CD 构建通知、服务器监控告警、定时报告、审批工作流、任务分配、状态更新、表单收集、LLM 助手、数据库查询、外部 API 集成等。

限制:消息长度上限 4,096 字符,文件 512 MB,每频道成员 10,000,每用户频道 500。生产环境需 HTTPS,应校验 x-zm-signature 签名、限制消息长度、校验 JID 格式、避免硬编码凭证。官方文档见 https://developers.zoom.us/docs/team-chat/,API 参考见 https://developers.zoom.us/docs/api/rest/reference/chatbot/。部分示例文档标记为待补充,具体细节暂未提供。