文档

聊天平台

将Slack和Telegram消息转换为请求,并在Slack中获取任务更新。

Coroid 提供针对 Slack、Discord、Telegram 和短信的平台机器人。请在本节中完成相关配置:设置 → 连接 → 频道。

各机器人的当前功能如下:

平台消息会转化为请求接收更新
Slack支持,通过事件自动化实现通过传入的 Webhook 同步任务更新
Telegram支持,通过事件自动化实现不支持
Discord不支持不支持
短信不支持不支持

您可以保存 Discord 或短信机器人,但当前暂无功能调用它们。同一页面还包含频道桥接功能,但目前暂无法使用。详见频道桥接。

平台机器人

该机器人是 Coroid 在对应平台上使用的身份标识。每个工作区或服务器只需安装一次,并授予其读取指定频道的权限。Slack 和 Telegram 需要该机器人,以便事件自动化能够读取消息。

若 Slack 机器人被从频道中移除,Coroid 将无法再读取该频道的消息,且系统不会给出相关提示。如果 Slack 消息不再转化为请求,请检查该机器人是否仍在频道中。

仅拥有者和管理员可添加、修改或删除机器人。各平台会将事件发送至 API 网关上的 Webhook 地址,Coroid 会为每个机器人显示对应的地址。若传递的数据未用机器人密钥签名,Coroid 会拒绝接收。

从频道启动工作

Slack 或 Telegram 消息可转化为工作请求,Discord 和短信消息则无法转化。

消息通过事件自动化转化为请求。这一功能对处理那些原本无法被追踪的“有人能帮忙修一下吗…”类请求尤为实用。

匹配的消息会作为请求被送至 Qualification 环节。Qualification 会对请求进行筛选、查重并确定其最终归属。只有通过审核的请求才会被创建。详见启动工作的方式。

Coroid 不会将 Slack 或 Telegram 账号与 Coroid 账号绑定,因此任何能在对应聊天室发帖的人均可提交请求。正因如此,聊天室中的工作不会自动启动。符合条件的任务会被创建后等待有人启动,计划也会等待审批。

详见触发器与目的地。

Slack

  1. 在此处配置Slack机器人:平台机器人它需要机器人令牌和Slack应用的签名密钥。
  2. 在您的Slack应用中,将频道消息和应用提及发送至Coroid显示的Webhook URL:https://api.coroid.ai/api/v1/webhooks/slack/events。
  3. 邀请机器人加入它应读取的每个频道。
  4. 在“Quality Control”中开启Slack功能Quality Control → 组织默认值 → 工作开始前 → 请求来源只有所有者和管理员才能开启该来源,且需先完成机器人连接。

开启Slack功能后会添加一项自动化规则,用于将匹配的消息归档为请求。该规则列于Factory → 自动化规则,您可在其中修改其过滤条件。关闭Slack功能会暂停该自动化规则,但保留其过滤条件。

该自动化规则的过滤条件决定了哪些消息会被计入请求。它首先匹配包含以下提及内容的消息:@coroid过滤条件也可将自动化规则限定为仅某个频道,或仅限由机器人发送的消息,例如警报消息。

Coroid针对单个频道每分钟最多可处理10条Slack自动化请求。

Telegram

  1. 在此处添加Telegram机器人:平台机器人Coroid会向Telegram注册其Webhook,并用Webhook密钥对其进行保护。如果您留空该密钥,Coroid会自动生成一个。
  2. 将机器人添加到群组,或设为频道的管理员。
  3. 在“Quality Control”中开启Telegram功能Quality Control → 组织默认值 → 工作开始前 → 请求来源其自动化规则列于 Factory → 自动化规则,您可在其中修改其过滤条件。
  4. 在聊天中,请以该命令开头发起每个请求:/coroid。

Telegram默认开启隐私模式,该模式允许机器人查看命令而非普通消息。过滤条件也可按聊天ID将自动化规则限定为仅某个聊天。除非过滤条件允许,否则机器人会忽略私信。

任何人都能将您的机器人添加到其他群组并从那里提交请求。为防止这种情况,可将自动化规则限定为仅您的聊天,或通过BotFather命令阻止机器人加入群组:/setjoingroups。

Coroid针对单个聊天每分钟最多可接受10条匹配消息。若自动化规则限定为仅某个项目,则相关请求会归入该项目。

频道桥接

桥接器可将频道与聊天助手会话相连。

通过桥接器与助手对话的功能暂不可用。桥接器不会将消息传递给助手,因此无法启动或引导工作流程。

频道内的更新

Slack是唯一接收更新的聊天平台。任务完成、失败或升级,以及重试或无法解决合并冲突时,Coroid都会将相关消息发布到指定的Slack频道。这些消息会通过与贵组织关联的Slack入站Webhook发送,而非通过Slack机器人传输。目前尚未提供用于关联该Webhook的设置界面。

Discord、Telegram和短信不会接收更新。其他所有通知均会在门户中展示。查看通知。