Web フック

最終更新日： 2026年8月8日

作成対象：

MarketoのWebhookは、サードパーティのweb サービスと通信します。 Webhookは、GETまたはPOST HTTP動詞を使用して、特定のURLにデータを送信したり、特定のURLからデータを取得したりします。

Webhookを作成してスマートキャンペーンに追加する手順については、次を参照してください。

各Webhookに次のプロパティを設定します。

URL - web サービスリクエストを送信するURL。
リクエストタイプ - HTTP メソッド。
ペイロードテンプレート - POST本文で送信される情報のテンプレート。 XMLやJSONなど、HTTP POSTをサポートするあらゆるデータ形式を使用できます。シリアル化形式では、文字列を二重引用符で囲むことができる必要があります。トークンを挿入するには、トークンを挿入を選択します。 Marketoでは、文字列タイプトークンが二重引用符で囲まれます。
要求トークンエンコーディング - アンパサンドや「&」などの特殊文字を含むトークン値をエンコードするために使用される、JSONまたはForm/Urlのリクエスト形式。 WebhookがWeb サービスと正しく通信するように、正しいボディエンコーディングを選択します。
応答タイプ – 応答の形式（JSONまたはXML）。 Marketoのリードフィールドに応答プロパティをマッピングする正しいタイプを選択します。
カスタムヘッダー - キーと値のペアがWebhook アクション > カスタムヘッダーを設定を通じてHTTP ヘッダーとして追加されました。任意の数のカスタムヘッダーを追加できます。

応答マッピングを使用して、web サービス応答からリードにデータを書き込みます。

トークン

URL、テンプレート、カスタムヘッダーを含むすべての送信Webhook フィールドは、フローステップと同じコンテキストでトークンコンテンツを入力します。

リードトークンとシステムトークンはいつでも利用できます。トリガー、Campaign、およびプログラムトークンは、それぞれのスコープで使用できます。詳しくは、次を参照してください。

例えば、プログラムまたはCampaignがサードパーティリソースにマッピングされる場合、プログラムレベルのIDをMy Tokenに設定します。その後、IDをトークンとしてWebhook リクエストに渡します。

Webhookは、送信リクエストを含む任意の数のカスタムヘッダーフィールドを送信できます。 Webhook アクション/カスタムヘッダーを設定でヘッダーを追加します。

各ヘッダーはキーと値のペアで、トークンを含めることができます。

カスタムヘッダー

トリガーキャンペーンでのみ、「Webhookを呼び出し」フローステップを使用します。
レスポンスマッピングは、web サービスが2xx HTTP レスポンスコードを返すときにのみレコードを更新します。
Web サービスを使用して、内部または外部のサービスからカスタムデータのエンリッチメント、検証または正規化を実行できます。
Webhook実行時間は、サービスの応答時間に依存し、キャンペーン実行の遅延が長くなる可能性があります。サービスの実行に50 ミリ秒しかかからない場合でも、10万回の実行には1.5時間かかります。
Marketoは、特定のサービスコールに対して最大30秒待ってから、呼び出しを終了します（タイムアウトとも呼ばれます）。
Marketoは、書き込まれたURL フィールドの文字を渡します。例えば、「&」は「&」として送信され、「%26」は「%26」として送信されます。
- パーセントでエンコードされた文字を受信者サーバーに送信するには、その文字を表す文字列を明示的に渡します。

recommendation-more-help

marketo-developer-help