即时通讯
从 Telegram、Slack 或飞书向 Manager 分配工作
你不必坐在电脑前才能向 Manager 分配工作。通过连接 Telegram、Slack 或飞书，你可以随时随地用熟悉的聊天工具向 Manager 发送消息。Manager 会把你的消息转化为结构化的任务并开始执行——在手机上刷屏时随手记下一个想法，稍后回来就能看到结果。
支持的即时通讯平台
| 平台 | 类型 |
|---|---|
| Telegram | 个人机器人 |
| Slack | 工作区机器人 |
| 飞书 | 企业机器人 |
每个平台都需要在其开发者控制台创建一个机器人（Bot），然后在 Verdent 中完成配对。连接成功后，你发送给机器人的任何消息都会被直接转发给 Manager。
连接流程
连接过程分为两个阶段：
- 输入 Token — 凭证设置
- 发送消息进行配对 — 将机器人与 Manager 关联
所有配置都在 Manager 侧边栏的频道设置页面中完成。
如何进入设置
打开添加频道
在 Manager 的左侧边栏，点击顶部的 + 按钮（添加频道）。
选择平台
选择你想连接的平台（Telegram、Slack 或飞书）。
按引导步骤操作
在侧边面板中完成两个阶段的设置。
Telegram 设置
阶段 1：创建机器人并获取 Token
向 BotFather 发送消息
在 Telegram 上找到 @BotFather，发送 /newbot。
为机器人命名
按提示填写显示名称和用户名。
复制 Token
创建完成后，BotFather 会返回一个形如 123456:ABC-DEF1234... 的 Token。
粘贴到 Verdent
将 Token 粘贴到 Verdent 设置面板的 Bot Token 字段并确认。
阶段 2：消息配对
发送一条消息
在 Telegram 中打开你新建的机器人，发送任意消息（例如 hello）。
接收配对码
机器人会自动回复一个配对码。
在 Verdent 中确认
在 Verdent 面板中输入该配对码并确认。连接随即完成。
Slack 设置
阶段 1：创建 Slack App 并获取 Token
创建新 App
前往 api.slack.com/apps，点击 Create New App。
使用提供的 manifest
选择 From an app manifest，粘贴 Verdent 提供的 JSON manifest（界面中提供了复制按钮）。
选择工作区
选择 Slack 工作区并创建 App。
复制两个 Token
在 App 设置中找到 Bot Token（xoxb-）和 App Token（xapp-），然后将两者都粘贴到 Verdent 设置面板中。
App 名称要求： 名称必须少于 80 个字符，且不能包含中文、日文或韩文字符。
阶段 2：消息配对
与 Telegram 相同：向机器人发送一条消息，接收配对码，然后在 Verdent 中输入以完成连接。
飞书设置
飞书比 Telegram 或 Slack 多几个步骤——权限需要单独配置，事件也必须手动订阅。这并不复杂，但每一步都必须正确完成，否则连接会卡住。请按顺序操作。
第 1 步：创建自建应用
第 2 步：配置权限
打开新建的应用，进入左侧菜单的 权限管理。
飞书支持批量导入权限范围，因此你不必逐项勾选。在页面上找到批量导入/导出入口，完整粘贴以下 JSON：
{
"scopes": {
"tenant": [
"im:message:send_as_bot",
"im:message",
"im:resource",
"im:chat",
"im:chat:readonly",
"im:message.p2p_msg:readonly",
"im:message.group_at_msg:readonly",
"contact:contact.base:readonly",
"contact:user.base:readonly",
"contact:user.employee_id:readonly",
"docs:document.content:read",
"wiki:wiki:readonly",
"application:application:self_manage"
],
"user": []
}
}确认导入后，上述所有权限范围都应在权限列表中显示为已选中。
第 3 步：获取凭证并连接 Verdent
打开左侧菜单的 凭证与基础信息：
复制 App ID 和 App Secret
复制 App ID（形如 cli_xxx...）和 App Secret。
粘贴到 Verdent
将这两个值粘贴到 Verdent 设置面板中对应的字段。
连接
点击 连接 以完成第一阶段。
第 4 步：启用长连接
连接成功后，回到飞书开放平台，打开 事件与回调。
打开 使用长连接接收事件。这个开关控制飞书如何向机器人投递消息——长连接不需要你暴露公网 URL，而是保持一个持久连接，更加可靠。
第 5 步：订阅消息事件并发布
仍在 事件与回调 页面：
添加消息事件
点击 添加事件，然后搜索并添加 im.message.receive_v1（接收消息事件）。
创建并发布版本
点击右上角的 创建并发布版本，填写版本说明并确认。
与 Verdent 配对
发布后，回到 Verdent，向你的飞书机器人发送一条消息以完成配对。
各项权限的作用
| 权限 | 用途 |
|---|---|
im:message:* 系列 | 让机器人读取和发送消息，包括私聊和群组 @ 提及 |
im:chat:* | 读取机器人所属的会话列表 |
im:resource | 读取消息中附带的图片、文件等资源 |
contact:* | 读取基本通讯录信息以识别消息发送者 |
docs:document.content:read / wiki:wiki:readonly | 读取飞书文档和知识库内容，以便将文档链接作为上下文传递给 Manager |
application:application:self_manage | 管理应用自身的配置；长连接能力需要此权限 |
连接成功后
配对成功后，该频道会出现在 Manager 的左侧边栏频道列表中，并显示：
- 平台图标和频道名称
- 连接状态（已连接 / 已断开 / 需要处理）
- 最新消息的预览和时间戳
- 未读消息提示（绿点）
从此以后，发送给机器人的每条消息都会被 Manager 作为可执行任务直接处理。
管理已连接的频道
- 查看所有频道 — 所有已连接的即时通讯频道都列在侧边栏中。
- 删除频道 — 将鼠标悬停在某个频道上并点击删除，然后确认。如果它是该类型的最后一个频道，相应的机器人配置也会被清除。
- 重新连接 — 如果某个频道显示 已断开 或 需要处理，顶部会出现修复提示，供你重新配置。
使用场景
移动指挥中心
在外出途中，在 Telegram 里告诉机器人："把 main 分支上的最新改动部署到 staging。" 等你回来时，结果已经就绪。
团队协作
在 Slack 频道中 @ 你的 Manager 机器人，让它总结今天的 PR 状态——回复会直接出现在频道里，供整个团队查看。
快速记录灵感
睡前把一个想法发给机器人，让 Manager 将它转化为明天要执行的任务。