SuperAPI AI 工具集

google-chat-messages

编程与开发

查看项目

更新于 10-15 23:31

技能介绍

用途:通过 Google Chat 传入 Webhook 向空间发送消息,产出文本消息、cardsV2 富卡片和线程回复,并提供可复用的 Webhook 发送工具。

主要能力:文本消息支持 Google Chat 专有格式(粗体、斜体、~删除线~、等宽、代码块、<url|text> 链接、<users/ID> 提及),不支持标准 Markdown 的 双星号、标题、引用块、表格与内联图片。cardsV2 卡片支持 header(标题、副标题、图片、CIRCLE/SQUARE)、sections 与多种组件:textParagraph、decoratedText(topLabel/text/bottomLabel、startIcon、自定义 iconUrl、button、wrapText、整体可点击)、buttonList(多按钮、颜色、图标)、image、divider,以及可折叠 section(collapsible、uncollapsibleWidgetsCount)。图标可用 knownIcon(如 STAR、EMAIL、CLOCK 等)或 iconUrl。线程通过 threadKey 关联,回复时需在 Webhook URL 追加 &messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD。

使用方式:先在 Google Chat 空间的管理 Webhook 中创建并复制 URL,存入环境变量或密钥管理,切勿硬编码。再按需求选择文本、卡片或线程回复。发送使用 assets/webhook-sender.ts,卡片构建使用 assets/card-builder.ts,类型定义见 assets/types.ts。

适用场景:构建完成通知、状态与摘要卡片、持续更新线程、带操作按钮的告警等。

限制:Webhook URL 需妥善保管;文本格式与标准 Markdown 不同;卡片须包裹在 { cardsV2: [{ cardId, card }] } 中,sections 至少含一个组件;返回 400 多为 JSON 结构问题。具体收费、平台支持范围等资料未提供。