与 AI 一起工作

聊天中的应用

让 Sentry、GitHub、Google Forms 或其他任何服务把更新发到聊天里,以卡片形式显示,聊天里的每个人都能看到。

聊天可以接收团队已经在用的服务发来的更新:新的 Google 表单 回复、来自 Sentry 的错误、来自 GitHub 的拉取请求和 失败的检查,或者任何能向 Webhook URL 发送消息的服务。它们以应用发出的卡片显示,带有应用的标志和 应用 标签,从不显示为 某个人。同一件事的后续更新(同一个错误、同一个拉取请求、被修改的回复)会放进第一张卡片下的同一个话题里,第一张卡片的状态行 会随之更新。

#添加应用

  1. 打开聊天,然后选择 ⋯ › 添加应用。
  2. 选择一个服务。服务分组列出:表单(Google 表单、Typeform、Tally、Jotform)、付款与订单(Stripe、Shopify)、 工作(Notion、Zendesk、Jira、HubSpot)和 开发者(GitHub、Sentry)。显示更多服务 会打开另外几个(Toss Payments、Channel Talk、PortOne)。最后的 其他应用 可以接入其他任何服务。需要特定方案或角色 的服务会在它那一行写明(例如 需要:Notion 付费方案)。其他应用要先起个名字(例如 备份通知),它的消息会以这个名字显示。
  3. 按 Webhook URL 旁边的 复制(Google 表单为 复制代码),然后按照该服务中的编号步骤操作。在你复制之前,聊天里不会 添加任何东西,所以你可以先看看,再关闭指南。
  4. 指南会实时显示进展:正在等待第一条消息、已连接,或者上一次为什么没有显示。看个示例 会在指南里显示它的消息会是 什么样子,不会真的发布。两分钟后仍没有消息时,还没有收到? 会列出该服务常见的问题以及如何发送测试。

也可以从 设置 › 连接器 开始。Sentry、Notion、Stripe 和 Atlassian(Jira)的行下方有 将应用添加到聊天。 它只列出你可以添加应用的聊天;选一个,该聊天会打开并显示这个服务的设置指南。如果还没有,请先用 新聊天 开始一个。

添加应用

谁可以添加:在团队群聊或所有人群聊中,是其中的所有者和管理员;在一对一聊天或群聊中,是其中的任何人。聊天里的其他人 可以看到卡片、在话题中回复,并向 Trina 询问。点一下应用的名称,可以看到是谁设置的。

聊天里的每个人都能看到应用的消息,之后加入的人也能看到。请谨慎选择聊天:错误报告或表单回答里可能有客户数据。

#在聊天中

每条更新都是应用名称下的一张卡片,带有 应用 标签、发生了什么、一行状态和在该服务中打开的链接。回复放在卡片的话题里,和 其他消息一样。聊天的 ✦ 侧边对话提供 今天发生了什么?,它会汇总应用的消息,把需要有人处理的放在前面(有 Google 表单的 聊天还有 总结今天的回复);在话题中则提供 总结这个话题。

应用卡片和侧边对话

#Google 表单

Google 表单没有可以粘贴网址的地方,所以 Trina 会给你一段用于表单的短脚本 (Apps Script 触发器)。

  • 在表单中打开 ⋮ › Apps Script,删除原有内容,粘贴代码并保存。
  • 在顶部选择 setUp,然后点 Run。Google 会显示 Google hasn't verified this app:这是正常的,因为脚本是你自己的, 只在你的账号里运行。选择 Advanced › Go to … (unsafe),然后允许访问。
  • 如果表单收集电子邮件地址,每条回复都会显示回复者的邮箱。在应用设置中关闭 回复者的邮箱 即可不显示。能编辑表单的人都能 看到这段代码。

#表单、付款和工作工具

