Klaviyo で利用できるさまざまな Webhook を理解する
このページで学べること
Klaviyo で利用できる Webhook ソリューションの違いと、それぞれを使用すべきタイミングについて説明します。
始める前に
アドバンストKDPはKlaviyoの標準マーケティングアプリケーションには含まれておらず、関連機能にアクセスするにはサブスクリプションが必要です。このプランの購入方法については、請求ガイドをご覧ください。
Webhook とは何ですか？
Webhook を使用すると、Klaviyo は HTTP リクエストを介して情報を渡したり、他のアプリケーション、ツール、サーバーを「呼び出し」たりできます。Webhook では、発生したイベント（例：注文の確定、新しい顧客の購読など）に関する情報を送信したり、外部システムに対してイベントが発生したことを通知したりできます。
ウェブフックはいくつかの主要なコンポーネントで構成されています：
- トピック
Webhook が起動する原因となるイベントです。 - 本文（または “the payload”）
Webhook が送信するデータ。 - ヘッダー
追加情報（認証など）を渡す場所です。
フロー Webhook
フローが特定の段階またはステップに到達したときに発生するアクションとして、フローに Webhook を追加できます。フローが Webhook アクションに到達すると、ペイロードの構築方法に基づき、フローをトリガーしたイベントまたは受信者に関するデータを含む POST リクエストが送信されます。
フローの Webhook は、フロー トリガーによって発生したイベント（つまり、フロー トリガーとして使用できるイベント）に基づいてのみ送信できます。また、フローは通常メッセージの受信で終了するため、フローの Webhook はメッセージ関連のイベント（例：メールを受信、メールをクリック、メールを迷惑メールとしてマーク）をサポートしていません。
[メールマーケティングからの購読解除] は、フローのトリガーおよびフロー Webhook のトピックとして使用できます。
フローの Webhook の使用例
フローの Webhook が最も効果を発揮するユースケースの例は次のとおりです：
- セグメントまたはリストに購読者が追加されたことをトリガーとして、メッセージまたは POST リクエストを送信します。
- プロファイルがエンゲージメントなしのセグメントに入ったときに送信抑制を自動化します。
- お客様が購入したときに、Whatsapp や Facebook messenger などのサービスを通じて、パーソナライズされたお礼メッセージを送信します。
アドバンストKDPのウェブフック
アドバンストKDPはKlaviyoの標準マーケティングアプリケーションには含まれておらず、関連機能にアクセスするにはプランへの契約が必要です。この機能をプランに追加する詳しい方法については請求ガイドをご覧ください。Klaviyoの新規のお客様の場合は、このまま開始できます。
アドバンストKDPのウェブフックを使用すると、ウェブフックアクションに至る一連のステップに依存せずに、イベントに応じて外部システムへ通知できます。アドバンストKDPのウェブフックでは、ウェブフックリクエストの本文を手動で作成または指定する必要はありません。独自の開発なしで、イベントの発生を外部システムに通知したい場合は、アドバンストKDPのウェブフックが最も効果的です。
アドバンストKDPのウェブフックは、リクエストをトリガーするより幅広いトピックにも対応しており、イベント取得API を介してクエリできる任意のイベントに応じて情報を送信できます。
以下のようなブロックが用意されています。
- メールイベント（例：メールを受信、メールをクリック、メールを迷惑メールとしてマーク）
- SMS イベント（例: Sent SMS、Received SMS）
- プッシュ通知イベント（例：プッシュ通知の受信、プッシュ通知のバウンス）
- 外部連携からのイベント（例：Klaviyo によって作成されたファーストパーティ外部連携からのイベント）
- API イベント（例：Klaviyo の API を介して同期されたイベント）
これには、フロー Webhook でサポートされていない Unsubscribed、Received email、Clicked email などのメッセージ関連イベントが含まれます。
また、アドバンストKDPのウェブフックでは、単独トリガーのフローに依存するフローウェブフックとは異なり、一度に複数のトリガーを購読できます。
宛先 URL は、一般公開されている HTTP エンドポイントである必要があります。
アドバンストKDPのウェブフックの使用例
- 顧客の購読解除イベントを外部システムに同期します。
- ヘルプデスク ソフトウェアに Received Email イベントをレポートして、担当者がお客様への対応向上のためにメール履歴を確認できるようにします。
- Klaviyo の データウェアハウス同期ではサポートされていないデータウェアハウスに、すべてのメール送信、開封、クリックを同期します。
コード
コードはKlaviyoアドバンストKDPに含まれる機能です。Klaviyoの標準マーケティングアプリケーションには含まれていないため、関連機能にアクセスするにはアドバンストKDPのサブスクリプションが必要です。この機能をプランに追加する詳しい方法については請求ガイドをご覧ください。Klaviyoの新規のお客様の場合は、このまま開始できます。
コードは Webhook を活用して、イベントトリガーに応じたカスタム関数の実行を可能にします。Klaviyo のエディターで直接コードを記述でき、Klaviyo がコードの実行、モニタリング、ログ記録を管理します。
パブリック HTTP エンドポイントをホストせずに外部システムへリクエストを送信する場合は、Code を使用できます。さらに、イベントの発生に応じてカスタム関数を実行する場合は、Klaviyo で利用可能な他の Webhook ソリューションではなく Code を使用してください。
コードでは、アドバンストKDPでウェブフックよりもイベントトリガーの粒度を高く設定することもできます。外部連携またはAPIイベントすべてではなく、個々のメトリックをトピックとして選択できます。
Code は以下のイベントをトピックとしてサポートしていないことに注意してください。
- メール開封
- メールを受信しました
Example Code のユース ケース
- Python JSON ライブラリをインポートしてイベントペイロードを解析し、何らかの情報を抽出します。
- Klaviyo の API を使用して、イベント メタデータに基づくカスタム プロファイルプロパティを設定します。
- chatGPT ライブラリをインポートし、プロファイルとカート内の商品に基づいて各カゴ落ちにカスタムメッセージを作成します。
その他のリソース
- Understanding webhooks in flows
Learn about webhooks in flows and how they send information from Klaviyo to your third-party tools and applications. It’s important to note that setting up webhooks can be complex. It’s advised to have development knowledge or development resources to correctly complete this setup. If you are looking for these development directions, learn how to add a webhook action to a flow.
- Understand webhooks in Advanced KDP
Learn about webhooks, and how you can use them to send information to your third-party applications in response to events captured in Klaviyo. For more detailed information on how to receive system webhooks, head to our developer resource on working with system webhooks.
- Getting started with Code
Learn about Code, and how to create custom functions that are executed directly by Klaviyo.