Module générique Botmind - Webhook - Création de ticket

Cet article décrit comment utiliser le module générique Botmind de création de ticket via un webhook.

Principe

Ce module "Création de ticket" permet de faire un appel sur un serveur tiers avec les données issues de la conversation avec l'utilisateur.

Les informations ainsi envoyées vers une route devront ensuite être utilisées pour implémenter la création de ticket.

Implémentation

Voici les détails concernant l'implémentation de ce webhook.

Authentification (optionnel)

Une authentification peut être exigée par la route cible du webhook et 2 modes d'authentification sont disponibles par défaut:

• Basic
• Bearer token

L'authentification des requêtes n'est pas obligatoire.

Données envoyées en paramètres du webhook

Voici la liste et le type des données qui sont envoyées lors de l'appel de la route.

• URL du webhook : String
• Email associé au ticket : String
• Question de l’utilisateur : String
• Nom de l’utilisateur : String
• Téléphone de l’utilisateur : String
• Sujet du ticket : String
• Tags : [String]

Retours attendus par le webhook

La route appelée par le webhook devra renvoyer un objet vide au format JSON accompagnée par une en-tête HTTP avec les codes de retour suivants chaque situation tel que décrit ci-dessous:

• Code retour HTTP 200: Ticket créé
• Code retour HTTP 403: Problème d’authentification
• Code retour HTTP 404: Email incorrect