# 即時通訊 (/zh-Hant/docs/verdent-manager/core-features/instant-messaging)

> 從 Telegram、Slack 或 Feishu 指派工作給 Manager



你不需要坐在電腦前才能指派工作給 Manager。透過連接 Telegram、Slack 或 Feishu，你可以隨時隨地使用熟悉的聊天工具向 Manager 傳送訊息。Manager 會將你的訊息轉換為結構化的任務並開始執行——在手機上滑動時捕捉一個想法，稍後回來查看結果即可。

## 支援的即時通訊平台 [#支援的即時通訊平台]

| 平台       | 類型      |
| -------- | ------- |
| Telegram | 個人 Bot  |
| Slack    | 工作區 Bot |
| Feishu   | 企業 Bot  |

每個平台都需要在其開發者控制台中建立一個 Bot，然後在 Verdent 中完成配對。連接完成後，你傳送給 Bot 的任何訊息都會直接轉發給 Manager。

***

## 連接流程 [#連接流程]

連接過程分為兩個階段：

1. **輸入 Token** — 憑證設定
2. **傳送訊息進行配對** — 將 Bot 與 Manager 連結

所有設定都在 Manager 側邊欄的頻道設定頁面中完成。

### 如何進入設定 [#如何進入設定]

<Steps>
  <Step title="開啟新增頻道">
    在 Manager 的左側邊欄中，點擊頂部的 &#x2A;*+** 按鈕（新增頻道）。
  </Step>

  <Step title="選擇平台">
    選擇你想連接的平台（Telegram、Slack 或 Feishu）。
  </Step>

  <Step title="依照引導步驟操作">
    在側邊面板中完成兩個階段的設定。
  </Step>
</Steps>

***

## Telegram 設定 [#telegram-設定]

### 階段一：建立 Bot 並取得 Token [#階段一建立-bot-並取得-token]

