Connectez FastComments à Zapier

Connectez votre compte

1. Dans Zapier, ajoutez une étape FastComments à un Zap, ou ouvrez la page de l'application FastComments dans le répertoire d'applications Zapier.
2. Choisissez Sign in to FastComments. Zapier vous demande d'abord votre région : choisissez United States sauf si votre compte a été créé sur la région UE (eu.fastcomments.com).
3. Une fenêtre FastComments s'ouvre. Connectez‑vous si vous n'êtes pas déjà connecté.
4. Examinez la page de consentement. Elle montre l'application Zapier, le compte auquel elle sera connectée, et les autorisations demandées (lecture et écriture). Choisissez Approve.
5. Zapier enregistre la connexion et l'étiquette avec le nom de votre site et votre nom d'utilisateur.

La connexion utilise OAuth. Aucune clé API n'est copiée dans Zapier, et le jeton détenu par Zapier ne fonctionne que pour le compte que vous avez approuvé.

Qui peut se connecter

La personne qui approuve la connexion doit être un API admin sur le compte FastComments. Les propriétaires de compte ont cette permission ; d'autres membres de l'équipe peuvent se la voir attribuer sur la page Utilisateurs. Quelqu'un qui ne l'a pas voit une page « you do not have permission » au lieu du formulaire de consentement.

Connecter le bon site

La page de consentement connecte le compte auquel vous êtes actuellement connecté. Si vous gérez plusieurs comptes, passez au bon depuis le sélecteur de compte avant d'approuver, ou utilisez le lien switch account sur la page de consentement. L'étiquette de connexion dans Zapier affiche le nom du site, donc un mauvais choix est facile à repérer.

Examiner et révoquer l'accès

Chaque connexion apparaît sous Connected Apps dans le tableau de bord FastComments, avec les autorisations qu'elle possède et la dernière fois qu'elle a été utilisée. La révoquer là déconnecte Zapier immédiatement ; tout Zap utilisant cette connexion s'arrête jusqu'à ce qu'elle soit reconnectée. Vous pouvez également supprimer la connexion du côté Zapier sous My Apps.

Déclencheurs

Les déclencheurs démarrent un Zap lorsqu'un événement se produit dans FastComments. Les trois sont instantanés : FastComments transmet l'événement à Zapier via un webhook dès qu'il se produit. Aucun processus n'interroge votre compte et aucun crédit API n'est dépensé en attente.

Chaque déclencheur renvoie le commentaire complet : id, URL de la page et ID d'URL, nom et e‑mail du commentateur, texte du commentaire en markdown et en HTML, nombre de votes, indicateurs d'approbation et de spam, la langue, le domaine et les mentions éventuelles. Les champs correspondent à la charge utile du webhook documentée sous Webhooks, Structures de données.

Options

Domaine. Chaque déclencheur possède un filtre de domaine optionnel, listant les domaines configurés sur votre compte. Laissez‑le vide pour recevoir les événements de tous les domaines.

Inclure les commentaires non approuvés et les spams. Uniquement sur le déclencheur Nouveau commentaire. Les commentaires en attente de modération ou marqués comme spam sont ignorés par défaut. Lorsqu'un tel commentaire est approuvé ultérieurement, le déclencheur Commentaire mis à jour se déclenche pour celui‑ci, de sorte qu'un Zap qui doit réagir à chaque commentaire devenu visible utilise Commentaire mis à jour avec un filtre sur le champ approuvé.

Fonctionnement de la livraison

Activer un Zap crée une souscription webhook sur votre compte, visible sur la page Webhooks avec la source API. Désactiver le Zap la supprime. Les limites propres à Zapier s'appliquent au nombre d'événements qu'il accepte par minute ; FastComments réessaye une livraison qui échoue, avec un délai croissant, et désactive une souscription qui continue d'échouer pendant six jours. Une souscription désactivée peut être réactivée depuis la page Webhooks, ou il suffit de désactiver puis réactiver le Zap pour en créer une nouvelle.

Un compte peut contenir jusqu'à 50 souscriptions API. Chaque Zap utilisant un déclencheur FastComments en utilise une.

Actions et recherches

Les actions créent des données dans FastComments ; les recherches recherchent des données afin qu’une étape ultérieure puisse les utiliser. Chaque action appelle l’API REST de FastComments et consomme les mêmes crédits API que l’appel coûterait depuis votre propre code : un crédit par appel, sauf indication contraire.

Créer un commentaire

Publie un commentaire sur une page.

Créer une page

Crée un enregistrement de page avant qu’aucun commentaire n’existe dessus, afin qu’il puisse être listé et restreint. Prend l’ID d’URL, le titre, l’URL, et éventuellement les IDs de groupe SSO autorisés à le voir.

Créer un utilisateur SSO

Crée un utilisateur d’authentification unique (SSO). Prend votre propre ID d’utilisateur, nom d’utilisateur et e‑mail, ainsi que, en option, le nom d’affichage, le libellé d’affichage, l’avatar, le site web, les IDs de groupe, ainsi que les indicateurs de notification et de confidentialité. Les rôles administratifs ne peuvent pas être accordés depuis Zapier.

