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

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

更新日時 January 3, 2019

対象製品

Marketing Hub
marketing-enterprise
Enterprise
Sales Hub
sales-enterprise
Enterprise
Service Hub
service-enterprise
Enterprise

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

ウェブフックとは

ウェブフックは、あるウェブアプリケーションで何らかのアクションが完了した後に、そのアプリケーションから別のウェブアプリケーションにデータを送るために使用されます。ウェブフックは、データ、通知、アラート、その他のリアルタイムアップデートの送信に使用できます。

ウェブフックは一般的に次の用途に使用されます。

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

  • 外部システムにコンタクトデータを送信して、コンタクトにソフトウェアのトライアルを提供する。

  • 重要なイベントが発生したときに、外部システムから社内のチャットストリームにアラートを送信して、従業員に通知する。

コンタクトベースのワークフローでウェブフックをセットアップする

これらの手順は、コンタクトベースのワークフローのみに適用されます。

  • HubSpotアカウントにて、[自動化] > [ワークフロー]の順に進みます。
  • 編集するコンタクトベースのワークフローの名前をクリックします。
  • + アイコンをクリックして、アクションを追加します。
  • 右のペインで、[ウェブフックを実行] をクリックします。
  • [メソッド] ドロップダウンメニューをクリックして [GET] または [POST] を選択します。
    • GET - 指定された URL に GET リクエストを送信します。
    • POST - 指定された URL に POST リクエストを送信 (データを送信) します。
  • ウェブフック URL を入力します。

注: ウェブフック URL は安全なプロトコルに制限されており、先頭は HTTPS である必要があります。

  • システムへのリクエストに認証が必要な場合、[認証を使用しますか?] チェックボックスを選択し、ユーザー名とパスワードを追加します。
  • [保存] をクリックします。

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

この手順は、会社ベース取引ベースチケットベース見積もりベースのワークフローに適用されます。

  • HubSpotアカウントにて、[自動化] > [ワークフロー]の順に進みます。
  • 編集する会社ベース、取引ベース、チケットベース、または見積もりベースのワークフローの名前をクリックします。
  • + アイコンをクリックしてアクションを追加し、右ペインで [ウェブフックを実行] をクリックします。
  • ウェブフック URL を入力します。

注: ウェブフック URL は安全なプロトコルに制限されており、先頭は HTTPS である必要があります。

  • [保存] をクリックします。

注: 会社ベース、取引ベース、チケットベース、見積もりベースのワークフローの [ウェブフックを実行] アクションでは、POST メソッドしかサポートされません。

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

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

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

ユーザー追加画像
ユーザー追加画像

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

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