# 即时通讯 (/zh-CN/docs/verdent-manager/core-features/instant-messaging)

> 从 Telegram、Slack 或飞书向 Manager 分配工作



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

## 支持的即时通讯平台 [#支持的即时通讯平台]

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

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

***

## 连接流程 [#连接流程]

连接过程分为两个阶段：

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

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

### 如何进入设置 [#如何进入设置]

<Steps>
  <Step title="打开添加频道">
    在 Manager 的左侧边栏，点击顶部的 &#x2A;*+** 按钮（添加频道）。
  </Step>

  <Step title="选择平台">
    选择你想连接的平台（Telegram、Slack 或飞书）。
  </Step>

  <Step title="按引导步骤操作">
    在侧边面板中完成两个阶段的设置。
  </Step>
</Steps>

***

## Telegram 设置 [#telegram-设置]

### 阶段 1：创建机器人并获取 Token [#阶段-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：消息配对 [#阶段-2消息配对]

<Steps>
  <Step title="发送一条消息">
    在 Telegram 中打开你新建的机器人，发送任意消息（例如 `hello`）。
  </Step>

  <Step title="接收配对码">
    机器人会自动回复一个配对码。
  </Step>

  <Step title="在 Verdent 中确认">
    在 Verdent 面板中输入该配对码并确认。连接随即完成。
  </Step>
</Steps>

***

## Slack 设置 [#slack-设置]

### 阶段 1：创建 Slack App 并获取 Token [#阶段-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：消息配对 [#阶段-2消息配对-1]

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

***

## 飞书设置 [#飞书设置]

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

### 第 1 步：创建自建应用 [#第-1-步创建自建应用]

<Steps>
  <Step title="打开开发者控制台">
    前往[飞书开放平台](https://open.feishu.cn/app)，使用你的飞书账号登录。
  </Step>

  <Step title="创建自建应用">
    点击右上角的 **创建自建应用**。
  </Step>

  <Step title="填写基本信息">
    输入应用名称和描述，然后完成创建。
  </Step>
</Steps>

### 第 2 步：配置权限 [#第-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 [#第-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 步：启用长连接 [#第-4-步启用长连接]

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

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

### 第 5 步：订阅消息事件并发布 [#第-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>