Web フック

最終更新日： 2025年5月14日
  • トピック：

作成対象：

  • 管理者

Marketo では、web フックを使用してサードパーティの web サービスと通信できます。Web フックは、特定の URL からデータをプッシュまたは取得する GET または POST HTTP 動詞の使用をサポートします。アプリケーション内での web フックの作成とスマートキャンペーンへの追加方法の手順について詳しくは、次の記事を参照してください。

個々の web フックには、次のプロパティがあります。

  • URL - Web サービスに対するリクエストの送信に使用する URL を入力します。
  • リクエストタイプ - HTTP メソッド。
  • ペイロードテンプレート - POST の本文で情報を送信する場合は、テンプレートを入力します。XML、JSON、SOAP など、HTTP POST をサポートする任意のデータ形式を使用します。シリアル化形式では、文字列を二重引用符で囲むことができる必要があります。テンプレートにトークンを挿入するには、「トークンを挿入」をクリックします。文字列タイプのトークンは、自動的に二重引用符で囲まれます。
  • リクエストトークンのエンコード - トークンの値に特殊文字（アンパサンド「&」など）が含まれる場合は、リクエストの形式（JSON またはフォーム／URL）を指定します。Web フックが web サービスと正しく通信するには、本文に正しいエンコードを選択する必要があります。
  • 応答タイプ - サービスから受け取る応答の形式（JSON または XML）を選択します。応答のプロパティを Marketo のリードフィールドにマッピングし直すには、正しい応答タイプを選択する必要があります。
  • カスタムヘッダー - Web フックアクション／カスタムヘッダーを設定を通じてアクセスするこのメニューでは、任意の数のカスタムキーと値のペアを HTTP ヘッダーとして追加できます。

応答マッピングを使用すると、web サービス応答からリードにデータを書き戻すことができます。

トークン

Web フック内のすべての送信フィールド（URL、テンプレート、カスタムヘッダー）には、フローステップの同じコンテキストでトークンのコンテンツを入力します。つまり、リードトークンとシステムトークンは常に使用できますが、トリガートークン、キャンペーントークン、プログラムトークンはそれぞれのスコープ内で使用できます。詳しくは、次のトークンに関する記事を参照してください。

一般的なケースは、プログラムまたはキャンペーンがサードパーティのリソースに明示的にマッピングされる場合です。ID は、プログラムレベルで My Token として設定でき、その後トークンとして Web フックリクエストに渡すことができます。