摘要
本文將引導您完成在 Wati 中設定 REST API 動作的步驟。您將學習如何選擇正確的觸發器、視需要選擇事件類型，以及如何將動作正確新增至您的 AI 代理程式的指示中，使其正常運作。
操作說明
REST API 動作僅在正確設定並新增至 AI 代理程式的指示後才會生效。設定流程包含 3 個主要步驟：
選擇動作應如何觸發
選擇事件類型（若適用）
將 REST API 動作新增至您的 AI 代理程式的指示中
請依照以下步驟完成設定。
步驟 1：選擇觸發器類型
在建立 REST API 動作時，第一個決定是如何觸發它。
共有 2 種觸發器類型可供選擇：
意圖式觸發器
當您希望動作根據使用者的語句來執行時，即可使用此觸發器。
當 AI 代理程式在對話中偵測到特定的使用者意圖時觸發
適用於傳送資料的動作，例如當使用者要求產品展示或表達興趣時
參數行為：API 設定中可使用動態 placeholders。
觸發模式：目前僅支援 agent_decides。這表示 AI 代理程式會根據對話內容決定何時執行動作。
事件式觸發器
當預定義的事件發生時，此觸發器會自動執行。
無需依賴使用者意圖即可觸發
適用於系統驅動的動作，例如意見回饋或表單提交
步驟 2：選擇事件類型（僅限事件式）
如果您選擇「事件」作為觸發器類型，則必須選擇支援的事件類型之一。
目前，Astra 支援以下事件類型：
收到正面意見回饋（讚）
當使用者點擊「讚」選項時觸發
僅支援靜態參數
收到負面意見回饋（倒讚）
當使用者點擊「倒讚」選項時觸發
僅支援靜態參數
表單已提交
當使用者提交自訂表單時觸發
支援從表單欄位傳遞的動態參數
已捕獲潛在客戶
在對話期間收集潛在客戶資訊時觸發
使用固定的要求主體結構
請選擇最符合您希望 REST API 動作執行時機的事件類型。
步驟 3：將 REST API 動作新增至 AI 代理程式指示
僅建立 REST API 動作本身是不夠的。在將動作新增至 AI 代理程式的指示之前，它將無法運作。
所有 REST API 動作均需
將 REST API 動作新增至您的代理程式的指示設定中
如果動作未包含在指示中，它將永遠不會觸發。
「表單已提交」的額外需求
如果您正在使用「表單已提交」事件類型，則還有一項額外需求：
您也必須將相關的自訂表單新增至代理程式的指示中
必須同時包含 REST API 動作和自訂表單
如果其中一項遺失，REST API 動作將無法正確觸發。
以下是根據事件類型應整合內容的快速概覽：
事件類型 | 需整合的內容 |
讚 / 倒讚 | 僅 REST API 動作 |
表單已提交 | REST API 動作 + 自訂表單 |
已捕獲潛在客戶 | 僅 REST API 動作 |
意圖 | 僅 REST API 動作 |
最終檢查清單
在發佈您的 AI 代理程式之前，請確實：
已選取觸發器類型
已選擇事件類型（如果是事件式的）
REST API 動作已新增至代理程式的指示中
使用「表單已提交」時，已新增自訂表單
一旦完成所有這些步驟，您的 REST API 動作便可在對話中自動執行。