摘要
想在 Wati 上部署您自己的自訂 AI 代理程式嗎？透過「Connect AI Agents」（連接 AI 代理程式）功能，您可以直接在 Wati 中整合您的 AI 代理程式，作為「自訂 AI 代理程式」。這讓您的代理程式能夠與您的人類操作員協同工作，如同您的團隊成員一樣接收、回應和管理客戶對話。
請注意：
「Connect AI Agents」功能是以付費附加元件的形式提供（每月 100 美元），適用於 Wati 客戶。
如果您已經在使用 Astra 並希望透過「Connect AI Agents」與 Wati 連接，則不需要附加元件。您只需要訂閱 Wati 的 Pro 或 Business 計畫即可啟用此整合。
提示：您可以在 Wati 中的「設定」>「使用者管理」頁面找到它！
說明
遵循本指南，了解您的 AI 代理程式如何透過 API 發送和接收訊息、管理對話內容以及與 Wati 互動。
將您的 AI 代理程式新增至 Wati
您可以將您的 AI 代理程式註冊為 Wati 中的「自訂 AI 代理程式」。新增後，您的代理程式將獲得專用的「存取權杖」，讓它可以與 Wati 的公開 API 互動，例如發送訊息、更新聯絡人或解決對話。
您的自訂 AI 代理程式將出現在「團隊收件匣操作員清單」中，您可以手動或透過「Wati 自動化」將對話指派給它。
例如，您可以建立一個自動化規則，將所有新對話自動指派給您的自訂 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 下載檔案並進行相應處理。
尋找您的「自訂 AI 代理程式」
設定後，您的自訂 AI 代理程式將出現在「團隊收件匣操作員清單」中，就像任何其他團隊成員一樣，可以被指派對話。
您也可以使用「Wati 自動化」將訊息自動路由到您的自訂 AI 代理程式。
常見問題 (FAQ)
總覽
1. Wati 中的 Connect AI Agents 功能是什麼？
Connect AI Agents 功能可讓您將自訂 AI 代理程式整合到 Wati 中。AI 代理程式可以透過在 Wati 中接收、回應和管理客戶對話，與人類操作員協同工作。
2. Connect AI Agents 功能是否包含在 Wati 計畫中？
否。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 端點來下載和處理媒體檔案。