管道配置

概述

**管道（Channels）**允許將工作空間的 Agent 連接到外部 IM 平台，使用者可以在 Telegram、WhatsApp、釘釘等社交或企業通訊工具中直接與 Agent 互動。

管道配置在 APP 端的 IMSettings 元件中進行。

---

已實現管道（14+ 平台）

全球 IM

企業協作

社交平台

客服平台

自動化與 CRM

完整管道清單與多模態能力矩陣請參考 管道清單。

---

接入流程

通用步驟

1. 設定憑證：在 IMSettings 中輸入管道要求的 API Key / Token / Webhook URL
2. 連線性檢測：系統自動執行 ConnectivityCheck
3. 檢測結果：

4. 上線：檢測通過後啟用管道

Telegram 配置範例

1. 在 BotFather 建立 Telegram Bot，取得 Bot Token
2. 在 IMSettings 中選擇 Telegram，貼上 Token
3. 系統自動配置 Webhook
4. 連線性檢測通過後即可使用

WhatsApp 配置範例

1. 在 IMSettings 中選擇 WhatsApp
2. 系統產生 QR code（linked-device 模式）
3. 用 WhatsApp 手機端掃碼配對
4. 配對成功後自動重連

---

多模態訊息支援

部分管道支援傳送與接收多模態訊息：

各管道的具體多模態能力差異請參考 管道多模態能力矩陣。

---

對話展示

來自 IM 管道的對話會在 Work 對話清單中顯示對應平台圖示（如 Telegram 圖示、WeChat 圖示），幫助使用者區分訊息來源。

---

---

詳細配置指南

Telegram 配置步驟

1. 在 Telegram 中搜尋 @BotFather，傳送 /newbot
2. 依照提示設定 Bot 名稱，取得一個格式如 123456:ABCdef... 的 Bot Token
3. 開啟 APP → 設定 → 管道 → 選擇 Telegram
4. 將 Bot Token 貼到設定框
5. 點擊 儲存，系統自動配置 Webhook
6. 連線性檢測顯示 pass 後即可使用
7. 在 Telegram 中找到你的 Bot，傳送訊息，Agent 會自動回覆

提示：Telegram Bot 支援群組和私聊兩種模式。將 Bot 加入群組後，可以透過 @BotName 提及來觸發 Agent 回覆。

WhatsApp 配置步驟

1. 開啟 APP → 設定 → 管道 → 選擇 WhatsApp
2. 頁面顯示一個 QR code（linked-device 模式）
3. 開啟 WhatsApp 手機端 → 設定 → 已連結裝置 → 連結裝置
4. 用手機掃描 QR code
5. 配對成功後，系統自動維持連線（斷線自動重連）

注意：WhatsApp 的 linked-device 模式需要手機端 WhatsApp 保持登入狀態。如果手機端登出，連線就會中斷。

DingTalk（釘釘）配置步驟

1. 在釘釘開放平台建立企業內部應用
2. 取得應用的 AppKey 和 AppSecret
3. 配置訊息接收的 Webhook URL（系統會提供）
4. 開啟 APP → 設定 → 管道 → 選擇 DingTalk
5. 填寫 AppKey、AppSecret 和 Webhook 設定
6. 儲存並測試連線

---

管道訊息的注意事項

---

相關文件

• 管道清單與能力矩陣 — 完整管道清單
• Work 對話概述 — 管道訊息在 Work 中的展示