跳至主內容

Webhook 整合總覽

LittleHelp
更新於

使用自動旅程的「發送 Webhook」動作，可以配合自動旅程的執行，自動將資料傳送至外部系統。這是供開發者串接外部系統與 Lumo 的功能。

發送 Webhook 可以做什麼

發送 Webhook 是自動旅程的動作之一，能將資料傳送到指定的 URL。

配合加入好友、標籤變更等自動旅程的觸發條件，自動將資料傳送至自家系統或外部服務。當無程式碼工具無法滿足需求、想依照自己的系統打造專屬整合時，這項功能特別實用。

代表性的使用方式如下。

  • 在自動旅程執行時，將資料傳送至自家系統
  • 連同好友資訊或自動旅程中的值一起傳送
  • 將資料傳遞給外部服務，串接後續的處理

Shopify、HubSpot、Klaviyo 等常用的外部服務已提供專用的整合選單。建議先確認這些選單是否能滿足需求。

交給代理處理

自動旅程的設計可以與行銷代理討論，發送 Webhook 也能在這個過程中一併納入。

只要說出想做的事，例如「加入好友時通知我們的系統」，代理就會建立包含必要觸發條件與動作的自動旅程方案，並請求您的核准。確認內容後選擇「執行」即會套用設定，選擇「先不用了」則不會套用。

傳送目標的 URL 等外部系統專屬的資訊，代理無法自行判斷。這些需要您在自動旅程的編輯畫面自行輸入。

自行設定

發送 Webhook 動作可在自動旅程的編輯畫面中新增與設定。

  1. 在自動旅程的編輯畫面中，新增「發送 Webhook」作為動作
  2. 選取節點後，右側會開啟側邊欄，請填寫設定項目
設定項目

在側邊欄填寫的主要項目如下。

項目 說明
「Webhook URL」 資料傳送目標的 URL（必填）
「請求內容」 要傳送的資料內容，建議使用 JSON 格式

請求內容也可以從「在編輯器中編輯」開啟專用編輯器進行編輯。以 JSON 格式輸入時，資料會以 Content-Type「application/json」傳送。沒有選擇傳送方式的設定項目，請求一律以 POST 傳送。

在請求內容中插入好友的資訊

在請求內容中，只要寫入以雙大括號括起來的變數，就能將該名好友的資訊、操作內容，以及已同步的屬性值插入並一併傳送。傳送時會替換成每位好友的實際值。

好友與操作的資訊

關於觸發自動旅程的基本資訊，可以使用下列變數插入。

變數 插入的值
{{line.userId}} 好友的 LINE 使用者 ID
{{line.displayName}} 好友的顯示名稱
{{line.pictureUrl}} 好友大頭貼的 URL
{{message.text}} 收到的訊息內容（以「收到訊息」為觸發條件時）
{{postback.data}} Postback 的資料（以「收到 Postback」為觸發條件時）
{{answers.lastAnswer}} 好友在前一個提問動作中回答的內容
{{contact.displayName}} Lumo 中顧客資料的顯示名稱，{{contact.firstName}}、{{contact.lastName}} 與 {{contact.pictureUrl}} 也是相同寫法

變數的完整清單整理於「自動旅程可使用的變數」這篇文章。

日期與時間的資訊

傳送當下的日期與時間也可以插入。日期時間會依工作區設定的時區計算（未設定時為日本時間）。

變數 插入的值 範例
{{date.today}} 傳送當天的日期 2026-09-14
{{date.now}} 傳送的日期時間（含時區） 2026-09-14T18:30:00+09:00
{{date.year}} 年 2026
{{date.month}} 月 9
{{date.day}} 日 14
{{date.hour}} 時 18
{{date.minute}} 分 30
{{date.dayOfWeek}} 星期（英文） MONDAY
{{date.dayOfWeekJa}} 星期（日文） 月曜日
{{date.formatted}} 日文格式的日期時間 2026年09月14日 18:30
整合服務的屬性

若已連動 HubSpot、Klaviyo、Shopify 並同步屬性，可指定屬性的內部名稱來插入其值。可插入的，僅限在各服務設定畫面中選為同步對象的屬性。

  • {{hubspot.屬性的內部名稱}} … HubSpot 已同步的屬性
  • {{klaviyo.屬性的內部名稱}} … Klaviyo 已同步的屬性
  • {{shopify.屬性的內部名稱}} … Shopify 已同步的屬性
  • {{屬性的內部名稱}} … 省略服務名稱的寫法（會依 HubSpot → Klaviyo → Shopify 的順序尋找值）

若該名好友未與該服務連動，或值未設定，變數會被替換為空值。

沒有值時的替代文字

在變數後方加上 or '替代文字'，值為空時就會填入指定的文字。

寫成 {{hubspot.member_rank or 'regular'}} 時，未設定會員等級的好友會送出 regular。適合用在不想讓 JSON 的鍵留空的情況。替代文字請以引號括起來。

輸入範例

例如，寫成下列內容時，會在帶入每位好友的 LINE 使用者 ID、收到的訊息與會員等級的狀態下傳送（請將 member_rank 的部分替換成您自己的屬性內部名稱）。

{
  "lineUserId": "{{line.userId}}",
  "message": "{{message.text}}",
  "rank": "{{hubspot.member_rank}}"
}

Lumo 送出的請求格式

發送 Webhook 會以 POST 將請求送往設定的 URL。接收端請準備可接受 POST 的端點。

項目 內容
方法 一律為 POST，沒有選擇傳送方式的設定
Content-Type 請求內容為有效的 JSON 時為 application/json，其他情況為 text/plain
逾時 30 秒。30 秒內沒有回應時視為失敗，並在 30 秒後、2 分鐘後、10 分鐘後最多重送 3 次
自動附加的標頭 X-Lumo-Request-Id（每次傳送都會變動的識別碼）、X-Lumo-Workflow-Id（自動旅程的 ID）、X-Lumo-Node-Id（動作的 ID）

若接收端回應 4xx 或 5xx 的錯誤，會視為已送達，不會重送。X-Lumo-Request-Id 每次傳送都不同，可作為與接收端記錄檔核對的線索。

設定時的注意事項

視傳送目標與傳送內容而定，Webhook 有可能無法正確送達。設定前請確認以下幾點。

  • 傳送目標 URL 請指定可從外部連線到達的正確 URL
  • 請確認接收端系統是否能接收 Lumo 傳送的資料格式
  • 基於安全保護，部分傳送目標可能會被封鎖

整合不順利時，請先重新檢視傳送目標 URL 與傳送內容的格式，並一併確認接收端系統的記錄檔。

相關文章