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

エージェントでのWebhookの使用

更新日時 2026年7月23日

以下の 製品でご利用いただけます(別途記載されている場合を除きます)。

エージェントの Webhook アクションを使用して、外部システムとの間でデータを送受信します。エージェントビルダーで Webhook のアクションを設定することで、HTTP リクエスト(GET や POST など)を実行したり、外部プロセスを起動したり、データを取得したりすることができます。

Webhookアクションを利用すれば、カスタム統合を行うことなく、エージェントと外部ツールを連携させることができます。たとえば、取引データを外部システムに送信してフルフィルメントをトリガーしたり、別のプラットフォームから顧客情報を取得して、エージェントの出力に活用したりすることができます。

:AI設定でAI機能へのアクセスを管理し、共有するデータを設定できます。AIのセキュリティー管理、データ使用、コンプライアンスの詳細については、HubSpotのAI信頼性に関するFAQおよびAIモデルカードをご確認ください。

始める前に

エージェントでWebhookの使用を開始する前に、要件と注意事項を確認してください。

  • スーパー管理者は 、[AI設定]で以下のスイッチをオンに切り替える必要があります。

    • 生成AIツールや機能へのアクセス権をユーザーに付与

    • CRMデータ

    • 顧客へのコンバージョンデータ

    • ファイルデータ

    • ユーザーにBreezeアシスタントへのアクセス権を付与

アクセス権限が必要 エージェントビルダーでエージェントを作成・カスタマイズするには、スーパー管理者権限()またはBreeze Studioの権限()が必要です。

アクセス権限が必要 エージェントの目標によっては、ユーザーに追加の権限が必要になる場合があります。たとえば、ランディングページを生成するエージェントは、ランディングページを編集および公開するために、の「編集」および「公開」権限が必要です。

エージェントにWebhookアクションを追加する

エージェントビルダーにWebhookアクションを追加して、外部システムへデータを送信したり、外部システムからデータを取得したりします。[Method] ドロップダウンメニューを使用して、エージェントが Webhook URL とどのように通信するかを選択してください:

  • GET:別のシステムから値を取得します。エージェントの実行中に、サブスクリプションのステータス、注文状況、顧客プロファイルのフィールドなど、外部システムからの情報を後で参照する必要がある場合は、GETリクエストを使用してください。

  • POST:別のシステムに値を送信します。エージェントが、フルフィルメントリクエストの作成、通知の送信、外部レコードの更新など、HubSpotの外部で何かをトリガーしたり更新したりする必要がある場合は、POSTリクエストを使用してください。

Webhookアクションを追加するには:

  1. HubSpotアカウントで、「」→「More」をクリックし、「」→「Agents」を経て、「」→「Agent Hub」に移動します。またはがアカウントに表示されない場合は、Agents > Agent Hubに直接アクセスしてください。

  2. [エージェント] タブをクリックします。

  3. 既存のエージェントのカードで「」をクリックし、「」を編集するか、にアクセスして新しいエージェントを作成してください。

  4. エージェントビルダーで、「」をクリックします。「Actions」の「」セクションで、「」アクションを追加します。

  5. 右側のパネルで、「」と入力し、「Search」フィールドに「」と入力してWebhookを送信します。次に、「」の「Send a webhook」アクションをクリックします。

  6. 」メソッドのドロップダウンメニューをクリックし、「」リクエストタイプを選択します(例:POSTまたはGET)。

  7. 」の「Webhook URL()」フィールドに、リクエストを送信する先の「」URL()を入力してください。

  8. 」認証タイプのドロップダウンメニューをクリックし、「」認証タイプを選択してください。

  9. 選択したメソッド(例:(GET)、、または(POST)、)に応じて、リクエストに含める値を設定してください。

    • の「GET」リクエストについて、「クエリパラメータ」セクションで「静的値を追加」をクリックし、Webhook URLに追加する名前と値を入力してください。

    • のPOSTリクエスト()の場合、「リクエスト本文」セクションで「静的値を追加」をクリックし、Webhookリクエスト本文に含める値を追加します。

  10. Webhookアクションをテストするには、の「」をクリックしてください。設定が正しく行われていることを確認するため、応答内容を確認してください。テストに失敗した場合は、WebhookのURL、メソッド、認証タイプ、クエリパラメータ、またはリクエスト本文を確認し、再度アクションをテストしてください。

  11. 完了したら、「」をクリックして保存し、「」を追加してください。
  12. にアクセスしてエージェントをカスタマイズし、その後を公開してください。

次のステップ

この記事はお役に立ちましたか?
こちらのフォームではドキュメントに関するご意見をご提供ください。HubSpotがご提供しているヘルプはこちらでご確認ください。