Comment créer des tickets avec un chatbot ?

Dans ce tuto, nous allons voir comment intégrer une fonctionnalité de
création de ticket à votre chatbot. Pour cet exemple, j'ai choisi de créer des tickets dans
Trello mais c'est possible avec n'importe quel outil qui expose une API !

🙏 Prérequis

🍔 Menu

Créer et paramétrez votre compétence action

Etape 1 - Création de la compétence

Pour commencer, dans l’onglet Compétences, cliquez sur créer une nouvelle compétence. Nommez la Création Ticket puis cliquez sur le stylet pour l’éditer. 

Etape 2 - Sélection du type "action"

Sélectionnez le type de compétence action puis cliquez sur Valider.

Etape 3 - création des ressources de collecte

Créez une ressource de collecte. 

Nommez cette ressource email, répétez l’opération pour obtenir les 4 ressources de collecte suivantes :

  1. email
  2. titre
  3. description
  4. urgence 

Etape4 - création de la ressource de validation

Créez ensuite votre ressource de Validation. Son contenu sera généré automatiquement à partir des ressources de Collecte préalablement créées.

Etape 5 - paramétrage des ressources de collecte

Ensuite, vous pouvez éditer les ressources une par une grâce au stylet en commençant par la ressource email.

Vous accédez donc à la vue détaillée de la ressource où vous pourrez éditer ses messages, choisir un format de réponse imposé pour l’utilisateur et activer des suggestions de réponses en formats boutons.

Nous voulons que le bot demande : “Quelles est votre adresse e-mail ?” et que l’utilisateur soit contraint de répondre un e-mail et s’il ne le fait pas de recevoir un message d’erreur. Voici comment je paramètre :

A noter que le message d’erreur est éditable mais automatiquement généré à partir du type de réponse attendu.

Voici le paramétrage de ma ressource titre :

Voici le paramétrage de ma ressource description :

Voici le paramétrage de ma ressource urgence :

Etape 7 - Ajout de la logique de workflow dans la validation

Dans l’onglet Logique de ma ressource de validation, j’active un workflow que je paramètre comme suit :

  1. je le déclenche quand l’utilisateur clique sur Valider
  2. je déclenche le workflow create-ticket-trello (je peux l’écrire directement dans le sélecteur pour créer le workflow que j’irai configurer dans l’étape 8)
  3. je choisis Result comme étant la ressource à accéder une fois mon workflow exécuté

Ensuite, je n’ai plus qu’à paramétrer mon workflow create-ticket-trello.

Etape 8 - Paramétrage du workflow

Pour paramétrer le workflow, rendez-vous dans l’onglet Workflow et éditer avec le bouton stylet.

Puis, cliquez sur Ajouter une étape et cliquez sur le menu déroulant choisissez une action. En écrivant trello vous pourrez alors choisir l’action Trello – Create a card.

Editez l’action et cliquez sur Connecter, une page s’ouvre alors pour que vous autorisiez Trello à se connecter à Vizir avec votre compte => Autorisez !!

Ensuite, utilisez dans cette action les attributs récupérés dans le bot comme suit : 

Le workflow de création de ticket trello est donc opérationnel. Il ne vous reste qu’à gérer la réponse API renvoyée pour l’afficher à l’utilisateur. Pour cela, toujours dans l’étape trello de votre workflow, rdv dans l’onglet réponse. Cliquez sur sauvegarder la réponse dans un attribut.

Ici, l’id de la carte trello sera stocké dans l’attribut Vizir id_ticket.

Etape 9 - Paramétrage du result

Enfin, nous avons récupéré le résultat du worflow de création de carte trello. Nous allons l’utiliser et le montrer à l’utilisateur dans la ressource prévue à cet effet, la ressource Result. Pour cela rien de plus simple, il suffit d’appeler dans votre texte de ressource Result l’attribut de résultat avec la notation moustaches comme ceci : {{id_ticket}}.

Voici comment j’ai paramétré ma ressource de Result :

Dès à présent, vous devriez obtenir le résultat présenté dans la vidéo d’introduction, à vos tests !