Mon édition
Module supplémentaire Agents IA - avancé

Cette fonctionnalité est réservée aux clients Enterprise. Contactez votre responsable du service client si vous souhaitez l’activer.

Real_time_webhook_example.png

Cet article explique les sujets suivants :

  • Événements déclencheurs d'alertes en temps réel
  • Configuration du webhook

Événements déclencheurs d'alertes en temps réel

Le webhook d'alerte en temps réel vous permet d'être informé en temps réel du déclenchement des événements qui vous intéressent. Ces événements peuvent se produire n'importe où dans notre système, mais se limitent pour le moment aux cinq événements énumérés ci-dessous : 

  1. Une remontée a échoué

  2. Une action a échoué

  3. Un message d'erreur technique générique a été envoyé dans le chat

  4. Une intégration backend personnalisée a échoué (dans ce cas, l’intégration backend exacte est spécifiée dans l’objet data)

  5. Test : un événement de test peut être déclenché à partir du tableau de bord Agents IA - Avancé afin que les développeurs puissent tester et mettre en œuvre l'utilisation du webhook sans avoir besoin d'attendre l'un des déclencheurs

Dès que l'un des événements est déclenché, nous envoyons une demande avec le paramètre suivant à l'URL du webhook :

Nom Type Description
botName chaîne Nom de l'agent IA qui a déclenché l'événement
événement chaîne Les cinq différents types d’événements
conversationId chaîne ID de conversation unique
platformConversationId chaîne ID de conversation spécifique à la plateforme
data objet Métadonnées, principalement utilisées par l'événement d'intégration backend

Pour l’événement d’intégration backend personnalisé, nous enrichirons l’objet de données avec le paramètre suivant :

Nom Type Description
botId chaîne Une combinaison de 24 chiffres et lettres propre à chaque agent IA. Approfondissez.
conversationId chaîne ID de conversation unique
conversationLink chaîne Lien vers la conversation spécifiée dans les journaux de conversation
httpStatus chiffre Type de statut de l’erreur
endpointUrl chaîne URL ciblée par l’intégration backend

Configuration du webhook

Vous pouvez accéder à la configuration du webhook dans Paramètres de l'agent IA > Général > Webhook. Cette fonction n'est visible que pour les clients Enterprise.

Pour le configurer, suivez les instructions ci-dessous :

  1. Dans le tableau de bord Agents IA - Avancé, accédez à Paramètres de l’agent IA > Général > Webhook.

  2. Copiez et collez l'URL du webhook depuis votre outil de données dans le champ défini. Veuillez noter que nous n'autorisons que les URL https.

  3. Cliquez sur Afficher le token et utilisez le token d'authentification pour récupérer les messages d'alerte sur votre outil de données.

  4. Cliquez sur Utiliser un webhook pour suivre les performances de l’agent IA pour activer la fonctionnalité.

  5. Enregistrez les paramètres de l’agent IA mis à jour. Le bouton Tester le webhook devrait à présent être activé.

  6. Cliquez sur Tester le webhook pour envoyer un événement test à l’URL que vous avez spécifiée comme URL du webhook. Cette dernière étape est facultative mais recommandée. 

Réalisé par Zendesk