BêtaUtilisation des webhooks dans les agents

Utilisez les actions webhook dans les agents pour envoyer et recevoir des données de systèmes externes. Vous pouvez configurer des actions de webhook dans Agent Builder pour effectuer des requêtes HTTP (par exemple, GET ou POST), déclencher des processus externes ou récupérer des données.

Les actions de webhook aident à connecter les agents à des outils externes sans nécessiter d’intégrations personnalisées. Par exemple, vous pouvez envoyer les données d’une transaction à un système externe afin de déclencher l’exécution des commandes ou récupérer les informations d’un client sur une autre plateforme pour les utiliser dans les résultats de vos agents.

Remarque : Vous pouvez gérer l'accès aux fonctionnalités d'IA dans vos paramètres d'IA et configurer les données partagées. Consultez la FAQ sur la fiabilité et la sécurité de l'IA et les cartes de modèle d'IA de HubSpot pour obtenir des informations détaillées sur les contrôles de sécurité de l'IA, l'utilisation des données et la conformité.

Avant de commencer

Avant de commencer à utiliser les webhooks dans les agents, examinez les exigences et les considérations à prendre en compte.

• Un super administrateur doit activer les options suivantes dans les paramètres IA :

  • Donner aux utilisateurs l'accès aux outils et fonctionnalités de l'IA générative

  • Données du CRM

  • Données de conversion des clients

  • Données de fichiers

  • Fournir aux utilisateurs l'accès à Breeze Assistant

Ajouter une action de webhook à un agent

Ajoutez une action de webhook dans Agent Builder pour envoyer des données à un système externe ou en récupérer des. Utilisez le menu déroulant Méthode pour sélectionner la façon dont l’agent doit communiquer avec l’URL du webhook :

• GET : récupérez les valeurs d’un autre système. Utilisez les demandes GET lorsque l’agent a besoin de faire référence à des informations provenant d’un système externe plus tard dans l’exécution de l’agent, telles qu’un état d’abonnement, un état de commande ou un champ de profil client.

• POST : envoyer les valeurs à un autre système. Utilisez les requêtes POST lorsque l’agent doit déclencher ou mettre à jour quelque chose en dehors de HubSpot, comme la création d’une demande d’exécution, l’envoi d’une notification ou la mise à jour d’une fiche d’informations externe.

Pour ajouter une action de webhook :

1. Dans votre compte HubSpot, cliquez sur Plus, puis accédez à Agents > Agent Hub . Si l’option n’apparaît pas dans votre compte, accédez directement à Agents > Agent Hub .

2. Cliquez sur l’onglet Agents.

3. Cliquez sur Modifier sur la carte d’un agent existant ou créez un nouvel agent.

4. Dans Agent Builder, cliquez sur Ajouter une action dans la section Actions .

5. Dans le panneau de droite, saisissez Envoyer un webhook dans le champ Rechercher . Cliquez ensuite sur l’action Envoyer un webhook.

6. Cliquez sur le menu déroulant Méthode et sélectionnez le type de demande (par exemple, POST ou GET ).

7. Dans le champ URL du Webhook , saisissez l’URL vers laquelle la demande doit être envoyée.

8. Cliquez sur le menu déroulant Type d’authentification et sélectionnez un type d’authentification.

9. En fonction de la méthode sélectionnée (par exemple, GET ou POST), configurez les valeurs à inclure dans la demande.

   • Pour les demandes GET , dans la section Paramètres de demande, cliquez sur Ajouter une valeur statique pour ajouter les noms et les valeurs à ajouter à l’URL du webhook.

   • Pour les demandes POST , dans la section Corps de la demande, cliquez sur Ajouter une valeur statique pour ajouter des valeurs à inclure dans le corps de la demande du webhook.

10. Pour tester l’action de webhook, cliquez sur Tester. Passez en revue la réponse pour confirmer que la demande est correctement configurée. Si le test échoue, vérifiez l’URL du webhook, la méthode, le type d’authentification, les paramètres de demande ou le corps de la demande, puis testez l’action à nouveau.

11. Lorsque vous avez terminé, cliquez sur Enregistrer et ajouter.
12. Continuez à personnaliser l’agent, puis publiez.

Étapes suivantes

• Créer et personnaliser des agents dans Agent Builder
• Exécuter les agents et examiner les résultats dans la boîte de réception des agents
• Examiner les coûts de crédit estimés lorsque vous utilisez des agents