Comment déclencher un workflow Prisme.ai depuis un outil externe ?

Introduction

La majorité des outils informatiques actuellement disponible propose de configurer des webhooks pour déclencher des actions externes suite à des événements internes de l'outil.

‍

Avec la possibilité de déclencher un workflow en réponse à ces évènements internes à vos outils, une grande variété d'intégrations possibles s'offre à vous :

• Vous pouvez synchroniser l'ajout de contact Hubspot avec un workflow qui sauvegarderait ce contact dans une collection
• Depuis le même bot, d'autres intentions permettraient de faire différentes actions sur ce contact, directement retransmises à Hubspot par des fonctions Prisme.ai
• 2 outils externe ou plus pourraient être coordonnées par un assistant Prisme.ai manipulant chaque outil en fonction des événements émis par les autres
• Des entrées pourraient être créées dans ces outils externes directement à partir de conversations avec des usagers finaux

‍

Toutes ces intégrations se reposent sur deux éléments :

1. Les webhooks Prisme.ai permettant de déclencher un workflow depuis une requête HTTP
2. Les fonctions Prisme.ai, à sélectionner dans le public ou à créer soi-même

‍

Cet article démontrera l'usage de ces 2 éléments en se basant sur l'exemple de Crisp, une plateforme de messagerie qu'on va intégrer avec Prisme.ai pour faire communiquer les usagers finaux de Crisp avec un assistant Prisme.ai.

‍

Comment marche un webhook Prisme.ai ? 

Afin de déclencher un workflow depuis une requête HTTP, Prisme.ai offre une route qui retransmet le corps de toutes les requêtes POST qu'elle reçoit, directement dans la payload d'un événement indiqué dans l'URL :

• https://webhooks.prisme.ai/events/<prismeaiClientToken>/<eventName>

‍

prismeaiClientToken correspond au Client Token de l'assistant dans lequel vous voulez déclencher un workflow. Vous pouvez obtenir celui-ci depuis le canal API de l'assistant en question.

eventName correspond au nom de l’événement que vous voulez générer dans cet assistant. Ainsi, l'intention qui attend eventName en entrée sera déclenchée, et pourra accéder au corps ainsi qu'aux headers de la requête HTTP de deux façons :

1. En déclarant 2 variables headers et payload de type ggwg/any
2. En appelant une fonction qui pourra accéder aux mêmes variables mais depuis l'objet request qu'elle reçoit automatiquement en premier paramètre :

‍

Cette fonction peut alors parcourir la requête transmise par l'outil externe pour la transformer en une réponse visuelle (que l'administrateur pourrait consulter depuis l'écran Conversations), re-transmettre sous la forme d'une requête HTTP, stocker dans une collection, ...

Dans notre cas, nous allons utiliser une fonction disponible sur le store public pour répondre à un usager de Crisp un message généré par un assistant.

Intégrer Prisme.ai avec Crisp en utilisant les webhooks

a. Préparer le chat Crisp

1. Créer un compte Crisp Chat
2. Dans Settings > Paramètres de Site > Informations du site, s'assurer que le domaine correspond au domaine sur lequel sera hébergé le chat
3. Installer le chat Crisp sur le site web en question
4. Dans Settings > Paramètres de Site > Instructions d'installation, noter de côté l'ID du site

‍

b. Générer une clée d'API Crisp

1. Créer un compte Crisp Marketplace
2. Créer un plugin
3. Ouvrir l'onglet Tokens du plugin
4. Noter de côté l'Identifier et la Key de votre token de développement
5. Dans Settings > Trusted Website, ajouter l'ID du site noté en étape a.1, et authentifiez vous avec vos identifiants Crisp.chat

‍

c. Préparer l'assistant qui sera lié à Crisp

1. Créer une intention "CrispReply" avec pour événement d'entrée "CrispReply"
2. Appeler la fonction "Crisp - Reply" du store public en lui transmettant le Client Token de l'assistant (disponible dans le canal API), ainsi que l'Identifier et la Key précédemment notés
3. Enregistrer

‍

d. Ajouter le webhook Prisme.ai aux settings du chat Crisp

1. Écouter l'événement message:send uniquement
2. Indiquer l'URL suivante :
3. https://webhooks.prisme.ai/events/<prismeaiClientToken>/CrispReply
4. Remplacer <prismeaiClientToken> par le Client Token précédement fourni à la fonction Crisp - Reply

‍

Et voilà, tous les messages reçus par votre chat Crisp seront transférés à l'assistant Prisme.ai qui répondra directement à l'usager !