Introduction

Zapier est un outil très connu dès qu'on parle d'automatisation de tâches, notamment pour la synchronisation de différents services tiers. Ici, on pousse cette automatisation encore plus loin en combinant Zapier et Prisme.ai.

‍

Cette combinaison peut se faire dans deux sens :

• Déclencher un traitement Zapier depuis Prisme.ai
• Déclencher un traitement Prisme.ai depuis Zapier

‍

Étant donné que Zapier et Prisme.ai proposent tous deux leur lot de services tiers connectables et différents degrés de configuration pour répondre à une plus grande variété de besoins, la combinaison des deux permet ainsi d'ouvrir encore plus de portes.

‍

Cet article vous expliquera comment :

• Déclencher un webhook Zapier depuis Prisme.ai
• Déclencher un workflow Prisme.ai depuis Zapier

Pour illustrer ces deux cas d'usages, nous prendrons le cas simpliste d'une synchronisation entre un formulaire de contact Prisme.ai et un document Google sheet répertoriant des données identiques.

Déclencher un webhook Zapier depuis Prisme.ai

D'abord, préparons le terrain :

1. Depuis votre Google Drive, créez une nouvelle Google Sheet zapierTest avec deux colonnes name et age

‍

2. Depuis Zapier, créez un nouveau Zap comme suit

Trigger

• Trigger: Webhooks by Zapier (réservé aux comptes Premium)
• Trigger Event : Catch Hook

• Cliquer sur Continue
• Noter de côté la Custom Webhook URL
  
  ‍

3. Passez maintenant à la partie Test trigger, qu'on laissera de côté pour le moment.
4. Ouvrez votre console Prisme.ai dans un nouvel onglet, sur l'éditeur de l'assistant qui ira appeler Zapier
5. Créez une intention send_user_form
6. Ajoutez deux questions demandant le nom puis l'âge de l'utilisateur, en stockant ces informations dans deux paramètres de sortie name et age
7. Ajoutez une troisième étape pour appeler la fonction Zapier - Call Webhook du store publique
8. Indiquez l'URL notée à l'étape 2 dans le champs url
9. Indiquez POST dans le champ method
10. Enregistrez la fonction, ajouter éventuellement un message de validation en 4ème étape puis ouvrir l'onglet Manifeste
11. Au niveau du call function de l'intention send_user_form, ajoutez les 2 paramètres sous un champ payload, comme suit (lignes 123-125):

12. Enregistrez votre assistant, puis testez l'intention
13. Une fois le message de confirmation affiché par le bot, retournez sur l'onglet Zapier
14. Dans l'onglet Test trigger, déroulez la liste des requêtes et cliquez sur Load more. Une nouvelle requête devrait être apparue, contenant les valeurs renseignées depuis l'assistant. Sélectionnez-la :

15. Après avoir cliqué sur Continue, il est temps de passer à la configuration de l'Action !

‍

Action

1. Choose app & event : Sélectionner l'app Google Sheet et l'événement Create Spreadsheet Row
2. Choose account : connecter votre compte
3. Set up action :

• Sélectionnez la spreadsheet zapierTest
• Sélectionnez la Worksheet Sheet1
• Cliquez sur Refresh fields : 2 champs name et age devraient apparaître.

• En cliquant sur chacun de ces champs, sélectionnez la valeur correspondante, extraite depuis la requête précedemment sélectionnée.

4. Enfin, dans Test action, vous pouvez tester l'action avant d'activer le Zap : les valeurs précédemment envoyées depuis l'assistant devraient alors être ajoutées dans une nouvelle ligne de votre spreadsheet.

A partir de là, à chaque fois que le même parcours est fait depuis l'assistant, une ligne similaire sera insérée à la fin de votre spreadsheet !

Déclencher un workflow Prisme.ai depuis Zapier

Regardons maintenant la connexion inverse !

‍

Configuration Prisme.ai

Sur le même assistant que tout à l'heure, commençons par créer une intention très simple qui recevra les informations depuis un appel de Zapier :

1. Nommez la triggered_by_zapier, et ajoutez lui un événement d'entrée triggered_by_zapier
2. Ajoutez 2 variables (Logique) respectivement nommées headers et payload (entité ggwg/any). headers est optionnel, puisqu'il permettra simplement de consulter les headers de la requête transmise par Zapier (peut être utilisé à des fins d'authentification)
3. Ajoutez ensuite 2 messages affichant ces mêmes variables

4. Enregistrez, votre assistant est prêt !
5. Depuis l'écran Canaux > API, notez de côté le Prisme.ai Client Token

Comme on ne fait aucun traitement avec ces données, notre seul moyen pour vérifier la bonne réception des informations sera de consulter l'historique des Conversations.

Il aurait aussi été possible de stocker ces informations dans une collection, ou de les lire directement depuis une fonction (accessibles par la variable request.userMessage.payload[0]).

‍

Configuration Zapier

Créez un nouveau Zap comme suit :

‍

Trigger

• Trigger: Google Sheets
• Trigger Event : New Spreadsheet Row

• Cliquez sur Continue
• Choose account : connectez votre compte
• Set up trigger : sélectionnez la spreadsheet zapierTest ainsi que la Worksheet Sheet1
• Test trigger : vérifiez le bon fonctionnement du trigger en ajoutant manuellement une ligne à votre fichier. Celle-ci doit apparaître côté Zapier après avoir cliqué sur Load more dans la liste déroulante des lignes

Action

1. Choose app & event : sélectionnez l'app Prisme.ai et l'événement Call Webhook
2. Choose account : connectez votre compte
3. Set up action :

• Assistant Token : renseignez le token copié à l'étape 5 de la configuration Prisme.ai
• Event : triggered_by_zapier (sauf si un event différent à été indiqué)
• Payload : ajoutez 2 champs name et age, en récupérant les colonnes correspondantes côté spreadsheet

4. Enfin, dans Test action, vous pouvez tester l'action avant d'activer le Zap : la dernière ligne ajoutée dans le spreadsheet devrait être transmise à votre assistant, comme vous pouvez le constater depuis l'écran Conversations de votre console Prisme.ai

Veuillez noter que Google peut la propagation des mises à jour depuis le document vers votre assistant peut être soumise à quelques latences, qui dépendent entièrement des régulations appliquées par Google et Zapier à leur traffic.

‍

À présent, toutes les lignes manuellement insérées dans le document sont propagées à Prisme.ai, et vice-versa !