使用自動旅程的「發送 Webhook」動作，可以配合自動旅程的執行，自動將資料傳送至外部系統。這是供開發者串接外部系統與 Lumo 的功能。
發送 Webhook 可以做什麼
發送 Webhook 是自動旅程的動作之一，能將資料傳送到指定的 URL。
配合加入好友、標籤變更等自動旅程的觸發條件，自動將資料傳送至自家系統或外部服務。當無程式碼工具無法滿足需求、想依照自己的系統打造專屬整合時，這項功能特別實用。
代表性的使用方式如下。
- 在自動旅程執行時，將資料傳送至自家系統
- 連同好友資訊或自動旅程中的值一起傳送
- 將資料傳遞給外部服務，串接後續的處理
Shopify、HubSpot、Klaviyo 等常用的外部服務已提供專用的整合選單。建議先確認這些選單是否能滿足需求。
交給代理處理
自動旅程的設計可以與行銷代理討論，發送 Webhook 也能在這個過程中一併納入。
只要說出想做的事，例如「加入好友時通知我們的系統」，代理就會建立包含必要觸發條件與動作的自動旅程方案，並請求您的核准。確認內容後選擇「執行」即會套用設定，選擇「先不用了」則不會套用。
傳送目標的 URL 等外部系統專屬的資訊，代理無法自行判斷。這些需要您在自動旅程的編輯畫面自行輸入。
自行設定
發送 Webhook 動作可在自動旅程的編輯畫面中新增與設定。
- 在自動旅程的編輯畫面中，新增「發送 Webhook」作為動作
- 選取節點後，右側會開啟側邊欄，請填寫設定項目
設定項目
在側邊欄填寫的主要項目如下。
| 項目 | 說明 |
|---|---|
| Webhook網址 | 資料傳送目標的 URL（必填） |
| HTTP 方法 | 請求的傳送方式，請依用途選擇 |
| 請求內容 | 要傳送的資料內容，建議使用 JSON 格式 |
請求內容也可以從「在編輯器中編輯」開啟專用編輯器進行編輯。以 JSON 格式輸入時，資料會以 Content-Type「application/json」傳送。
在請求內容中插入好友的資訊
在請求內容中，只要寫入以雙大括號括起來的變數，就能將該名好友的資訊、操作內容，以及已同步的屬性值插入並一併傳送。傳送時會替換成每位好友的實際值。
好友與操作的資訊
關於觸發工作流程的基本資訊，可以使用下列變數插入。
{{line.userId}}… 好友的 LINE 使用者 ID{{line.displayName}}… 好友的顯示名稱{{message.text}}… 收到的訊息內容（以「收到訊息」為觸發條件時）{{postback.data}}… Postback 的資料（以「收到 Postback」為觸發條件時）
整合服務的屬性
若已連動 HubSpot、Klaviyo、Shopify 並同步屬性，可指定屬性的內部名稱來插入其值。可插入的，僅限在各服務設定畫面中選為同步對象的屬性。
{{hubspot.屬性的內部名稱}}… HubSpot 已同步的屬性{{klaviyo.屬性的內部名稱}}… Klaviyo 已同步的屬性{{shopify.屬性的內部名稱}}… Shopify 已同步的屬性{{屬性的內部名稱}}… 省略服務名稱的寫法（會依 HubSpot → Klaviyo → Shopify 的順序尋找值）
若該名好友未與該服務連動，或值未設定，變數會被替換為空值。
輸入範例
例如，寫成下列內容時，會在帶入每位好友的 LINE 使用者 ID、收到的訊息與會員等級的狀態下傳送（請將 member_rank 的部分替換成您自己的屬性內部名稱）。
{
"lineUserId": "{{line.userId}}",
"message": "{{message.text}}",
"rank": "{{hubspot.member_rank}}"
}
設定時的注意事項
視傳送目標與傳送內容而定，Webhook 有可能無法正確送達。設定前請確認以下幾點。
- 傳送目標 URL 請指定可從外部連線到達的正確 URL
- 請確認接收端系統是否能接收 Lumo 傳送的資料格式
- 基於安全保護，部分傳送目標可能會被封鎖
整合不順利時，請先重新檢視傳送目標 URL 與傳送內容的格式，並一併確認接收端系統的記錄檔。