<Steps>
  <Step title="向 BotFather 傳送訊息">
    在 Telegram 上找到 [@BotFather](https://t.me/BotFather) 並傳送 `/newbot`。
  </Step>

  <Step title="為你的 bot 命名">
    依照提示提供顯示名稱與使用者名稱。
  </Step>

  <Step title="複製 token">
    建立完成後，BotFather 會回傳一個格式為 `123456:ABC-DEF1234...` 的 token。
  </Step>

  <Step title="貼到 Verdent">
    將 token 貼到 Verdent 設定面板的 **Bot Token** 欄位並確認。
  </Step>
</Steps>

### 階段二：訊息配對 [#階段二訊息配對]

<Steps>
  <Step title="傳送一則訊息">
    在 Telegram 中開啟你新建的 bot，並傳送任意訊息（例如 `hello`）。
  </Step>

  <Step title="接收配對碼">
    bot 會自動回覆一個配對碼。
  </Step>

  <Step title="在 Verdent 中確認">
    在 Verdent 面板中輸入該配對碼並確認。連接即完成。
  </Step>
</Steps>

***

## Slack 設定 [#slack-設定]

### 階段一：建立 Slack App 並取得 Token [#階段一建立-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（UI 中提供複製按鈕）。
  </Step>

  <Step title="選擇工作區">
    選擇 Slack 工作區並建立 app。
  </Step>

  <Step title="複製兩個 token">
    在 app 設定中，找到 **Bot Token**（`xoxb-`）與 **App Token**（`xapp-`），然後將兩者貼到 Verdent 設定面板中。
  </Step>
</Steps>

<Note>
  **App 名稱要求：** 名稱必須少於 80 個字元，且不能包含中文、日文或韓文字元。
</Note>

### 階段二：訊息配對 [#階段二訊息配對-1]

與 Telegram 相同：向 bot 傳送訊息，接收配對碼，然後在 Verdent 中輸入以完成連接。

***

## Feishu 設定 [#feishu-設定]

Feishu 比 Telegram 或 Slack 多出幾個步驟——權限需要另外設定，且事件必須手動訂閱。這並不複雜，但每個步驟都必須正確完成，否則連接會卡住。請依序操作。

### 步驟一：建立自訂應用 [#步驟一建立自訂應用]

<Steps>
  <Step title="開啟開發者控制台">
    前往 [Feishu 開放平台](https://open.feishu.cn/app) 並使用你的 Feishu 帳號登入。
  </Step>

  <Step title="建立自訂應用">
    點擊右上角的 **建立自訂應用**。
  </Step>

  <Step title="填寫基本資訊">
    輸入應用名稱與描述，然後完成建立。
  </Step>
</Steps>

### 步驟二：設定權限 [#步驟二設定權限]

開啟新建的應用，並前往左側選單中的 **權限與範圍**。

Feishu 支援批次匯入權限範圍，因此你不必逐一勾選。在頁面上找到批次匯入／匯出的入口，並完整貼上以下 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": []
  }
}
```

確認匯入後，上述所有權限範圍都應在權限列表中顯示為已選取。

### 步驟三：取得憑證並連接 Verdent [#步驟三取得憑證並連接-verdent]

開啟左側選單中的 **憑證與基礎資訊**：

<Steps>
  <Step title="複製 App ID 與 App Secret">
    複製 **App ID**（格式為 `cli_xxx...`）與 **App Secret**。
  </Step>

  <Step title="貼到 Verdent">
    將兩個值貼到 Verdent 設定面板中對應的欄位。
  </Step>

  <Step title="連接">
    點擊 **連接** 以完成第一階段。
  </Step>
</Steps>

### 步驟四：啟用長連接 [#步驟四啟用長連接]

連接後，回到 Feishu 開放平台並開啟 **事件與回呼**。

開啟 **使用長連接接收事件**。這個開關控制 Feishu 如何將訊息傳送給 bot——長連接不需要你公開一個公開 URL，而是維持一條持久連接，這樣更為可靠。

### 步驟五：訂閱訊息事件並發布 [#步驟五訂閱訊息事件並發布]

仍在 **事件與回呼** 頁面：

<Steps>
  <Step title="新增訊息事件">
    點擊 **新增事件**，然後搜尋並新增 `im.message.receive_v1`（接收訊息事件）。
  </Step>

  <Step title="建立並發布版本">
    點擊右上角的 **建立並發布版本**，填寫版本說明，然後確認。
  </Step>

  <Step title="與 Verdent 配對">
    發布後，回到 Verdent 並向你的 Feishu bot 傳送訊息以完成配對。
  </Step>
</Steps>

### 各項權限的作用 [#各項權限的作用]

| 權限                                                  | 用途                                               |
| --------------------------------------------------- | ------------------------------------------------ |
| `im:message:*` 系列                                   | 讓 bot 能讀取與傳送訊息，包括私訊與群組 @ 提及                      |
| `im:chat:*`                                         | 讀取 bot 所屬的對話列表                                   |
| `im:resource`                                       | 讀取訊息中附帶的圖片、檔案及其他資源                               |
| `contact:*`                                         | 讀取基本聯絡人資訊以辨識訊息發送者                                |
| `docs:document.content:read` / `wiki:wiki:readonly` | 讀取 Feishu Docs 與 Wiki 內容，以便將文件連結作為上下文傳遞給 Manager |
| `application:application:self_manage`               | 管理應用本身的設定；長連接功能所需                                |

***

## 連接成功後 [#連接成功後]

配對完成後，該頻道會出現在 Manager 的左側邊欄頻道列表中，並顯示：

* 平台圖示與頻道名稱
* 連接狀態（**Connected** / **Disconnected** / **Needs attention**）
* 最新訊息的預覽與時間戳記
* 未讀訊息指示（綠點）

從此之後，傳送給 Bot 的每則訊息都會由 Manager 直接作為可執行任務處理。

***

## 管理已連接的頻道 [#管理已連接的頻道]

* **檢視所有頻道** — 所有已連接的 IM 頻道都會列在側邊欄中。
* **刪除頻道** — 將滑鼠移至某個頻道上並點擊刪除，然後確認。如果這是該類型的最後一個頻道，bot 設定也會一併清除。
* **重新連接** — 如果某個頻道顯示 **Disconnected** 或 **Needs attention**，頂部會出現修復提示，供你重新設定。

***

## 使用情境 [#使用情境]

<CardGroup cols="3">
  <Card title="行動指揮中心" icon="mobile">
    在外出途中，於 Telegram 中告訴 bot：「將 main 分支的最新變更部署到 staging。」當你回來時，結果已經準備好了。
  </Card>

  <Card title="團隊協作" icon="users">
    在 Slack 頻道中提及你的 Manager bot，以彙整今天的 PR 狀態——回覆會直接出現在頻道中，讓整個團隊都能看見。
  </Card>

  <Card title="快速捕捉想法" icon="lightbulb">
    睡前向 bot 傳送一個想法，並請 Manager 將其轉換為明天要執行的任務。
  </Card>
</CardGroup>