摘要
想要在 Wati 上部署自定义 AI 代理嗎？透過 自帶 AI (BYOA) 功能，您可以將您的 AI 代理直接整合到 Wati 作為 AI 操作員。這使您的代理可以與您的人類操作員一起工作 - 接收、回應和管理客戶對話，就像您團隊的一員。
自帶 AI (BYOA) 功能目前處於 Beta 版本，並作為 Wati 商業計劃的 附加功能 提供。一旦退出 Beta 版本，將會收取費用。
您可以在 Wati 的 使用者管理 頁面找到它！
指示
請遵循此指南，了解您的 AI 代理如何透過 API 發送和接收訊息、管理聊天內容，並與 Wati 互動。
將您的自定義 AI 代理添加到 Wati
您可以在 Wati 中將您的 AI 代理註冊為 AI 操作員。添加後，您的代理將收到一個專用的 存取權杖，允許它與 Wati 的公開 API 互動 - 例如發送訊息、更新聯絡人或解決聊天。
您的 AI 操作員將出現在 團隊收件匣操作員列表 中，您可以手動或透過 Wati 自動化 將對話分配給它。
例如，您可以建立一個自動化規則，將所有新聊天自動分配給您的 AI 操作員。
您的 AI 代理如何接收客戶訊息
要接收訊息，請為 Wati 提供一個 網頁鉤子 URL。Wati 將通過此網頁鉤子將相關訊息事件推送到您的 AI 代理。
您的 AI 代理不會被不必要的數據淹沒 - Wati 只會發送分配給您的 AI 代理的對話事件。由人類操作員處理的對話不會觸發您的代理的網頁鉤子事件。
支持的網頁鉤子事件
目前，您的 AI 代理可以接收 2 種類型的網頁鉤子事件：
聊天分配 - 當聊天分配給您的 AI 代理時觸發。
已分配訊息接收 - 當分配給您的 AI 代理的對話中有新的傳入訊息時觸發。
您的 AI 代理如何回應客戶
註冊後，將生成一個專用的存取權杖。您可以使用此 專用存取權杖 及 Wati 的公開 API 發送訊息、更新聯絡人資訊或管理聊天狀態。
您可以在 Wati API 文件 中找到完整的 API 列表。
以下是開始使用的最常用端點：
/sendSessionMessage向客戶發送訊息回應。
/getContacts當對話分配給您的 AI 代理時，檢索聯絡人詳細資訊（例如電話號碼和自定義屬性）。
/updateContactAttributes將在對話中收集的新資訊存儲為 Wati 中的聯絡人屬性。
/updateChatStatus當您的 AI 代理解決對話後，更新聊天狀態。
/assignOperator如果您的 AI 代理無法處理，將聊天重新分配給人類操作員。
訪問對話歷史
當您的 AI 代理被分配到聊天時，它可以使用 /getMessages API 端點檢索 歷史上下文。這有助於您的 AI 根據過去和最近的訊息生成更準確和具上下文的回應。
處理媒體訊息
如果客戶發送圖像、文件或語音留言，Wati 將在網頁鉤子事件中包含一個 檔案名稱。您的 AI 代理可以使用 /getMedia API 下載該檔案並相應處理。
在哪裡找到您的 AI 操作員
設置後，您的 AI 操作員將出現在 團隊收件匣操作員列表 中，可以像其他團隊成員一樣分配聊天。
您也可以使用 Wati 自動化 將訊息自動路由到您的 AI 操作員。
常見問題解答 (FAQs)
一般問題
1. 什麼是自帶 AI (BYOA) 功能？
自帶 AI (BYOA) 功能允許您將自定義 AI 代理整合到 Wati 作為 AI 操作員。添加後，您的 AI 代理可以發送和接收訊息、管理聊天上下文，並透過公開 API 與 Wati 互動。
2. 誰可以訪問 BYOA 功能？
BYOA 功能目前作為 Wati 商業計劃的附加功能提供。它處於 Beta 版本，一旦正式發布將收取費用。
3. 我在 Wati 中如何找到 BYOA 選項？
您可以在 Wati 的 使用者管理 頁面找到自帶 AI 功能。
設置和配置
4. 如何將我的自定義 AI 代理添加到 Wati？
您可以在 Wati 中將您的 AI 代理註冊為 AI 操作員。註冊後，它將收到一個專用的存取權杖，以與 Wati 的公開 API 互動，例如發送訊息、更新聯絡人和管理聊天狀態。
5. 如何將聊天分配給我的 AI 代理？
您的 AI 操作員將出現在 團隊收件匣操作員列表 中。您可以手動分配聊天，或使用 Wati 自動化規則自動分配對話。
訊息和 API 處理
6. 我的 AI 代理如何接收客戶訊息？
Wati 將通過您提供的網頁鉤子 URL 將訊息事件發送到您的 AI 代理。只有分配給您的 AI 代理的對話會觸發網頁鉤子事件 - 人類操作員處理的聊天將被排除。
7. 支持哪些類型的網頁鉤子事件？
您的 AI 代理目前可以接收兩種類型的網頁鉤子事件：
聊天分配 - 當聊天分配給您的 AI 代理時觸發。
已分配訊息接收 - 當分配給您的 AI 代理的對話中有新的傳入訊息時觸發。
8. 我的 AI 代理如何回應客戶並管理對話？
您的 AI 代理可以使用其存取權杖及 Wati 的公開 API 發送訊息 (/sendSessionMessage)、檢索聯絡人 (/getContacts)、更新屬性 (/updateContactAttributes)、解決聊天 (/updateChatStatus)，或將其重新分配給人類操作員 (/assignOperator)。
9. 我的 AI 代理如何處理媒體並訪問聊天歷史？
如果客戶發送文件，Wati 將在網頁鉤子事件中包含一個檔案名稱。您的 AI 代理可以使用 /getMedia API 下載它。對於過去的訊息，它可以使用 /getMessages 訪問聊天歷史並保持上下文。
自動化和團隊管理
10. 我可以自動化聊天路由到我的 AI 操作員嗎？
可以。您可以使用 Wati 的自動化規則將新或特定的聊天自動路由到您的 AI 操作員，就像將聊天分配給任何其他團隊成員一樣。