Appel avant traitement d'un message

Un webhook de pré-message appelle un service ou une application externe chaque fois qu'un client soumet une entrée. Le service externe peut traiter le message avant que votre assistant ne le traite.

Ajoutez un webhook de pré-message à votre assistant si vous souhaitez que le webhook soit déclenché avant que chaque message entrant ne soit traité par votre assistant.

Si vous utilisez un canal personnalisé, le webhook de pré-message fonctionne uniquement avec la version 2 de l'API /message, avec ou sans état. Pour plus d'informations, reportez-vous à la documentation de référence de l'API. Toutes les intégrations de canal intégrées utilisent cette API.

Vous pouvez utiliser les webhooks de pré-message pour les cas d'utilisation suivants :

  • Traduisez les données du client dans la langue utilisée par votre assistant.

  • Recherchez et supprimez toute information personnellement identifiable, telle qu'une adresse e-mail ou un numéro de sécurité sociale, qu'un client pourrait soumettre.

Vous pouvez utiliser ce webhook en coordination avec le webhook post-message. Par exemple, le webhook post-message peut traduire la réponse dans la langue du client ou ajouter des informations qui ont été supprimées pour des raisons de confidentialité. Pour plus d'informations, voir Appel après traitement d'un message.

Pour les environnements où les nœuds finaux privés sont en cours d'utilisation, gardez à l'esprit qu'un webhook en ligne envoie du trafic sur Internet.

Utilisez un webhook de dialogue si vous avez besoin d'effectuer une action unique au cours d'une conversation. Par exemple, les conditions sont remplies lorsque l'assistant recueille tous les détails requis, tels que le numéro de compte, l'ID utilisateur et le secret de compte. Pour plus d'informations, voir la rubrique Appel par programmation à partir d'un dialogue.

Définition du webhook

Vous pouvez définir une URL de webhook à utiliser pour le prétraitement de chaque message entrant.

Avant de commencer

L'appel programmatique au service externe doit répondre aux exigences suivantes :

  • Ne définissez et ne testez pas votre webhook dans un environnement de production où l'assistant est déployé et interagit avec les clients.
  • L'appel doit être une demande HTTP POST.
  • Le corps de la demande doit être un objet JSON (Content-Type: application/json).
  • L'appel doit revenir en 30 secondes ou moins.

Si votre service externe ne prend en charge que les requêtes GET, ou si vous devez spécifier les paramètres URL de manière dynamique au moment de l'exécution, envisagez de créer un service intermédiaire qui accepte une requête POST avec une charge utile JSON contenant toutes les valeurs d'exécution. Le service intermédiaire peut alors faire une demande au service cible, en passant ces valeurs comme paramètres d'URL, puis renvoyer la réponse au dialogue.

Choisir la méthode de déploiement

Sélectionnez la méthode de déploiement que vous utilisez pour afficher les étapes correctes de la configuration d'un webhook de pré-message.

Pour identifier le type de déploiement que vous utilisez, cliquez sur le menu Gérer. Si vous voyez Basculer vers l'expérience classique, c'est que vous utilisez la nouvelle expérience. Si vous voyez Basculer vers une nouvelle expérience, vous utilisez l'expérience classique.

Utilisez les liens suivants pour connaître les procédures en fonction de votre type de déploiement :