Salut à tous !
Bienvenue dans ce tutoriel sur la configuration d’un flux de travail d’automatisation avec Integromat, qui vous permettra de recevoir automatiquement une notification par e-mail à chaque fois qu’un nouvel utilisateur s’inscrit à votre communauté Discourse.
Pour connecter Discourse à Integromat, vous devez disposer d’un compte Integromat. Si vous n’en avez pas encore, vous pouvez vous inscrire ici.
Cette méthode utilise la fonctionnalité de webhooks proposée par Discourse. Vous devrez donc avoir un accès administrateur à votre communauté Discourse avant de commencer.
Une fois que vous avez un accès administrateur, la première chose à faire est de créer une nouvelle requête de webhook. Pour ce faire, cliquez sur l’icône de votre profil en haut à droite, puis, depuis l’onglet Profil, sélectionnez l’option Résumé.
Cela vous amènera à votre page de profil. Cliquez sur le bouton Admin pour accéder à la page d’administration.
Cliquez sur l’option API.
Sélectionnez l’onglet Webhooks, puis cliquez sur le bouton Nouveau webhook pour générer une nouvelle requête de webhook.
La page de configuration devrait ressembler à ceci.
Pour remplir ce formulaire, vous devrez générer un nouveau webhook Integromat qui sera utilisé pour recevoir les données envoyées par Discourse à chaque fois qu’un nouvel utilisateur s’inscrit à votre communauté.
Pour ce faire, connectez-vous à votre compte Integromat et créez un nouveau scénario.
Tout d’abord, vous devrez configurer un module de déclencheur, ou, en d’autres termes, le module qui déclenchera l’exécution de votre scénario. Dans ce cas, il s’agira d’un module webhook. Vous pouvez donc cliquer sur l’icône point d’interrogation et rechercher l’application Webhooks.
Cliquez sur l’application Webhooks et sélectionnez le module Webhook personnalisé.
Ensuite, créez un nouveau webhook afin que votre scénario puisse recevoir les données envoyées par Discourse. Pour ce faire, cliquez sur l’application Webhooks pour ouvrir sa fenêtre de configuration, puis cliquez sur le bouton Ajouter pour configurer un nouveau webhook.
Donnez un nom à votre webhook. Cela peut être n’importe quoi, par exemple, Webhook Discourse.
La prochaine étape consiste à cliquer sur l’option Afficher les paramètres avancés et à sélectionner l’option Obtenir les en-têtes de requête. Une fois cela fait, cliquez sur Enregistrer pour générer votre nouveau webhook.
Votre webhook devrait maintenant être visible. Il s’agit de l’URL mise en surbrillance en bleu. Cliquez sur le bouton Copier l’adresse dans le presse-papiers pour copier votre webhook, puis accédez à votre page de configuration de webhook Discourse.
Collez l’URL de votre webhook Integromat dans le champ URL de la charge utile.
Ensuite, sélectionnez l’option Événement utilisateur dans la liste et assurez-vous que tout le reste est désélectionné. Cela garantira que ce webhook ne recevra des données que sur la base d’événements spécifiques aux utilisateurs.
Enfin, sélectionnez les cases à cocher Vérifier le certificat TLS de l’URL de la charge utile et Actif à la fin de la page, puis cliquez sur le bouton Créer pour établir cette connexion entre votre communauté Discourse et votre webhook Integromat.
La nouvelle connexion devrait maintenant être visible sur la page Webhooks de votre compte Discourse.
La prochaine étape consiste à s’assurer que la connexion entre la communauté Discourse et votre webhook Integromat a bien été établie. Pour ce faire, cliquez sur Inactif.
Un petit menu semblable à celui-ci s’affichera. Cliquez simplement sur Ping, puis accédez à votre scénario Integromat pour vérifier si votre webhook a détecté avec succès cet événement.
Si c’est le cas, vous verrez un message indiquant Déterminé avec succès.
La prochaine étape consiste à vérifier si le webhook peut réellement recevoir des données de votre communauté Discourse. Pour ce faire, vous devez exécuter le scénario une fois en cliquant sur le bouton Exécuter une fois.
Une fois que le module webhook commence à tourner, accédez à votre communauté Discourse, déconnectez-vous, puis créez un nouveau compte utilisateur sur votre communauté. Une fois le nouvel utilisateur créé avec succès, le webhook devrait recevoir des données, ce qui ressemblera à ceci.
Cela vous aidera à vous assurer que le webhook peut réellement détecter de vrais événements (et non pas seulement des pings), et vous permettra également de mapper les éléments de données reçus à l’application e-mail plus tard dans ce tutoriel. Si votre webhook Integromat a détecté l’événement avec succès, le scénario aura été exécuté avec succès et devrait ressembler à ceci.
Maintenant que vous savez que le module webhook fonctionne comme prévu et que votre scénario Integromat se déclenche à chaque fois qu’un nouvel utilisateur est créé, il est temps d’étendre le scénario et de le configurer pour qu’il vous envoie automatiquement un e-mail contenant toutes les informations sur l’utilisateur.
La première étape consiste à attacher un module Itérateur au module de déclencheur webhook. Vous pouvez le trouver dans le menu Outils du générateur de scénarios. Nous expliquerons l’utilité de ce module plus tard.
Cliquez sur le module Itérateur pour ouvrir sa fenêtre de configuration.
Une fois que vous cliquez sur le champ Tableau, un menu s’ouvrira sur le côté gauche avec certains éléments de données récupérés à partir du module Webhooks. Faites simplement glisser et déposez l’élément de données appelé En-têtes dans le champ Tableau du module Itérateur. Il s’agira d’un tableau contenant de nombreuses valeurs.
La prochaine étape consiste à attacher l’application E-mail après l’application Itérateur. Cliquez sur l’icône plus et recherchez l’application E-mail. Une fois que vous l’avez trouvée, cliquez dessus pour sélectionner le module que vous souhaitez utiliser.
Sélectionnez le module Envoyer un e-mail dans la liste pour vous envoyer un e-mail à chaque fois qu’un nouvel utilisateur est créé dans votre communauté Discourse.
Avant de configurer le module E-mail, vous devez configurer un filtre entre les applications Itérateur et E-mail qui vous garantira de ne recevoir des e-mails que pour les utilisateurs qui s’inscrivent à votre communauté. Cela est nécessaire car Discourse, par défaut, déclenchera des requêtes de webhook pour toutes sortes d’activités utilisateurs.
Dans la fenêtre de configuration du filtre, vous devrez d’abord entrer un libellé. Cela peut être n’importe quoi, par exemple, Nouvel utilisateur.
Ensuite, vous devrez créer une condition qui déclenchera ce filtre. Dans le premier champ de la condition, mappez simplement l’élément de données Valeur du module Itérateur. Pour l’opérateur logique, sélectionnez Égal à. Enfin, dans le champ inférieur, entrez la valeur user_created.
Voici comment fonctionne cette condition :
Les données webhook que Integromat reçoit de Discourse à chaque fois qu’un utilisateur effectue une action contiennent un tableau En-têtes (un tableau est une collection de valeurs). Le rôle de l’itérateur est de récupérer chacune de ces valeurs individuellement afin qu’elles puissent être traitées et appliquées au filtre. Quelque part dans ce tableau de valeurs, il existe une valeur qui spécifie le type d’événement effectué par l’utilisateur. Comme l’événement qui nous intéresse s’appelle user_created (car cela indique que l’action effectuée par l’utilisateur était de créer un nouveau compte), nous devons configurer un filtre pour nous assurer que les valeurs d’en-tête des données webhook contiennent réellement cette valeur. Si c’est le cas, nous procédons à l’exécution des modules de scénario suivants. Sinon, l’exécution du scénario se termine rapidement et aucun e-mail n’est envoyé.
Une fois votre filtre configuré, vous pouvez cliquer sur le module E-mail pour ouvrir sa fenêtre de configuration.
La première chose à faire est de connecter le compte e-mail que vous souhaitez utiliser pour envoyer des e-mails. Si vous connectez votre Gmail, assurez-vous de suivre ce guide, qui explique le processus étape par étape.
Une fois votre e-mail connecté, vous pouvez procéder à la configuration des autres options du module e-mail.
Pour le champ À, vous pouvez cliquer sur Ajouter un destinataire et entrer l’adresse e-mail sur laquelle vous souhaitez recevoir ces mises à jour.
Pour l’objet, vous pouvez entrer n’importe quoi, et pour le type de contenu, vous pouvez sélectionner l’option Texte brut pour construire le message que vous souhaitez envoyer à chaque fois que ce module est exécuté.
Le champ Contenu est l’endroit où vous pouvez construire le message de l’e-mail. Ici, vous pouvez écrire du texte statique (c’est-à-dire un texte qui reste toujours le même à chaque exécution), mais vous pouvez également mapper des éléments de données dynamiques à partir du module webhook. Le webhook contient beaucoup de données sur l’utilisateur que vous pouvez utiliser, notamment son nom d’utilisateur, son nom, son e-mail, etc.
Et voilà ! Vous avez réussi à créer un scénario Integromat qui vous notifie à chaque fois qu’un nouvel utilisateur rejoint votre communauté Discourse.
Nous espérons que ce tutoriel vous a été utile ! Si vous avez des questions ou des recommandations sur ce que vous aimeriez voir ensuite, n’hésitez pas à nous le faire savoir dans les commentaires, soumettre un ticket à l’équipe de support d’Integromat ou consultez la communauté Facebook d’Integromat qui compte 10 000 membres.
Bon automatisation !
LIENS
Comment connecter Discourse à des centaines d’applications avec Integromat