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

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

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

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

始める前に

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

• スーパー管理者は、AI設定で以下のスイッチをオンにする必要があります：
  • 生成AIツールや機能へのアクセス権をユーザーに付与
  • CRMデータ
  • 顧客へのコンバージョンデータ
  • ファイルデータ
  • ユーザーにBreezeアシスタントへのアクセス権を付与

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

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

• GET：別のシステムから値を取得する。エージェントの実行中に、サブスクリプションのステータス、注文状況、顧客プロファイルのフィールドなど、外部システムからの情報を後で参照する必要がある場合は、GETリクエストを使用してください。
• POST：値を別のシステムに送信する。エージェントが、フルフィルメントリクエストの作成、通知の送信、外部レコードの更新など、HubSpotの外部で何かをトリガーしたり更新したりする必要がある場合は、POSTリクエストを使用してください。

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

1. HubSpotアカウントで、［エージェント］＞ ［Agent Hub］に移動します。
2. [ エージェント ] タブをクリックします。
3. 既存のエージェントのカードにある「編集」をクリックするか、新しいエージェントを作成してください。
4. エージェント作成ツールの「アクション」セクションで、「アクションの追加」をクリックします。
5. 右側のパネルで、検索フィールドに「Webhook を送信」と入力します。次に、「Webhook を送信」アクションをクリックします。
6. [Method ] ドロップダウンメニューをクリックし、リクエストの種類（例：POSTやGET）を選択してください。
7. 「Webhook URL」フィールドに、リクエストを送信する先のURLを入力してください。
8. 「認証タイプ」のドロップダウンメニューをクリックし、認証タイプを選択してください。
9. 選択したメソッド（例：GETまたはPOST）に応じて、リクエストに含める値を設定してください。
   • GETリクエストの場合、「クエリパラメータ」セクションで「静的値を追加」をクリックし、Webhook URLに追加する名前と値を入力します。
   • POSTリクエストの場合、「リクエスト本文」セクションで「静的値を追加」をクリックし、Webhookのリクエスト本文に含める値を追加します。
10. Webhookアクションをテストするには、「テスト」をクリックしてください。設定が正しく行われていることを確認するために、応答内容を確認してください。テストが失敗した場合は、WebhookのURL、メソッド、認証タイプ、クエリパラメータ、またはリクエスト本文を確認し、再度アクションをテストしてください。
11. 完了したら、「保存して追加」をクリックしてください。
12. エージェントのカスタマイズを続け、その後公開してください。

次のステップ

• エージェント作成ツールでエージェントを作成・カスタマイズする
• エージェントを実行し、エージェントの受信トレイで出力を確認する
• 代理店を利用する場合、推定されるクレジット費用を確認してください