摘要
想在 Wati 上部署您自己的自訂 AI 代理嗎？透過「自攜 AI (BYOA)」功能，您可以將您的 AI 代理直接整合到 Wati 中，作為「AI 操作員」。這讓您的代理能夠與真人操作員一同工作，如同團隊成員一樣接收、回覆和管理客戶對話。
注意：
「BYOA」功能是 Wati 客戶的付費附加元件（每月 100 美元）。
如果您已經在使用 Astra 並想透過 BYOA 與 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 事件：
對話已指派 – 當對話指派給您的 AI 代理時觸發。
已指派訊息已接收 - 當指派給您的 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 中的「自攜 AI (BYOA)」功能是什麼？
「自攜 AI (BYOA)」功能讓您可以將自訂 AI 代理整合到 Wati 中，作為一個 AI 操作員，能夠與真人操作員一同接收、回覆和管理客戶對話。
2. BYOA 功能可以免費使用嗎？
BYOA 功能是作為一項付費附加元件提供，Wati 客戶每月收費 100 美元。
3. 使用 BYOA 和 Astra 有任何套餐要求嗎？
若要使用 BYOA 在 Wati 中連接 Astra，您必須使用 Wati 的 Pro 或 Business 套餐。
4. 在 Wati 的哪裡可以找到 BYOA 功能？
BYOA 功能可在 Wati 的「使用者管理」頁面中找到。
設定與指派
5. 如何在 Wati 中新增和使用自訂 AI 代理？
您可以將您的自訂 AI 代理註冊為 Wati 中的 AI 操作員。註冊後，該代理將獲得一個專屬的存取權杖，用於與 Wati API 互動，並出現在團隊收件匣中，對話可以手動或透過自動化規則指派給它。
6. 可以自動將對話指派給 AI 代理嗎？
可以，您可以在 Wati 中建立自動化規則，將新對話自動指派給 AI 操作員。
訊息處理與 Webhook
7. AI 代理如何接收客戶訊息？
AI 代理透過提供給 Wati 的 webhook URL 接收訊息，該 URL 會針對指派給 AI 代理的對話傳送相關的訊息事件。
8. AI 代理支援哪些 Webhook 事件？
AI 代理支援兩種 webhook 事件：「對話已指派」，在對話指派給代理時觸發；以及「已指派訊息已接收」，在新訊息出現在已指派的對話中時觸發。
9. AI 代理會收到所有對話的事件嗎？
不會，AI 代理只會收到明確指派給它的對話的 webhook 事件。
API 與功能
10. AI 代理如何與客戶互動並管理對話？
AI 代理使用其專屬存取權杖與 Wati 的公開 API 互動，以傳送訊息、擷取聯絡人詳細資訊、更新聯絡人屬性、管理對話狀態、將對話重新指派給真人操作員、使用 /getMessages 端點存取對話記錄，以及使用 /getMedia 端點下載媒體檔案。