Zapier propose plusieurs modèles officiels de zaps pour Discourse. Ces modèles permettent de connecter Discourse à une application externe avec une configuration minimale. Vous pouvez les trouver ici :
Faites défiler la page vers le bas pour voir la liste des intégrations actuellement disponibles.
Ces modèles sont divisés en deux catégories. Dans la première catégorie, Discourse est l’application déclencheuse. Ces modèles vous permettent de publier des messages de Discourse sur Slack, Mattermost, Discord, des groupes Facebook, des pages Facebook, Google Sheets et d’autres services. Dans la deuxième catégorie de modèles, Discourse est l’application action. Avec ces modèles, vous pouvez publier des messages depuis WordPress et Ghost vers Discourse. Il existe également un modèle pour publier des flux en direct Twitch sur Discourse.
Ajout de vos identifiants Discourse sur Zapier
Pour utiliser l’une des intégrations Zapier Discourse, vous devrez ajouter l’URL de base de votre forum, ainsi que votre nom d’utilisateur Discourse et votre clé API lors de la configuration initiale du Zap.
Dans la plupart des cas, le Zap doit être configuré par un administrateur du site en utilisant son nom d’utilisateur Discourse et sa clé API. Les clés API peuvent être créées dans Discourse depuis la page Admin / API / Clés. Notez que la valeur complète de la clé API n’est affichée qu’une seule fois lors de la création de la clé, alors assurez-vous de la copier à ce moment-là.
Après avoir ajouté vos identifiants Discourse à Zapier, cliquez sur le bouton Continuer. Vous devriez voir un message de succès s’afficher à l’écran.
Configuration des messages que le Zap récupérera
Lorsque Discourse est l’application déclencheuse, par défaut, tous les nouveaux messages de votre site déclencheront le Zap. Vous pouvez limiter le Zap pour qu’il ne se déclenche que pour les messages créés dans un sujet spécifique, ou uniquement pour les messages créés par un utilisateur spécifique, dans l’étape facultative « Modifier les options ».
Utilisez le menu déroulant Sujet de l’étape pour sélectionner un sujet spécifique qui doit déclencher le Zap. Une fois configuré, seuls les messages créés dans le sujet choisi seront récupérés par Zapier. Utilisez le menu déroulant Auteur de l’étape pour sélectionner un nom d’utilisateur pour le Zap. Une fois configuré, seuls les messages créés par cet utilisateur seront récupérés par Zapier.
Ajout d’une étape de filtre pour un contrôle plus précis des messages
Si l’étape « Modifier les options » ne vous offre pas suffisamment de contrôle sur les messages utilisés pour déclencher le Zap, vous pouvez ajouter une étape de filtre facultative au Zap. Un exemple de ce qui peut être réalisé avec un filtre est de choisir de ne poursuivre le Zap que si le message est le premier message d’une catégorie spécifique. Pour ajouter un filtre, cliquez sur l’icône 
située sous le Déclencheur, puis sélectionnez « Filtre » dans le menu.
Le filtre vous permettra de définir les conditions dans lesquelles le Zap doit se poursuivre. L’exemple ci-dessous ne poursuivra que si le message est le premier message d’un sujet appartenant à la catégorie dont l’ID est 2.
Sélection du contenu Discourse à publier
Lors de la publication de messages de Discourse vers une autre application, Zapier vous permettra de sélectionner quelle partie du message vous souhaitez publier. Ce que vous choisissez de publier dépendra de l’application vers laquelle vous publiez. Je prendrai l’exemple de la publication d’un message Discourse vers un groupe Facebook.
Le champ Message du formulaire définit le contenu qui sera publié. Pour publier le contenu complet du message, sélectionnez le champ « Brut » (Raw) dans le menu déroulant Message. Pour publier uniquement le titre du sujet, sélectionnez « Titre du sujet » dans le menu déroulant.
Construction d’un lien vers un message ou un sujet
Lors de la publication d’un message Discourse vers une application externe, vous devrez peut-être construire un lien vers le message ou son sujet à partir des données renvoyées par Discourse. Pour ce faire, entrez l’URL de base de votre site dans le champ où vous ajoutez le lien, suivi de /t/. Par exemple, si l’URL de votre site est https://discourse.example.com, entrez https://discourse.example.com/t/ dans le formulaire.
Ouvrez maintenant le menu déroulant du champ et sélectionnez « Slug du sujet » dans le menu.
Zapier ajoutera un espace réservé pour le slug du sujet dans le champ.
Entrez maintenant une barre oblique (/) après l’espace réservé du slug du sujet, puis sélectionnez « ID du sujet » dans le menu déroulant.
Le résultat final ressemblera à la capture d’écran ci-dessous.
Pour construire un lien vers des messages spécifiques dans un sujet, ajoutez une autre barre oblique (/) au champ, puis sélectionnez « Numéro du message » dans le menu.
Notez que les valeurs de tous les espaces réservés que vous utilisez lors de la configuration du Zap seront remplacées par les valeurs transmises par Discourse lorsqu’un nouveau message sera publié.
Création d’intégrations sans modèle
Les modèles Zapier répertoriés sur leur page d’intégrations sont conçus pour faciliter la connexion de Discourse à une application externe. Si vous souhaitez connecter Discourse à une application qui ne dispose pas de modèle, ou si vous souhaitez créer un Zap qui écoute un webhook Discourse ou effectue une requête POST vers l’API Discourse, vous pouvez le faire en suivant ou en modifiant l’un des guides répertoriés ici :
.