お客さまへの大切なお知らせ:膨大なサポート情報を少しでも早くお客さまにお届けするため、本コンテンツの日本語版は人間の翻訳者を介さない自動翻訳で提供されております。正確な最新情報については本コンテンツの英語版をご覧ください。
Workflows

HubSpotワークフローでウェブフックを使用する

更新日時 2020年 10月 19日

対象製品

Marketing Hub  Enterprise
Sales Hub  Enterprise
Service Hub  Enterprise

ワークフローでウェブフックを使用して、HubSpotから別のウェブアプリケーションに情報を渡すことができます。 

データの送信や通知のプッシュなど、ウェブフックにはさまざまな用途があります。

ウェブフックには一般的に次の用途があります。

  • コンタクトがサイト内のフォームから情報を送信したときに、HubSpotのコンタクトデータをCRMなどの外部システムに送信する。

  • 取引データを外部出荷処理システムに送信して注文書を作成する。

  • 外部システムから会社のチャットストリームにチャットアラートを送信して、従業員に何か重要な問題が発生したことを知らせる。

HubSpotは、ウェブフックトラフィックを他のワークフロープロセスから切り離して制御します。これは、ワークフローとウェブフックのパフォーマンスを向上させるために行います。ウェブフックが遅い場合やタイムアウトした場合は、ワークフローアクションの実行に予想より長い時間がかかります。

注:失敗したウェブフックは、HubSpotにより最大3日間再試行されます。

ウェブフックの技術面の詳細については、開発者向けのドキュメントを確認してください。

 ワークフローでウェブフックをセットアップする

注:2018年11月1日以前に購入されたMarketing Hub ProfessionalアカウントまたはSales Hub Professionalシートには、[ウェブフックをトリガー]ワークフローアクションに対するアクセス権があります。 
  • HubSpotアカウントにて、[自動化] > [ワークフロー]の順に進みます。
  • ワークフローの名前をクリックします。
  • +アイコンをクリックして、アクションを追加します。
  • 右側のパネルで、[ウェブフックを実行]をクリックします。
  • ウェブフックURLを入力します。ウェブフックURLには安全なプロトコルという制限があり、HTTPSで始まる必要があります。
  • ウェブフックへのリクエストを認証するために[リクエスト署名を使用]チェックボックスをオンにして、アプリIDを入力します。リクエスト署名を確認する方法をご確認ください。
  • [保存]をクリックします。

注:[ウェブフックを実行]アクションではPOSTメソッドのみがサポートされています。

ウェブフックをテストする

ウェブフックアクションを含むワークフローを作成したら、ダミーのウェブフックURLを使用して、簡単なテストを実行できます。ブラウザーでhttps://webhook.siteに移動し、自動的に作成された一意のURLをコピーします。ウェブフックアクションの[ウェブフックURL]フィールドに、コピーしたURLを貼り付けます。

trigger-a-webhook-action

下の例は、上記のウェブフックのリクエスト本文を示しています。これには、コンタクト情報、フォーム送信、リストメンバーシップなど、特定のコンタクトに関するメタ情報が表示されています。このワークフローアクションがトリガーされると、HubSpotは指定されたURLに、そのコンタクトのレコードすべてをJSON形式で送信します。

ユーザー追加画像

レコードを受け取ったシステムは、そのJSONデータを解析し、システム固有のアプリケーションで使用します。

注:履歴プロパティー値はコンタクトベースのワークフローでのみ返されます。他のすべてのワークフロータイプで使用されるウェブフックは最新の値のみを返します。

開発者ウェブフックドキュメントでウェブフックの詳細をご確認ください。HubSpotでのウェブフックの具体的な実装についてご不明な点がございましたら、HubSpot開発者フォーラムをご利用ください。

ワークフローウェブフックでリクエスト署名を確認する

[ウェブフックの実行]アクションの[認証]セクションで、[リクエスト署名]を選択した場合、HubSpotはウェブフックのX-HubSpot-Signatureヘッダーに、アプリケーションのアプリシークレット、HTTPメソッド、URI、未解析の本文をつなげたSHA-256ハッシュを取り込みます。開発者ドキュメントで詳細をご確認ください。

URLで受信したリクエストの送信元がHubSpotであることを確認するには、次のようにします。