摘要

本文說明 Wati 中 REST API 動作可用的不同事件類型。您將了解每個事件何時觸發、它可以傳送哪些資料，以及如何正確使用它們 — 特別是在收集意見回饋、表單資料或潛在客戶資訊時。

操作說明

事件式 REST API 動作會在對話中發生特定事件時自動執行。每種類型的事件行為都不同，尤其是在可傳送的資料（參數）方面。

了解這些差異有助於您選擇正確的事件並避免設定問題。

1. 讚／倒讚事件

觸發時機

當使用者點擊聊天介面中的意見回饋按鈕（👍 或 👎）時，就會觸發此事件。

參數行為

僅支援靜態（固定）參數
無法傳送動態使用者資料

這表示 API 要求中的所有值都必須預先定義。

常見用途

追蹤使用者滿意度指標
收到負面意見回饋時傳送 Slack 通知
將意見回饋事件記錄到分析平台

⚠️ 重要：讚／倒讚事件無法自行傳送動態使用者資訊，例如電子郵件地址、姓名或對話內容。

結合讚／倒讚與意見回饋表單

如果您需要詳細的意見回饋或使用者資訊，您可以將此事件與表單已提交事件結合。

運作方式

建立意見回饋類型的自訂表單
當使用者點擊 👍 或 👎 時，意見回饋表單會自動顯示
使用者填寫表單（例如，意見回饋原因或電子郵件）
兩個事件可以同時觸發：
- 讚／倒讚事件 → 傳送靜態資料
- 表單已提交事件 → 傳送動態表單資料

範例情況

💡 提示：若要收集電子郵件、原因或留言，請務必使用自訂表單，並為表單已提交事件建立個別的 REST API 動作。

2. 表單已提交事件

觸發時機

當使用者在聊天介面中完成並提交自訂表單時，就會觸發此事件。

參數行為

支援來自表單欄位的動態參數
表單欄位名稱必須與 REST API 設定中使用的預留位置完全相符

如何設定

步驟 1：建立自訂表單

建立一個具有明確定義欄位名稱的自訂表單。

範例：

表單欄位名稱	欄位類型	說明
`email`	電子郵件	使用者的電子郵件地址
`first_name`	文字	使用者的名字
`company`	文字	公司名稱
`message`	文字	使用者留言

步驟 2：設定 REST API 動作

在 API 要求中使用預留位置，其中後綴與表單欄位名稱相符。

預留位置可以包含前綴，例如 contact.、agent. 或 action.，但比對僅基於後綴（最後一個 . 後面的部分）。

範例：

表單欄位 email → {{email}} 或 {{contact.email}}
表單欄位 first_name → {{first_name}} 或 {{contact.first_name}}
表單欄位 company → {{company}} 或 {{contact.company}}

參數比對規則

表單欄位	預留位置	比對	原因
`email`	`{{email}}`	✅ 是	直接比對
`email`	`{{contact.email}}`	✅ 是	後綴 `email` 相符
`first_name`	`{{contact.first_name}}`	✅ 是	後綴 `first_name` 相符
`first_name`	`{{agent.first_name}}`	✅ 是	後綴 `first_name` 相符
`firstName`	`{{contact.first_name}}`	❌ 否	後綴不符（區分大小寫）
`user_email`	`{{contact.email}}`	❌ 否	後綴不符 ( `user_email` ≠ `email`)

⚠️ 重要：預留位置的後綴必須與表單欄位名稱完全相符（包括大小寫）。前綴不會影響比對。

流程範例

3. 潛在客戶已捕獲事件

觸發時機

如果 AI 代理在聊天過程中收集了潛在客戶資訊，此事件將在對話結束 10 分鐘後自動觸發。

參數行為

使用固定要求主體結構
您無法自訂或修改傳送的欄位

固定要求主體結構

當此事件運行時，Wati 會自動傳送以下載荷：

{
  "agent_id": "agent_id",
  "data": {
    "conversation_id": "conversation_id",
    "details": "Lead details",
    "email": "[email protected]",
    "first_name": "John",
    "last_name": "Doe",
    "lead_level": "Hot",
    "lead_score": 100,
    "lead_summary": "Lead summary",
    "max_score": 100
  },
  "event": "lead_captured"
}

欄位說明

欄位	說明
`agent_id`	AI 代理的 ID
`conversation_id`	獨特的對話識別碼
`details`	收集到的潛在客戶資訊
`email`	使用者的電子郵件（如果可用）
`first_name`	使用者的名字
`last_name`	使用者的姓氏
`lead_level`	潛在客戶品質（熱絡、溫暖、冷淡）
`lead_score`	數值潛在客戶分數
`lead_summary`	AI 生成的潛在客戶摘要
`max_score`	最高可能分數

注意：您無需為潛在客戶已捕獲事件定義 request_body。任何自訂要求主體設定都會被忽略。

常見用途

自動在 Salesforce 或 HubSpot 中建立潛在客戶
將潛在客戶資料傳送至行銷自動化工具
在您的 CRM 中觸發後續工作流程

快速參考：事件類型比較

功能	讚／倒讚	表單已提交	潛在客戶已捕獲
動態參數	❌ 否	✅ 是	❌ 固定結構
自訂要求主體	✅ 是（僅限靜態）	✅ 是	❌ 否
需要表單設定	❌ 否	✅ 是	❌ 否
觸發時機	即時	即時	聊天結束後 10 分鐘
需要使用者動作	點擊意見回饋	提交表單	無（自動）

選擇正確的事件類型

使用讚／倒讚進行簡單的意見回饋追蹤
當您需要動態使用者輸入時，使用表單已提交
針對對話後的自動潛在客戶轉移，使用潛在客戶已捕獲

選擇正確的事件可確保您的 REST API 動作可靠運行並傳送您預期的資料。

如何設定屬性與 REST Action API 的負載

提供的事件類型：詳細指南

摘要

操作說明

1. 讚／倒讚事件

觸發時機

參數行為

常見用途

結合讚／倒讚與意見回饋表單

運作方式

範例情況

2. 表單已提交事件

觸發時機

參數行為

如何設定

步驟 1：建立自訂表單

步驟 2：設定 REST API 動作

流程範例

3. 潛在客戶已捕獲事件

觸發時機

參數行為

固定要求主體結構

欄位說明

常見用途

快速參考：事件類型比較

選擇正確的事件類型