即時通訊
從 Telegram、Slack 或 Feishu 指派工作給 Manager
你不需要坐在電腦前才能指派工作給 Manager。透過連接 Telegram、Slack 或 Feishu,你可以隨時隨地使用熟悉的聊天工具向 Manager 傳送訊息。Manager 會將你的訊息轉換為結構化的任務並開始執行——在手機上滑動時捕捉一個想法,稍後回來查看結果即可。
支援的即時通訊平台
| 平台 | 類型 |
|---|---|
| Telegram | 個人 Bot |
| Slack | 工作區 Bot |
| Feishu | 企業 Bot |
每個平台都需要在其開發者控制台中建立一個 Bot,然後在 Verdent 中完成配對。連接完成後,你傳送給 Bot 的任何訊息都會直接轉發給 Manager。
連接流程
連接過程分為兩個階段:
- 輸入 Token — 憑證設定
- 傳送訊息進行配對 — 將 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 Token(xoxb-)與 App Token(xapp-),然後將兩者貼到 Verdent 設定面板中。
App 名稱要求: 名稱必須少於 80 個字元,且不能包含中文、日文或韓文字元。
階段二:訊息配對
與 Telegram 相同:向 bot 傳送訊息,接收配對碼,然後在 Verdent 中輸入以完成連接。
Feishu 設定
Feishu 比 Telegram 或 Slack 多出幾個步驟——權限需要另外設定,且事件必須手動訂閱。這並不複雜,但每個步驟都必須正確完成,否則連接會卡住。請依序操作。
步驟一:建立自訂應用
步驟二:設定權限
開啟新建的應用,並前往左側選單中的 權限與範圍。
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 設定也會一併清除。
- 重新連接 — 如果某個頻道顯示 Disconnected 或 Needs attention,頂部會出現修復提示,供你重新設定。
使用情境
行動指揮中心
在外出途中,於 Telegram 中告訴 bot:「將 main 分支的最新變更部署到 staging。」當你回來時,結果已經準備好了。
團隊協作
在 Slack 頻道中提及你的 Manager bot,以彙整今天的 PR 狀態——回覆會直接出現在頻道中,讓整個團隊都能看見。
快速捕捉想法
睡前向 bot 傳送一個想法,並請 Manager 將其轉換為明天要執行的任務。