Créer un article de flux

Crée un article dans un flux FastComments à partir de contenu HTML, avec un titre, un auteur, des tags et un aperçu de lien optionnels.

Créer un hashtag

Crée un hashtag que les commentateurs peuvent utiliser, avec une URL optionnelle vers laquelle il pointe.

Signaler un commentaire

Signale un commentaire pour révision par un modérateur. Fournissez l’ID de l’utilisateur qui signale, ou laissez vide pour signaler en tant qu’intégration Zapier.

Recherches

Une recherche qui ne trouve rien ne fait pas échouer le Zap. Combinez une recherche avec une création dans le mode « trouver ou créer » de Zapier pour créer la page ou l’utilisateur lorsqu’il manque.

Exemples de Zaps

Quelques flux de travail qui ne prennent que quelques minutes à configurer.

Recevez une notification pour les nouveaux commentaires. New Comment, then Slack "Send Channel Message" or Discord "Send Channel Message". Mappez le nom du commentateur, le texte du commentaire et l'URL de la page dans le message. Ajoutez le filtre de domaine pour notifier un canal différent par site.

Conservez un journal de chaque commentaire. New Comment, then Google Sheets "Create Spreadsheet Row". Ajoutez Deleted Comment comme un deuxième Zap qui ajoute une ligne avec l'ID du commentaire, de sorte que la feuille serve également de piste d'audit.

Envoyez un e‑mail à l'auteur lorsqu'un commentaire est approuvé. Updated Comment with a Zapier filter on Approved is true, then Gmail "Send Email". Parce que Updated Comment se déclenche à chaque modification, le filtre est ce qui fait que ce Zap réagit uniquement aux approbations.

Ajoutez les commentateurs à votre CRM ou liste de diffusion. New Comment, then HubSpot "Create or Update Contact" or Mailchimp "Add or Update Subscriber" en utilisant l'e‑mail du commentateur. Respectez votre politique de confidentialité et la législation locale avant d'ajouter quiconque à une liste marketing.

Créez un commentaire à partir d'un formulaire. Typeform ou Google Forms "New Response", then FastComments Create Comment avec l'ID d'URL de page que votre site utilise pour les témoignages. Laissez Approved décoché pour examiner chaque commentaire avant qu'il n'apparaisse.

Publiez des annonces dans un flux. RSS by Zapier "New Item in Feed", then Create Feed Post avec le titre, le contenu et le lien de l'élément.

Provisionnez les membres en tant qu'utilisateurs SSO. Memberstack, Memberful, ou votre propre webhook, then Find SSO User suivi par Create SSO User en mode "find or create".

Escaladez les commentaires signalés. Updated Comment, filtré sur un nombre de drapeaux supérieur à zéro, then Trello "Create Card" ou Linear "Create Issue" avec l'ID du commentaire et un lien vers la page de modération.

Publiez les pages dès qu'elles sont en ligne. WordPress ou Ghost "New Post", then Create Page avec l'URL de l'article, de sorte que la page soit répertoriée et restreinte avant le premier commentaire.

Archivez les commentaires supprimés. Deleted Comment, then Airtable "Create Record" avec le commentaire complet pour la rétention conforme.

Dépannage

"Vous n'avez pas la permission" lors de la connexion. L'utilisateur connecté n'est pas un administrateur API sur le compte.
Demandez au propriétaire du compte d'accorder la permission API sur la page Utilisateurs, ou connectez‑vous en tant que propriétaire.

La connexion est étiquetée avec le mauvais site. La page de consentement connecte le compte avec lequel vous étiez
connecté au moment. Déconnectez‑vous dans Zapier, changez de compte dans le tableau de bord FastComments, puis reconnectez‑vous.

Les événements ont cessé d'arriver. Vérifiez la page Webhooks dans le tableau de bord. Un abonnement dont le point de terminaison a
échoué pendant six jours est désactivé automatiquement et indique la raison. Réactivez‑le là‑bas, ou désactivez et réactivez le Zap
à nouveau. Si l'abonnement est complètement absent, quelqu'un l'a supprimé ; désactiver et réactiver le Zap le recrée.

Zapier indique que le compte doit être reconnecté. La connexion a été révoquée depuis la page Applications connectées
, l'utilisateur qui l'a approuvée a perdu la permission API, ou le compte a été supprimé. Reconnectez‑vous depuis Zapier.

Une action échoue avec "n'a pas d'accès en écriture". La connexion a été approuvée avec une permission en lecture seule
. Reconnectez‑vous et approuvez les deux permissions.

Limites de débit et crédits. Les actions et recherches consomment des crédits API de votre forfait et sont soumises aux
mêmes limites de débit que l'API REST. Les déclencheurs n'en consomment aucun. Un Zap qui atteint une limite est réessayé par Zapier
après le délai indiqué par FastComments.

Le menu déroulant Domaine est vide. Les domaines apparaissent une fois configurés sur la page Domaines du
tableau de bord FastComments. Laissez le champ vide pour recevoir les événements de tous les domaines.