Exemple d'utilisation : Zapier

Nous allons ici voir comment utiliser les webhooks de Cards avec Zapier, pour déclencher des évènements personnalisés sur des outils externes.

Que souhaitons nous faire ?

Pour notre exemple, nous allons faire en sorte qu'un email soit envoyé à chaque fois qu'un apprenant termine une formation.

Nous allons pouvoir personnaliser le mail pour faire remonter automatiquement des informations et données dans l'email.

Configuration côté Zapier

La 1ère étape consiste à créer un "zap" sur Zapier. En démarrant par un "zap" vierge, vous pouvez alors choisir un "trigger", c'est-à-dire un évènement déclencheur.

Cliquez sur "Trigger" : il faut alors chercher "Webhook" dans la fenêtre qui s'affiche et sélectionner "Webhooks by Zapier".

Vous pouvez maintenant configurer votre point d'entrée :

onglet "App & event" : choisir l'event "Catch Hook"
onglet "Trigger" : laisser vide, pour que Zapier reçoive toutes les données arrivant de Cards
onglet "Test" : Zapier vous affiche l'url webhook. Copiez cette url, il faut aller la configurer dans Cards.

Configurer le webhook côté Cards

Pour aller configurer le webhook sur Cards, utiliser le menu "mon compte" en haut à droite, puis cliquez sur "Intégrations".

Il faut que vous soyez propriétaire de l'espace sur Cards pour avoir accès à ce menu et à la configuration des webhooks.

Ensuite, allez sur la page "Webhooks", puis créez un nouveau webhook.

Dans le champ "endpoint", renseignez l'url fournie par Zapier. Et pour les évènements, sélectionnez l'évènement "training-complete".

Renseignez une description si vous le souhaitez, puis cliquez sur "Enregistrer".

Tester la connexion avec Zapier

L'étape suivante consiste à valider que la connexion fonctionne bien entre Cards et Zapier.

Dans Zapier, vous verrez que votre onglet "Test" a un bouton "Test trigger". Si vous cliquez dessus, rien ne va se passer : c'est normal, il faut qu'un évènement "training-complete" soit d'abord envoyé pour que Zapier le reçoive !

Et donc : direction Cards, côté apprenant, pour compléter une formation jusqu'au bout.

Une fois la formation terminée, retournez dans Zapier, et cliquez à nouveau sur le bouton "Test trigger". Cette fois vous devriez voir des informations remonter !

Vous pouvez cliquer sur "Continue with selected record" :)

Choisir l'action à déclencher

On peut maintenant configurer l'action à effectuer quand Zapier reçoit notre évènement.

Nous allons ici choisir d'envoyer un mail via Gmail. Choisissez donc "Gmail" dans la liste des applications. Puis sélectionnez l'event "Send email" :

L'étape d'après vous permet de connecter votre compte Gmail, pour que les emails envoyés partent de votre adresse mail.

Une fois connecté, vous pouvez configurer l'action, avec notamment les champs les plus importants :

to : pour décider à qui envoyer l'email
from : depuis quelle adresse envoyer l'email
subject : le sujet de votre email
body : le contenu de votre email

Et c'est là que ça devient intéressant ! En effet, Cards vous envoi le détails des évènements avec de nombreuses informations. Vous pouvez notamment récupérer le prénom, le nom, le score de l'apprenants. Mais aussi le titre de la formation ou sa description.

Avec Zapier, vous pouvez utiliser ces valeurs pour personnaliser l'email.

Voici un exemple de configuration pour le contenu :

Pour connaître toutes les infos envoyées par les évènements, rendez-vous sur la page "Détails des évènements".