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
- 在此处配置Slack机器人:平台机器人它需要机器人令牌和Slack应用的签名密钥。
- 在您的Slack应用中,将频道消息和应用提及发送至Coroid显示的Webhook URL:
https://api.coroid.ai/api/v1/webhooks/slack/events。 - 邀请机器人加入它应读取的每个频道。
- 在“Quality Control”中开启Slack功能Quality Control → 组织默认值 → 工作开始前 → 请求来源只有所有者和管理员才能开启该来源,且需先完成机器人连接。
开启Slack功能后会添加一项自动化规则,用于将匹配的消息归档为请求。该规则列于Factory → 自动化规则,您可在其中修改其过滤条件。关闭Slack功能会暂停该自动化规则,但保留其过滤条件。
该自动化规则的过滤条件决定了哪些消息会被计入请求。它首先匹配包含以下提及内容的消息:@coroid过滤条件也可将自动化规则限定为仅某个频道,或仅限由机器人发送的消息,例如警报消息。
Coroid针对单个频道每分钟最多可处理10条Slack自动化请求。
Telegram
- 在此处添加Telegram机器人:平台机器人Coroid会向Telegram注册其Webhook,并用Webhook密钥对其进行保护。如果您留空该密钥,Coroid会自动生成一个。
- 将机器人添加到群组,或设为频道的管理员。
- 在“Quality Control”中开启Telegram功能Quality Control → 组织默认值 → 工作开始前 → 请求来源其自动化规则列于 Factory → 自动化规则,您可在其中修改其过滤条件。
- 在聊天中,请以该命令开头发起每个请求:
/coroid。
Telegram默认开启隐私模式,该模式允许机器人查看命令而非普通消息。过滤条件也可按聊天ID将自动化规则限定为仅某个聊天。除非过滤条件允许,否则机器人会忽略私信。
任何人都能将您的机器人添加到其他群组并从那里提交请求。为防止这种情况,可将自动化规则限定为仅您的聊天,或通过BotFather命令阻止机器人加入群组:/setjoingroups。
Coroid针对单个聊天每分钟最多可接受10条匹配消息。若自动化规则限定为仅某个项目,则相关请求会归入该项目。
频道桥接
桥接器可将频道与聊天助手会话相连。
通过桥接器与助手对话的功能暂不可用。桥接器不会将消息传递给助手,因此无法启动或引导工作流程。
频道内的更新
Slack是唯一接收更新的聊天平台。任务完成、失败或升级,以及重试或无法解决合并冲突时,Coroid都会将相关消息发布到指定的Slack频道。这些消息会通过与贵组织关联的Slack入站Webhook发送,而非通过Slack机器人传输。目前尚未提供用于关联该Webhook的设置界面。
Discord、Telegram和短信不会接收更新。其他所有通知均会在门户中展示。查看通知。