Typeform、Tally、Jotform、Stripe、Shopify、Notion、Zendesk、Jira 和 HubSpot 各有自己的指南,步骤用的是该服务自己的界面名称。简单来说:

  • Typeform:在表单的 Connect › Webhooks › Add a webhook 中粘贴并保存,然后打开(开关一开始是关闭的,保存后才能使用)。
  • Tally:在表单的 Integrations › Webhooks › Connect 中,粘贴到 Endpoint URL。
  • Jotform:在表单的 Settings › Integrations 中搜索 WebHooks,先粘贴 Webhook URL,然后按 Complete Integration 和 Finish(粘贴网址之前按钮无法使用;不要按 Add New Web Hook)。
  • Stripe(需要 Admin 或 Developer 角色):Developers › Workbench › Webhooks › Create an event destination,勾选指南 列出的事件,选择 Webhook endpoint,粘贴到 Endpoint URL。
  • Shopify(店主或可访问设置的员工):在 Settings › Notifications › Webhooks › Create webhook 中为 Order creation 创建;也可以再为 Order payment、Order cancellation 和 Refund create 各创建一个。
  • Notion(付费方案):数据库的 Automations,操作选 Send webhook;至少勾选标题和 Status。
  • Zendesk(Team 方案或更高,管理员):先创建 webhook,再创建一个触发器,发送指南给出的正文(复制正文 就在那一步里)。
  • Jira(空间管理员):空间的 Space settings › Automation › Create flow,触发器 Work item created,操作 Send web request,正文用指南给出的(复制正文)。可以再为 Work item transitioned 和 Work item commented 各建一个 流程,状态变化和评论会进入工作项的话题。
  • HubSpot(Data Hub Professional 或 Enterprise):基于交易的工作流,操作 Data ops › Send a webhook,选择 Customize request body 并添加指南列出的键;也可以为联系人和工单各建一个。联系人只显示姓名和公司,从不显示邮箱或电话。

表单回答会按原样显示在聊天里,包括电子邮件地址;上传的文件只显示文件名(Google 表单只显示文件数量,这样脚本不需要访问你的 Drive)。付款和订单卡片只显示客户的名字(Shopify 还显示城市), 从不显示邮箱、电话或银行卡。

Stripe、Shopify、Zendesk、Typeform 和 Tally 可以为发送的内容签名。指南中的 可选:提高安全性 用来填入该服务的签名密钥 (或给你一个密钥粘贴到服务里);之后只显示签名过的消息。Trina 给你的密钥(Typeform、Tally、GitHub;Tally 会在 Add a signing secret 下预先填入它自己的密钥,请换成 Trina 的)从第一条用它签名的消息 开始生效:在那之前,没有签名的消息仍会显示,所以在你把它粘贴到服务里之前不会丢失消息。Jira 和 HubSpot 无法签名,Webhook URL 是唯一的钥匙,请妥善保管。

#更多服务

选择器中的 显示更多服务 会打开主要在韩国使用的服务,所有人看到的列表都一样。

  • Toss Payments:开发者中心的 웹훅 › 웹훅 등록하기(Webhooks › Register webhook),粘贴 Webhook URL 并勾选 PAYMENT_STATUS_CHANGED。卡片显示金额、订单名称和付款方式,从不显示卡号、账户或电话。可选:开发者中心的安全密钥 (API 키 › 보안 키)。
  • Channel Talk:Settings › Webhook › Create new webhook,粘贴 Webhook URL 并打开会话和消息通知。新会话显示客户的 名字和第一条消息,之后的消息(以及打开后团队的回复)进入它的话题。团队自己的群聊从不显示。可选:webhook 的令牌。
  • PortOne(V2):결제 연동 › 연동 관리 › 결제알림(Webhook) 관리,webhook 版本选 결제모듈 V2(Payment module V2),粘贴 Webhook URL。PortOne 只发送付款编号和状态,所以卡片不显示金额或姓名。可选:webhook 密钥(웹훅 시크릿 발급)。

#其他应用

要求填写 Slack、Discord 或 JANDI 的 webhook URL 的工具,可以把 Trina 的 Webhook URL 粘贴到那个位置。两者都没有的工具, 可以通过 Zapier 或 Make 连接;指南中的 没有你用的应用? 为两者各举了一个例子。

任何能向 Webhook URL 发送消息的服务(Zapier、Make、Grafana、Uptime Kuma、你自己的脚本)都可以。把 Webhook URL 粘贴到该服务 发送消息的位置,然后发一条测试消息。指南和应用设置里的 发送方法 有可以复制的示例:

{ "text": "备份完成:1,204 个文件", "title": "夜间备份", "url": "https://example.com/report", "thread": "nightly-backup" }
  • text 是消息内容,也是唯一必需的字段(也可以用 content)。
  • title 会成为标题,url 会成为一个链接,thread 相同的消息会归入同一个话题。
  • 也接受 Slack 格式的消息(blocks、attachments)、纯文本和普通表单提交(text=…,字段相同;或 Slack 的 payload 字段)。加上 Idempotency-Key 请求头,重试时只会发布一次。
curl -X POST -H 'Content-Type: application/json' -d '{"text":"Hello from my app"}' <Webhook URL>

