---
title: 即时通讯
description: "从 Telegram、Slack 或飞书向 Manager 分配工作"
---

你不必坐在电脑前才能向 Manager 分配工作。通过连接 Telegram、Slack 或飞书，你可以随时随地用熟悉的聊天工具向 Manager 发送消息。Manager 会把你的消息转化为结构化的任务并开始执行——在手机上刷屏时随手记下一个想法，稍后回来就能看到结果。

## 支持的即时通讯平台

| 平台         | 类型          |
|------------------|---------------|
| Telegram         | 个人机器人  |
| Slack            | 工作区机器人 |
| 飞书           | 企业机器人 |

每个平台都需要在其开发者控制台创建一个机器人（Bot），然后在 Verdent 中完成配对。连接成功后，你发送给机器人的任何消息都会被直接转发给 Manager。

---

## 连接流程

连接过程分为两个阶段：

1. **输入 Token** — 凭证设置
2. **发送消息进行配对** — 将机器人与 Manager 关联

所有配置都在 Manager 侧边栏的频道设置页面中完成。

### 如何进入设置

<Steps>
  <Step title="打开添加频道">
    在 Manager 的左侧边栏，点击顶部的 **+** 按钮（添加频道）。
  </Step>
  <Step title="选择平台">
    选择你想连接的平台（Telegram、Slack 或飞书）。
  </Step>
  <Step title="按引导步骤操作">
    在侧边面板中完成两个阶段的设置。
  </Step>
</Steps>

---

## Telegram 设置

### 阶段 1：创建机器人并获取 Token

