ベータエージェントでのWebhookの使用
更新日時 2026年7月23日
以下の 製品でご利用いただけます(別途記載されている場合を除きます)。
-
Marketing Hub Professional, Enterprise
-
Sales Hub Professional, Enterprise
-
Service Hub Professional, Enterprise
-
Data Hub Professional, Enterprise
-
Content Hub Professional, Enterprise
-
Smart CRM Professional, Enterprise
-
HubSpotクレジットが必要
エージェントの 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アクションを追加するには:
-
HubSpotアカウントで、「」→「More」をクリックし、「」→「Agents」を経て、「」→「Agent Hub」に移動します。またはがアカウントに表示されない場合は、Agents > Agent Hubに直接アクセスしてください。
-
[エージェント] タブをクリックします。
-
既存のエージェントのカードで「」をクリックし、「」を編集するか、にアクセスして新しいエージェントを作成してください。。
-
エージェントビルダーで、「」をクリックします。「Actions」の「」セクションで、「」アクションを追加します。
-
右側のパネルで、「」と入力し、「Search」フィールドに「」と入力してWebhookを送信します。次に、「」の「Send a webhook」アクションをクリックします。
-
「」メソッドのドロップダウンメニューをクリックし、「」リクエストタイプを選択します(例:POSTまたはGET)。
-
「」の「Webhook URL()」フィールドに、リクエストを送信する先の「」URL()を入力してください。
-
「」認証タイプのドロップダウンメニューをクリックし、「」認証タイプを選択してください。
-
選択したメソッド(例:(GET)、、または(POST)、)に応じて、リクエストに含める値を設定してください。
-
の「GET」リクエストについて、「クエリパラメータ」セクションで「静的値を追加」をクリックし、Webhook URLに追加する名前と値を入力してください。
-
のPOSTリクエスト()の場合、「リクエスト本文」セクションで「静的値を追加」をクリックし、Webhookリクエスト本文に含める値を追加します。
-
-
Webhookアクションをテストするには、の「」をクリックしてください。設定が正しく行われていることを確認するため、応答内容を確認してください。テストに失敗した場合は、WebhookのURL、メソッド、認証タイプ、クエリパラメータ、またはリクエスト本文を確認し、再度アクションをテストしてください。
- 完了したら、「」をクリックして保存し、「」を追加してください。
- にアクセスしてエージェントをカスタマイズし、その後を公開してください。