ワークフローの「Webhook送信」アクションを使うと、ワークフローの実行に合わせて外部システムへデータを自動で送信できます。開発者が外部システムとLumoをつなぐための機能です。
Webhook送信でできること
Webhook送信は、ワークフローのアクションのひとつで、指定したURLへデータを送る機能です。
友だち追加やタグの変更といったワークフローのきっかけに合わせて、自社システムや外部サービスへ自動でデータを届けられます。ノーコードでは対応しきれない独自の連携を、自分たちの仕組みに合わせて組み立てたいときに役立ちます。
代表的な使い方は次のとおりです。
- ワークフローが動いたタイミングで、自社システムへデータを送る
- 友だちの情報やワークフロー内の値を含めて送信する
- 外部のサービスへデータを渡し、その先の処理につなげる
Shopify・HubSpot・Klaviyoなど、よく使われる外部サービスは専用の連携メニューを用意しています。まずはそちらで対応できないかを確認することをおすすめします。
エージェントに任せる場合
ワークフローの設計はマーケティングエージェントに相談でき、Webhook送信もその流れの中で組み込めます。
「友だち追加のときに自社システムへ通知したい」のように、やりたいことを伝えると、エージェントが必要なきっかけとアクションを含むワークフロー案を作成し、承認を求めます。内容を確認して「実行する」を選べば設定が反映され、「やめておく」を選べば反映されません。
送信先のURLなど、外部システム固有の情報はエージェントだけでは判断できません。これらはワークフローの編集画面で自分で入力します。
自分で設定する場合
Webhook送信アクションは、ワークフローの編集画面で追加・設定します。
- ワークフローの編集画面で、アクションとして「Webhook送信」を追加します
- ノードを選択すると右側にサイドバーが開くので、設定項目を入力します
設定項目
サイドバーで入力する主な項目は次のとおりです。
| 項目 | 説明 |
|---|---|
| Webhook URL | データの送信先となるURL（必須） |
| HTTPメソッド | リクエストの送信方法。用途に合わせて選びます |
| リクエストボディ | 送信するデータの内容。JSON形式を推奨します |
リクエストボディは、「エディタで編集」から専用エディタを開いて編集することもできます。JSON形式で入力すると、Content-Type「application/json」でデータが送信されます。
リクエストボディに友だちの情報を差し込む
リクエストボディには、二重波かっこで囲んだ変数を書くことで、その友だちの情報や操作内容、連携済みプロパティの値を差し込んで送信できます。送信時に、各友だちの実際の値へ置き換わります。
友だちや操作の情報
ワークフローのきっかけに関する基本的な情報は、次の変数で差し込めます。
{{line.userId}}… 友だちのLINEユーザーID{{line.displayName}}… 友だちの表示名{{message.text}}… 受信したメッセージの本文（メッセージ受信がきっかけのとき）{{postback.data}}… ポストバックのデータ（ポストバック受信がきっかけのとき）
連携サービスのプロパティ
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と送信内容の形式を見直すとともに、送信先システム側のログも確認してください。