<Steps>
  <Step title="向 BotFather 发送消息">
    在 Telegram 上找到 [@BotFather](https://t.me/BotFather)，发送 `/newbot`。
  </Step>
  <Step title="为机器人命名">
    按提示填写显示名称和用户名。
  </Step>
  <Step title="复制 Token">
    创建完成后，BotFather 会返回一个形如 `123456:ABC-DEF1234...` 的 Token。
  </Step>
  <Step title="粘贴到 Verdent">
    将 Token 粘贴到 Verdent 设置面板的 **Bot Token** 字段并确认。
  </Step>
</Steps>

### 阶段 2：消息配对

<Steps>
  <Step title="发送一条消息">
    在 Telegram 中打开你新建的机器人，发送任意消息（例如 `hello`）。
  </Step>
  <Step title="接收配对码">
    机器人会自动回复一个配对码。
  </Step>
  <Step title="在 Verdent 中确认">
    在 Verdent 面板中输入该配对码并确认。连接随即完成。
  </Step>
</Steps>

---

## Slack 设置

### 阶段 1：创建 Slack App 并获取 Token

<Steps>
  <Step title="创建新 App">
    前往 [api.slack.com/apps](https://api.slack.com/apps)，点击 **Create New App**。
  </Step>
  <Step title="使用提供的 manifest">
    选择 **From an app manifest**，粘贴 Verdent 提供的 JSON manifest（界面中提供了复制按钮）。
  </Step>
  <Step title="选择工作区">
    选择 Slack 工作区并创建 App。
  </Step>
  <Step title="复制两个 Token">
    在 App 设置中找到 **Bot Token**（`xoxb-`）和 **App Token**（`xapp-`），然后将两者都粘贴到 Verdent 设置面板中。
  </Step>
</Steps>

<Note>
  **App 名称要求：** 名称必须少于 80 个字符，且不能包含中文、日文或韩文字符。
</Note>

### 阶段 2：消息配对

与 Telegram 相同：向机器人发送一条消息，接收配对码，然后在 Verdent 中输入以完成连接。

---

## 飞书设置

飞书比 Telegram 或 Slack 多几个步骤——权限需要单独配置，事件也必须手动订阅。这并不复杂，但每一步都必须正确完成，否则连接会卡住。请按顺序操作。

### 第 1 步：创建自建应用

<Steps>
  <Step title="打开开发者控制台">
    前往[飞书开放平台](https://open.feishu.cn/app)，使用你的飞书账号登录。
  </Step>
  <Step title="创建自建应用">
    点击右上角的 **创建自建应用**。
  </Step>
  <Step title="填写基本信息">
    输入应用名称和描述，然后完成创建。
  </Step>
</Steps>

### 第 2 步：配置权限

打开新建的应用，进入左侧菜单的 **权限管理**。

飞书支持批量导入权限范围，因此你不必逐项勾选。在页面上找到批量导入/导出入口，完整粘贴以下 JSON：

```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

打开左侧菜单的 **凭证与基础信息**：

<Steps>
  <Step title="复制 App ID 和 App Secret">
    复制 **App ID**（形如 `cli_xxx...`）和 **App Secret**。
  </Step>
  <Step title="粘贴到 Verdent">
    将这两个值粘贴到 Verdent 设置面板中对应的字段。
  </Step>
  <Step title="连接">
    点击 **连接** 以完成第一阶段。
  </Step>
</Steps>

### 第 4 步：启用长连接

连接成功后，回到飞书开放平台，打开 **事件与回调**。

打开 **使用长连接接收事件**。这个开关控制飞书如何向机器人投递消息——长连接不需要你暴露公网 URL，而是保持一个持久连接，更加可靠。

### 第 5 步：订阅消息事件并发布

仍在 **事件与回调** 页面：

<Steps>
  <Step title="添加消息事件">
    点击 **添加事件**，然后搜索并添加 `im.message.receive_v1`（接收消息事件）。
  </Step>
  <Step title="创建并发布版本">
    点击右上角的 **创建并发布版本**，填写版本说明并确认。
  </Step>
  <Step title="与 Verdent 配对">
    发布后，回到 Verdent，向你的飞书机器人发送一条消息以完成配对。
  </Step>
</Steps>

### 各项权限的作用

| 权限 | 用途 |
|------------|---------|
| `im:message:*` 系列 | 让机器人读取和发送消息，包括私聊和群组 @ 提及 |
| `im:chat:*` | 读取机器人所属的会话列表 |
| `im:resource` | 读取消息中附带的图片、文件等资源 |
| `contact:*` | 读取基本通讯录信息以识别消息发送者 |
| `docs:document.content:read` / `wiki:wiki:readonly` | 读取飞书文档和知识库内容，以便将文档链接作为上下文传递给 Manager |
| `application:application:self_manage` | 管理应用自身的配置；长连接能力需要此权限 |

---

## 连接成功后

配对成功后，该频道会出现在 Manager 的左侧边栏频道列表中，并显示：

- 平台图标和频道名称
- 连接状态（**已连接** / **已断开** / **需要处理**）
- 最新消息的预览和时间戳
- 未读消息提示（绿点）

从此以后，发送给机器人的每条消息都会被 Manager 作为可执行任务直接处理。

---

## 管理已连接的频道

- **查看所有频道** — 所有已连接的即时通讯频道都列在侧边栏中。
- **删除频道** — 将鼠标悬停在某个频道上并点击删除，然后确认。如果它是该类型的最后一个频道，相应的机器人配置也会被清除。
- **重新连接** — 如果某个频道显示 **已断开** 或 **需要处理**，顶部会出现修复提示，供你重新配置。

---

## 使用场景

<CardGroup cols={3}>
  <Card title="移动指挥中心" icon="mobile">
    在外出途中，在 Telegram 里告诉机器人："把 main 分支上的最新改动部署到 staging。" 等你回来时，结果已经就绪。
  </Card>
  <Card title="团队协作" icon="users">
    在 Slack 频道中 @ 你的 Manager 机器人，让它总结今天的 PR 状态——回复会直接出现在频道里，供整个团队查看。
  </Card>
  <Card title="快速记录灵感" icon="lightbulb">
    睡前把一个想法发给机器人，让 Manager 将它转化为明天要执行的任务。
  </Card>
</CardGroup>