用途:帮助开发者搭建 Google Chat 机器人与 Webhook,支持通知推送、交互式卡片、表单收集与按钮工作流。
主要能力:提供两种集成方式。一是 Incoming Webhook,仅需在 Chat 空间配置 Webhook URL,用 HTTP POST 发送 JSON 即可,无需鉴权,适合 CI/CD 通知与告警等单向消息。二是 HTTP Endpoint 机器人,需创建 Google Cloud 项目、启用 Chat API、配置 HTTP 端点并部署 Cloudflare Worker,可处理 MESSAGE、CARD_CLICKED、ADDED_TO_SPACE 等事件并返回 Cards v2 卡片。
卡片与交互:使用 Cards v2(Cards v1 已弃用),支持 textParagraph、buttonList、textInput、selectionInput、dateTimePicker、divider、image、decoratedText 等组件,并支持 HTML 与 Markdown 文本格式。可构建通知卡片、交互表单与模态对话框。
API 覆盖:包含 Spaces API(创建、删除、查询、搜索空间等)、Members API(成员增删查)、Reactions API 与速率限制说明。
安全与限制:HTTP 端点需校验 Bearer Token(使用 Web Crypto API,Cloudflare Workers 兼容),密钥应通过 wrangler secret 管理。每张卡片最多 100 个组件,超出会被静默截断;cardId 需唯一;必须在超时(通常 30 秒)内返回合法 JSON;表单需服务端校验;注意 429 速率限制并采用指数退避。
依赖与版本:推荐 Cloudflare Workers,wrangler@4.54.0,Google Chat API v1。资料提供 webhook-handler、interactive-bot、card-builder-examples、form-validation、bearer-token-verify 等模板,以及文档、卡片 schema 与常见错误参考。具体价格与平台支持范围暂未提供。