Verdent Docs
核心功能

即時通訊

從 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 側邊欄的頻道設定頁面中完成。

如何進入設定

開啟新增頻道

在 Manager 的左側邊欄中,點擊頂部的 + 按鈕(新增頻道)。

選擇平台

選擇你想連接的平台(Telegram、Slack 或 Feishu)。

依照引導步驟操作

在側邊面板中完成兩個階段的設定。


Telegram 設定

階段一:建立 Bot 並取得 Token

向 BotFather 傳送訊息

在 Telegram 上找到 @BotFather 並傳送 /newbot

為你的 bot 命名

依照提示提供顯示名稱與使用者名稱。

複製 token

建立完成後,BotFather 會回傳一個格式為 123456:ABC-DEF1234... 的 token。

貼到 Verdent

將 token 貼到 Verdent 設定面板的 Bot Token 欄位並確認。

階段二:訊息配對

傳送一則訊息

在 Telegram 中開啟你新建的 bot,並傳送任意訊息(例如 hello)。

接收配對碼

bot 會自動回覆一個配對碼。

在 Verdent 中確認

在 Verdent 面板中輸入該配對碼並確認。連接即完成。


Slack 設定

階段一:建立 Slack App 並取得 Token

建立新的 app

前往 api.slack.com/apps 並點擊 Create New App

使用提供的 manifest

選擇 From an app manifest,並貼上 Verdent 提供的 JSON manifest(UI 中提供複製按鈕)。

選擇工作區

選擇 Slack 工作區並建立 app。

複製兩個 token

在 app 設定中,找到 Bot Tokenxoxb-)與 App Tokenxapp-),然後將兩者貼到 Verdent 設定面板中。

App 名稱要求: 名稱必須少於 80 個字元,且不能包含中文、日文或韓文字元。

階段二:訊息配對

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


Feishu 設定

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

步驟一:建立自訂應用

開啟開發者控制台

前往 Feishu 開放平台 並使用你的 Feishu 帳號登入。

建立自訂應用

點擊右上角的 建立自訂應用

填寫基本資訊

輸入應用名稱與描述,然後完成建立。

步驟二:設定權限

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

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

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

複製 App ID 與 App Secret

複製 App ID(格式為 cli_xxx...)與 App Secret

貼到 Verdent

將兩個值貼到 Verdent 設定面板中對應的欄位。

連接

點擊 連接 以完成第一階段。

步驟四:啟用長連接

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

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

步驟五:訂閱訊息事件並發布

仍在 事件與回呼 頁面:

新增訊息事件

點擊 新增事件,然後搜尋並新增 im.message.receive_v1(接收訊息事件)。

建立並發布版本

點擊右上角的 建立並發布版本,填寫版本說明,然後確認。

與 Verdent 配對

發布後,回到 Verdent 並向你的 Feishu bot 傳送訊息以完成配對。

各項權限的作用

權限用途
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 設定也會一併清除。
  • 重新連接 — 如果某個頻道顯示 DisconnectedNeeds attention,頂部會出現修復提示,供你重新設定。

使用情境

行動指揮中心

在外出途中,於 Telegram 中告訴 bot:「將 main 分支的最新變更部署到 staging。」當你回來時,結果已經準備好了。

團隊協作

在 Slack 頻道中提及你的 Manager bot,以彙整今天的 PR 狀態——回覆會直接出現在頻道中,讓整個團隊都能看見。

快速捕捉想法

睡前向 bot 傳送一個想法,並請 Manager 將其轉換為明天要執行的任務。