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

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

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

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

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

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

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

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

注：HubSpotは、失敗したウェブフックについて、失敗の1分後から最大3日間に渡って再試行します。その後の失敗は、徐々に間隔を延ばして再試行されます。再試行の間隔は最大で8時間になります。HubSpot の開発者ドキュメントで、特定のエラーコード例外について確認する。

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

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

• HubSpotアカウントにて、［自動化］ > ［ワークフロー］の順に進みます。
• ワークフローの名前をクリックします。
• +アイコンをクリックして、アクションを追加します。
• 右側のパネルで、［ウェブフックを実行］をクリックします。
• ウェブフックURLを入力します。ウェブフックURLには安全なプロトコルという制限があり、HTTPSで始まる必要があります。

• ウェブフックへのリクエストを認証するために［リクエスト署名を使用］チェックボックスをオンにして、アプリIDを入力します。リクエスト署名を確認する方法をご確認ください。
• ［保存］をクリックします。

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

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

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

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

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

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

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

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

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

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

• 開発者アカウントを所有します。所有していない場合は、開発者アカウントを登録します。
• アプリを所有します。所有していない場合は、アプリを作成する方法をご確認ください。
• 署名のハッシュ値を確認します。