其他应用会在自己的颜色上显示名字的首字母,所以一个聊天里有几个其他应用也不会看起来一样。要换成图片,打开它的设置并选择 更换图标:上传图片(PNG、JPEG 或 WebP,会裁成正方形)或 选择表情。移除图标 会恢复首字母。图标会显示在这个应用的所有消息上,包括以前的消息。消息不能更改应用的名字或图标:Slack 的 username、icon_url、icon_emoji 和 Discord 的 avatar_url 等字段会被忽略,所以发到 Webhook URL 的任何内容都不能冒充某个人或另一个应用。

#GitHub

按仓库设置;你需要该仓库的管理员权限(GitHub 文档)。

  • 在仓库中打开 Settings › Webhooks › Add webhook。
  • 把 Webhook URL 粘贴到 Payload URL,并选择 application/json。
  • 选择 Send me everything,然后点 Add webhook。Trina 只显示你在应用设置中打开的内容。
  • 可选,更安全: 在指南中按 复制密钥,粘贴到 Secret。从第一条用它签名的投递起(保存时 GitHub 发送的 ping),Trina 只显示 GitHub 签名过的内容 (验证投递)。

如果什么都没收到,GitHub 中该 webhook 页面上的 Recent Deliveries 会显示发送了什么。

#Sentry

Sentry 把它称为内部集成(Sentry 文档)。你需要是 Sentry 中的所有者或管理者。

Sentry 指南
  • 在 Sentry 中打开 Settings › Developer Settings › Custom Integrations,选择 Create New Integration › Internal Integration。
  • 把 Webhook URL 粘贴到 Webhook URL。
  • 在 Permissions 下把 Issue & Event 设为 Read;在 Webhooks 下勾选 issue。保存。
  • 可选,更安全: 把集成的 Client Secret 粘贴到指南中。之后 Trina 只显示 Sentry 签名过的内容 (Sentry 如何签名)。
  • 可选: 如果也想在告警规则触发时发布,在规则中添加 Send a notification via an integration 操作并选择这个集成, 然后在应用设置中打开 告警触发。

#设置

⋯ › 集成 在 应用 下列出聊天的应用,并有 添加应用。每个应用的页面有:

  • 是谁设置的,以及 连接方法(再次查看步骤)。
  • 状态行:上一条消息、已暂停、正在等待第一条消息,或者在 重新生成 之后、新 URL 收到第一条消息之前显示 正在等待 GitHub 使用新的 Webhook URL(列表中的这一行也会这样显示)。
  • 提醒,每条只有一个操作:上一次为什么没有显示(检查密钥)、已离开的成员知道这个 Webhook URL(重新生成), 以及能签名但还没有设置密钥的服务的 未签名:知道 Webhook URL 的任何人都能发布(提高安全性)。
  • 更换图标(其他应用):用图片或表情代替名字的首字母,或 移除图标。
  • 名称:它的消息显示的名字。
  • 在这个聊天中显示:要发布的更新类型(适用于会发送多种更新的应用)。在服务中从未设置过的可选事件(例如 Shopify 的退款) 会显示 尚未在 Shopify 中设置,并附有通往那一步的链接。
  • 安静发布:一行简短显示,没有未读标记和提醒。
  • 发送方法(其他应用)。
  • Webhook URL:再次 复制,或 重新生成(旧的会立即失效;把新的粘贴到该服务中)。
  • 移除应用:应用不能再发布;它的消息会保留。
应用的设置

#限制

一个应用每天最多发布 500 条消息(Google 表单:500 条回复)。超过后会暂停到午夜(按团队的时区):聊天里会出现一行说明,管理 它的人会在 动态 中(以及手机和浏览器上)收到带有 立即恢复 的通知(每天一次)。一个团队的所有应用每天合计最多发布 5,000 条消息:超过后所有应用都会暂停到午夜, 说明和通知会写 你们团队的应用今天共达到 5,000 条消息,不提供 立即恢复。跳过的表单回复仍在表单的“回复”标签页里。卡片是纯文本:其中的内容不能提及 任何人、不能运行任何东西,也不能隐藏链接。

#当应用无法连接到服务器时

应用要给你的团队发送消息,需要外部连接。托管团队和使用 Trina 中继的服务器都有。只在办公室网络中的服务器没有:聊天的 添加应用 会说明这一点,所有者可以在 管理 › 系统 › 连接 中 开启连接。有自己公网地址并设置了国家或网络限制的服务器, 仍然会接收来自任何地方的应用消息;管理 › 系统 › 连接 中会说明这一点。

Trina AX 是采用 AGPL-3.0-only 许可的自由软件。图标:Lucide(ISC)。 编辑此页