摘要
想要在 Wati 上部署您自己的自訂 AI 代理嗎？透過 Connect AI Agents 功能，您可以將 AI 代理直接整合到 Wati 作為自訂 AI 代理 (custom AI agent)。這使得您的代理可以與真人客服並肩工作——像團隊成員一樣接收、回覆及管理客戶對話。
注意：
Connect AI Agents 功能是 Wati 客戶的付費附加元件（每月 100 美元）。
如果您已經在使用 Astra 並希望透過 Connect AI Agents 將其與 Wati 連接，則無需購買此附加元件。您只需要訂閱 Wati 的 Pro 或 Business 方案即可啟用此整合。
提示：您可以在 Wati 的設定 (Settings) > 使用者管理 (User Management) 頁面中找到它！
說明
請按照本指南了解您的 AI 代理如何發送和接收訊息、管理聊天上下文，以及透過 API 與 Wati 進行互動。
將您的 AI 代理添加到 Wati
您可以在 Wati 中將您的 AI 代理註冊為自訂 AI 代理 (Custom AI Agent)。一旦添加，您的代理將獲得一個專屬的存取權杖 (access token)，使其能夠與 Wati 的公開 API 互動，例如發送訊息、更新聯絡人或解決聊天問題。
您的自訂 AI 代理將出現在團隊收件匣操作員列表 (Team inbox operator list) 中，您可以手動或透過 Wati 自動化 (Wati automations) 將對話分配給它。
例如，您可以建立一條自動化規則，將所有新聊天自動分配給您的自訂 AI 代理。
您的 AI 代理如何接收客戶訊息
若要接收訊息，請向 Wati 提供一個 Webhook URL。Wati 將透過此 Webhook 將相關訊息事件推送給您的 AI 代理。
您的 AI 代理不會被不必要的數據淹沒——Wati 僅發送專門分配給您的 AI 代理的對話事件。由真人操作員處理的對話不會為您的代理觸發 Webhook 事件。
支援的 Webhook 事件
目前，您的 AI 代理可以接收 2 種類型的 Webhook 事件：
Chat Assigned（聊天已分配） – 當聊天分配給您的 AI 代理時觸發。
Assigned Message Received（已分配訊息接收） – 當分配給您的 AI 代理的對話中有新的傳入訊息時觸發。
您的 AI 代理如何回應客戶
一旦您的代理註冊完成，將會產生一個專屬存取權杖。您可以將此專屬存取權杖與 Wati 的公開 API 結合使用，以發送訊息、更新聯絡人資訊或管理聊天狀態。
您可以在 Wati API 文件中找到完整的 API 列表。
以下是入門最常用的端點：
/sendSessionMessage向客戶發送訊息回應。
/getContacts當對話分配給您的 AI 代理時，檢索聯絡人詳細資訊（例如電話號碼和自訂屬性）。
/updateContactAttributes將對話過程中收集的新資訊儲存為 Wati 中的聯絡人屬性。
/updateChatStatus一旦您的 AI 代理解決了對話，即可更新聊天狀態。
/assignOperator如果您的 AI 代理無法處理，請將聊天重新分配給真人操作員。
存取對話記錄
當您的 AI 代理被分配到某個聊天時，它可以使用 /getMessages API 端點檢索歷史上下文。這有助於您的 AI 根據過去和最近的訊息生成更準確、更具情境的回應。
處理媒體訊息
如果客戶發送了圖片、文件或語音備忘錄，Wati 將在 Webhook 事件中包含一個檔案名稱。您的 AI 代理可以使用 /getMedia API 下載該檔案並進行相應處理。
在哪裡找到您的 Custom AI Agent
設定完成後，您的自訂 AI 代理會出現在團隊收件匣操作員列表中，可以像其他團隊成員一樣被分配聊天。
您也可以使用 Wati 自動化將訊息自動路由到您的自訂 AI 代理。
在聊天機器人中使用您的 AI 代理
連接 AI 代理後，您可以在流程建構器 (flow builder) 中使用 Use an AI Node 下的 Custom AI Agent 節點，將聊天機器人的對話移交給它。
有關設定說明，請參閱如何將 AI 代理連接到 Wati 中的聊天機器人流程。
常見問題 (FAQs)
概覽
1. 什麼是 Wati 中的 Connect AI Agents 功能？
Connect AI Agents 功能允許您將自己的自訂 AI 代理整合到 Wati 中。AI 代理可以透過在 Wati 內接收、回應和管理客戶對話，與真人操作員並肩工作。
2. Wati 方案是否包含 Connect AI Agents 功能？
不包含。Connect AI Agents 功能是作為付費附加元件提供的，每月費用為 100 美元。但是，如果您已經在使用 Astra，則不需要此附加元件。您只需訂閱 Wati 的 Pro 或 Business 方案，即可透過 Connect AI Agents 將 Astra 與 Wati 連接。
3. 如何在 Wati 中添加和分配自訂 AI 代理？
您可以在 Wati 的設定 > 使用者管理下將您的 AI 代理註冊為自訂 AI 代理。設定完成後，AI 代理會出現在團隊收件匣操作員列表中，並可手動或透過 Wati 自動化進行對話分配。
接收客戶訊息
4. 自訂 AI 代理如何接收客戶訊息？
要接收客戶訊息，您必須向 Wati 提供 Webhook URL。Wati 會透過 Webhook 將相關的訊息事件發送到 AI 代理。
5. 哪些對話會為自訂 AI 代理觸發 Webhook 事件？
Wati 僅發送分配給自訂 AI 代理的對話中的 Webhook 事件。由真人操作員處理的對話不會為 AI 代理觸發 Webhook 事件。
6. 自訂 AI 代理支援哪些 Webhook 事件？
自訂 AI 代理目前可以接收兩個 Webhook 事件：
Chat Assigned（聊天已分配） – 當聊天分配給 AI 代理時觸發。
Assigned Message Received（已分配訊息接收） – 當分配給 AI 代理的對話中有新的傳入訊息時觸發。
回應客戶和管理對話
7. 自訂 AI 代理可以使用 Wati API 做什麼？
自訂 AI 代理可以使用其專屬存取權杖與 Wati 的公開 API 互動。它可以發送訊息、檢索聯絡人資訊、更新聯絡人屬性、更新聊天狀態、將對話重新分配給真人操作員、存取對話記錄以及下載客戶發送的媒體檔案。
8. 自訂 AI 代理如何存取對話記錄？
當自訂 AI 代理被分配到某個聊天時，它可以使用 /getMessages API 端點來檢索歷史對話上下文。這有助於 AI 代理生成更準確且符合情境的回應。
9. 自訂 AI 代理如何處理客戶發送的媒體檔案？
當客戶發送圖片、文件或語音備忘錄時，Wati 會在 Webhook 事件中包含檔案名稱。自訂 AI 代理隨後可以使用 /getMedia API 端點來下載並處理該媒體檔案。