Collection
REST API Actions
6 articles
REST API 操作的驗證設定
摘要 本文說明如何在 Astra 中設定 REST API 動作的驗證。它涵蓋了支援的驗證方法、何時使用每種方法,以及如何正確設定它們,以確保您的 API 要求被接受。 說明 驗證可告知外部系統來自 Astra 的要求是允許的。設定 REST API 動作時,您可以根據 API 的需求選擇其中一種支援的驗證方法。 Astra 目前支援以下驗證選項: - API 金鑰驗證 - 基本驗證 - 無驗證 API 金鑰驗證 這是現代 API 最常用的驗證方法。 使用 API 金鑰驗證時,您會在要求標頭中傳送金鑰或權杖。 您需要提供的項目 - auth_key:HT…
1 min read · Updated Oct 28, 2026
什麼是 REST API 動作?
摘要 REST API 動作可讓您的 Astra AI 代理在發生特定對話事件時,自動將資料傳送至其他系統。本文將說明 REST API 動作是什麼、其簡單的工作原理,以及您可能想使用它的時機。 說明 REST API 動作讓您的 AI 代理能夠在適當的時機將資訊傳送至外部系統,無需任何手動操作。 簡單來說,它能幫助 Astra 與其他工具「對話」,在對話中發生定義好的事件時,安全地將資料傳送給它們。這有助於保持您的系統同步,並省去手動匯出、複製貼上或追蹤的麻煩。 REST 是 Representational State Transfer 的縮寫。RE…
1 min read · Updated Oct 28, 2026
如何設定屬性與 REST Action API 的負載
摘要 本指南說明 REST API 動作屬性在 Astra 中的運作方式,以及如何在 Astra 代理人中使用這些屬性。屬性就像佔位符,用於儲存和傳遞指令與動作之間的資料。 您將了解不同類型的屬性、它們的行為方式,以及在設定 REST API(具象狀態傳輸)動作時如何正確使用它們。 操作說明 什麼是屬性 在 Astra 中,屬性是儲存值的佔位符,讓代理人能夠在執行期間動態使用資料。 例如,像 名字 或 姓氏 這樣的屬性可以儲存客戶詳細資訊,並在回應或動作中重複使用。 重點 - 屬性就像代理人內部的變數 - 可在指令和動作中使用 - 在指令中,屬性主要用於…
1 min read · Updated Oct 28, 2026
提供的事件類型:詳細指南
摘要 本文說明 Wati 中 REST API 動作可用的不同事件類型。您將了解每個事件何時觸發、它可以傳送哪些資料,以及如何正確使用它們 — 特別是在收集意見回饋、表單資料或潛在客戶資訊時。 操作說明 事件式 REST API 動作會在對話中發生特定事件時自動執行。每種類型的事件行為都不同,尤其是在可傳送的資料(參數)方面。 了解這些差異有助於您選擇正確的事件並避免設定問題。 1. 讚/倒讚事件 觸發時機 當使用者點擊聊天介面中的意見回饋按鈕(👍 或 👎)時,就會觸發此事件。 參數行為 - 僅支援靜態(固定)參數 - 無法傳送動態使用者資料 這表示 A…
2 min read · Updated Oct 28, 2026
疑難排解 REST API 操作
摘要 本文旨在協助您解決在使用 Astra 中的 REST API 動作時可能遇到的常見問題。涵蓋範圍包括常見問題,例如遺漏表單參數、潛在客戶資料的限制、驗證錯誤,以及重要的安全性考量,以確保您的整合可靠運作。 說明 表單已提交:參數未傳送 問題 當提交自訂表單時,您的 REST API 會收到空白或遺漏的值。 發生原因 這通常發生在 REST API 設定中使用的預留位置與表單欄位名稱不完全符合時。 比對時是區分大小寫的,並且是根據預留位置的尾碼(最後一個.之後的部分)進行的。 如何解決 請確保預留位置的尾碼與您的表單欄位名稱完全相符。 範例: - 表…
1 min read · Updated Oct 28, 2026
設定 REST API 動作的方法
摘要 本文將引導您完成在 Wati 中設定 REST API 動作的步驟。您將學習如何選擇正確的觸發器、視需要選擇事件類型,以及如何將動作正確新增至您的 AI 代理程式的指示中,使其正常運作。 注意: REST API 動作僅適用於使用 Business 方案的 Astra 客戶。 操作說明 REST API 動作僅在正確設定並新增至 AI 代理程式的指示後才會生效。設定流程包含 3 個主要步驟: - 選擇動作應如何觸發 - 選擇事件類型(若適用) - 將 REST API 動作新增至您的 AI 代理程式的指示中 請依照以下步驟完成設定。 步驟 1:選擇…
1 min read · Updated Oct 28, 2026