> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/conversations/team-plus.md).

# 串接對話平台：Team+

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

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

## 串接前確認 <a href="#pre-integration-checklist" id="pre-integration-checklist"></a>

* 已在 [MaiAgent 平台](https://admin.maiagent.ai/)上建立好一個「AI 助理」
* 擁有 Team+ 服務頻道的管理權限（可進入該頻道的「功能設定」）
* 已向 Team+ 廠商窗口確認貴單位使用的是測試環境或正式環境

{% hint style="warning" %}
**憑證在建立通道後無法修改。** 請先取得三組憑證再進行步驟二。
{% endhint %}

***

## 步驟一：在 Team+ 後台啟用 API 並取得憑證 <a href="#step-enable-api-in-teamplus" id="step-enable-api-in-teamplus"></a>

登入 Team+ 後台，依序進入 <mark style="color:blue;">服務頻道</mark> → 選擇您管理的頻道 → <mark style="color:blue;">功能設定</mark> → <mark style="color:blue;">API 設定</mark>，並**啟用 API**。

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

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

{% hint style="info" %}
Webhook 欄位這一步先跳過。它需要 MaiAgent 產生的 Webhook URL，我們會在**步驟三**回來填。
{% endhint %}

***

## 步驟二：在 MaiAgent 建立 Team+ 對話平台 <a href="#step-create-channel-in-maiagent" id="step-create-channel-in-maiagent"></a>

### 1. 進入串接對話平台 <a href="#step-go-to-channel-integration" id="step-go-to-channel-integration"></a>

在 MaiAgent 左側選單點選 <mark style="color:blue;">對話平台</mark>，點擊右上角 <mark style="color:blue;">串接對話平台</mark>，選擇 <mark style="color:blue;">Team+</mark>。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-9557e30aa762671728de3ff2fa7aa9c167365a68%2Fteamplus-choose-channel.png?alt=media" alt="選擇串接平台頁面中的 Team+"><figcaption><p>在平台清單中選擇 Team+</p></figcaption></figure>

### 2. 填寫基本設定 <a href="#step-fill-basic-settings" id="step-fill-basic-settings"></a>

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

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-1e29c7657eb7312df002c39f446d3f50672a2e45%2Fteamplus-create-form.png?alt=media" alt="MaiAgent 的 Team+ 建立表單，包含三組憑證、服務網址與略過憑證安全檢查選項"><figcaption><p>Team+ 建立表單（圖中為範例值）</p></figcaption></figure>

### 3. 什麼時候需要填「Team+ 服務網址」 <a href="#when-to-set-api-base-url" id="when-to-set-api-base-url"></a>

* **留空** — 使用測試環境。一般測試情境維持留空即可。
* **填入網址** — 貴單位使用的是正式環境，或 Team+ 部署在自有伺服器上。網址請向 Team+ 廠商窗口索取，需為 `http://` 或 `https://` 開頭的完整網址。

### 4. 略過憑證安全檢查 <a href="#trust-insecure-tls" id="trust-insecure-tls"></a>

**填入「Team+ 服務網址」之後**，表單才會出現 <mark style="color:blue;">略過憑證安全檢查</mark> 這個選項。

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

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

### 5. 啟用重置命令 <a href="#enable-reset-command" id="enable-reset-command"></a>

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

### 6. 功能設定頁籤 <a href="#feature-settings-tab" id="feature-settings-tab"></a>

切換到 <mark style="color:blue;">功能設定</mark> 頁籤，可調整 AI 助理在此對話平台的行為：

這個分頁的開關（<mark style="color:blue;">啟用 OCR</mark>、<mark style="color:blue;">使用系統時間回答</mark>、<mark style="color:blue;">使用傳送者名稱回答</mark>）與其他對話平台共用，各開關的說明與時區規則請見[功能設定](/conversations/platform-settings/function-settings.md)。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-7c97c0209ae6644fd58d46bbe7d4e1ffe192c706%2Fteamplus-feature-settings.png?alt=media" alt="Team+ 的功能設定頁籤，包含啟用 OCR 與 AI 感知設定"><figcaption><p>功能設定頁籤</p></figcaption></figure>

### 7. 串接測試 <a href="#step-validate-credentials" id="step-validate-credentials"></a>

點擊 <mark style="color:blue;">串接測試</mark>，MaiAgent 會實際呼叫一次 Team+ API 確認憑證正確。

若顯示<mark style="color:red;">憑證驗證失敗</mark>，請依序檢查：

* 頻道編號與 Channel Secret 是否來自同一個服務頻道
* Team+ 後台的 API 是否已啟用
* 若已填入服務網址，該網址是否可從外部連線；若是憑證問題，參考上方「略過憑證安全檢查」

### 8. 建立並複製 Webhook URL <a href="#step-save-and-get-webhook-url" id="step-save-and-get-webhook-url"></a>

點擊 <mark style="color:blue;">串接對話平台</mark> 完成建立。系統會產生一組 **Webhook URL**，請複製備用。

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

***

## 步驟三：回到 Team+ 後台填入 Webhook URL <a href="#step-configure-webhook" id="step-configure-webhook"></a>

回到步驟一的 <mark style="color:blue;">API 設定</mark> 頁面，將 MaiAgent 產生的 **Webhook URL** 填入 <mark style="color:blue;">Webhook</mark> 欄位並儲存。

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

***

## 開始使用 <a href="#getting-started" id="getting-started"></a>

### 支援的訊息型別 <a href="#supported-message-types" id="supported-message-types"></a>

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

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

***

## 常見問題 <a href="#faq" id="faq"></a>

### 為什麼 AI 助理在多人聊天室沒有反應？ <a href="#no-group-support" id="no-group-support"></a>

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

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

### 為什麼憑證不能修改？ <a href="#why-credentials-are-immutable" id="why-credentials-are-immutable"></a>

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

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

### AI 助理突然不回覆了 <a href="#troubleshoot-no-reply" id="troubleshoot-no-reply"></a>

依序確認：

* Team+ 後台的 API 是否仍為啟用狀態
* Webhook 欄位的 URL 是否還在（後台改設定時可能被清空）
* Channel Access Token 是否已在 Team+ 後台重新產生——若是，舊的權杖會失效，需刪除此通道並以新憑證重建
* 若使用自有伺服器，伺服器是否仍可從外部連線

### 測試環境與正式環境可以並存嗎？ <a href="#test-and-production" id="test-and-production"></a>

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/conversations/team-plus.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.