串接對話平台：Team+

Team+ 是企業通訊平台。串接後，員工可以直接在 Team+ 中與 AI 助理對話，不需要另外開啟其他系統。

Team+ 串接目前只支援一對一對話。將 AI 助理加入多人聊天室不會取得回覆，也不會在 MaiAgent 留下對話記錄。若需要群組對話，請改用其他對話平台。

串接前確認

• 已在 MaiAgent 平台上建立好一個「AI 助理」

• 擁有 Team+ 服務頻道的管理權限（可進入該頻道的「功能設定」）

• 已向 Team+ 廠商窗口確認貴單位使用的是測試環境或正式環境

憑證在建立通道後無法修改。 請先取得三組憑證再進行步驟二。

---

步驟一：在 Team+ 後台啟用 API 並取得憑證

登入 Team+ 後台，依序進入 服務頻道 → 選擇您管理的頻道 → 功能設定 → API 設定，並啟用 API。

啟用後在同一頁取得以下三項：

憑證	說明
頻道編號 / Channel ID	此服務頻道的識別碼
Channel Secret	用於驗證 Team+ 送來的訊息確實來自您的頻道
Channel Access Token	MaiAgent 呼叫 Team+ API 送出回覆時使用

Webhook 欄位這一步先跳過。它需要 MaiAgent 產生的 Webhook URL，我們會在步驟三回來填。

---

步驟二：在 MaiAgent 建立 Team+ 對話平台

1. 進入串接對話平台

在 MaiAgent 左側選單點選 對話平台，點擊右上角 串接對話平台，選擇 Team+。

在平台清單中選擇 Team+

2. 填寫基本設定

欄位	說明
名稱	為此串接取一個名稱（必填）。這只是 MaiAgent 這側的標籤。
AI 助理	選擇要綁定的 AI 助理
頻道編號 / Channel ID	步驟一取得（必填）
Channel Secret	步驟一取得（必填）
Channel Access Token	步驟一取得（必填）
Team+ 服務網址（選填）	見下方說明

Team+ 建立表單（圖中為範例值）

3. 什麼時候需要填「Team+ 服務網址」

• 留空 — 使用測試環境。一般測試情境維持留空即可。

• 填入網址 — 貴單位使用的是正式環境，或 Team+ 部署在自有伺服器上。網址請向 Team+ 廠商窗口索取，需為 http:// 或 https:// 開頭的完整網址。

4. 略過憑證安全檢查

填入「Team+ 服務網址」之後，表單才會出現 略過憑證安全檢查 這個選項。

部分機構的伺服器 TLS 憑證設定不完整（例如缺少中介憑證），會讓標準連線驗證失敗、MaiAgent 無法連上 Team+。開啟此選項可跳過驗證讓串接得以運作。

開啟後與 Team+ 伺服器之間的連線安全性會降低，無法確認連線對象確實是您的伺服器。請僅在已向伺服器管理者確認「憑證問題無法修復」時才開啟，並在對方修好憑證後關閉。

5. 啟用重置命令

開啟後可自訂關鍵字，使用者在對話中輸入該關鍵字即可清空對話記憶、重新開始。

6. 功能設定頁籤

切換到 功能設定 頁籤，可調整 AI 助理在此對話平台的行為：

設定	說明
啟用 OCR	開啟後會辨識圖片中的文字，讓 AI 助理讀得到截圖或掃描件裡的內容
使用系統時間回答	開啟後 AI 助理會依設定的時區提供準確的日期與時間資訊
使用傳送者名稱回答	開啟後 AI 助理能識別並使用發話者的名稱，做出個人化回應

功能設定頁籤

7. 串接測試

點擊 串接測試，MaiAgent 會實際呼叫一次 Team+ API 確認憑證正確。

若顯示憑證驗證失敗，請依序檢查：

• 頻道編號與 Channel Secret 是否來自同一個服務頻道

• Team+ 後台的 API 是否已啟用

• 若已填入服務網址，該網址是否可從外部連線；若是憑證問題，參考上方「略過憑證安全檢查」

8. 建立並複製 Webhook URL

點擊 串接對話平台 完成建立。系統會產生一組 Webhook URL，請複製備用。

您也可以隨時回到該通道的設定頁面複製這組 URL。

---

步驟三：回到 Team+ 後台填入 Webhook URL

回到步驟一的 API 設定 頁面，將 MaiAgent 產生的 Webhook URL 填入 Webhook 欄位並儲存。

完成後，員工在 Team+ 中對該服務頻道發話，AI 助理就會自動回覆。

---

開始使用

支援的訊息型別

使用者傳送	AI 助理的處理方式
文字	直接回答
圖片	可辨識圖片內容
檔案（PDF、Excel、Word 等）	讀取內容後回答相關問題
語音訊息	轉為文字後處理
影片	存為附件，記錄在對話中
位置	記錄在對話中

AI 助理回覆時支援文字與附件。單則文字訊息若超過 Team+ 的 4,000 字上限，系統會自動分段送出，不會被截斷。

---

常見問題

為什麼 AI 助理在多人聊天室沒有反應？

Team+ 串接目前只處理一對一對話。多人聊天室的訊息不會觸發回覆，也不會在 MaiAgent 的「所有對話」中出現。

這與 LINE WORKS、Slack、Microsoft Teams 等平台不同——那些平台支援群組，並可設定「只有被 @ 提及時才回覆」。

為什麼憑證不能修改？

憑證屬於敏感資料，MaiAgent 儲存後不會再回傳給前端，設定頁面也不接受修改，以避免憑證在傳輸與畫面上重複曝露。頻道編號會以唯讀方式顯示，方便您核對目前接的是哪一個服務頻道。

需要更換任何一項憑證時，請刪除此通道後重新建立。

AI 助理突然不回覆了

依序確認：

• Team+ 後台的 API 是否仍為啟用狀態

• Webhook 欄位的 URL 是否還在（後台改設定時可能被清空）

• Channel Access Token 是否已在 Team+ 後台重新產生——若是，舊的權杖會失效，需刪除此通道並以新憑證重建

• 若使用自有伺服器，伺服器是否仍可從外部連線

測試環境與正式環境可以並存嗎？

可以。建立兩個 Team+ 對話平台、分別填入各自的憑證與服務網址即可。兩者各有獨立的 Webhook URL，互不影響。