Verbind FastComments met Zapier
De FastComments-app voor Zapier verbindt uw opmerkingen met duizenden andere apps zonder code te schrijven.
Gebruik het om een Slack-bericht te plaatsen wanneer iemand een opmerking maakt, elke opmerking naar een spreadsheet te loggen, een opmerking te maken vanuit een formulierinzending, of commentatoren toe te voegen aan uw CRM. Triggers worden geactiveerd op het moment dat er iets gebeurt, omdat ze worden ondersteund door webhooks in plaats van polling, en acties roepen de FastComments API namens u aan.
Deze gids gaat ervan uit dat u een FastComments-account heeft. U kunt er hier een aanmaken.
Deze gids behandelt het gebruik van de Zapier-app. De eindpunten die het aanroept, samen met de aanvraag- en responsformaten en de OAuth stroom achter de verbinding, zijn gedocumenteerd in de API-referentie.
Verbind uw account 
Verbind uw account
- Voeg in Zapier een FastComments‑stap toe aan een Zap, of open de FastComments‑app‑pagina in de Zapier‑app‑directory.
- Kies Sign in to FastComments. Zapier vraagt eerst om uw regio: kies United States tenzij uw account is aangemaakt in de EU‑regio (
eu.fastcomments.com). - Er wordt een FastComments‑venster geopend. Meld u aan als u nog niet bent aangemeld.
- Bekijk de toestemmingspagina. Deze toont de Zapier‑applicatie, het account waarmee deze wordt verbonden, en de gevraagde rechten (lezen en schrijven). Kies Approve.
- Zapier slaat de verbinding op en labelt deze met uw sitenaam en gebruikersnaam.
De verbinding maakt gebruik van OAuth. Er wordt geen API‑sleutel naar Zapier gekopieerd, en het token dat Zapier bezit werkt alleen voor het account dat u heeft goedgekeurd.
Wie kan verbinden
De persoon die de verbinding goedkeurt moet een API‑admin zijn op het FastComments‑account. Account‑eigenaren hebben deze toestemming; andere teamleden kunnen deze krijgen op de pagina Gebruikers. Iemand zonder deze toestemming ziet een “you do not have permission”‑pagina in plaats van het toestemmingsformulier.
De juiste site verbinden
De toestemmingspagina verbindt met het account waarmee u momenteel bent aangemeld. Als u meerdere accounts beheert, schakelt u vóór het goedkeuren naar het juiste account via de account‑wisselaar, of gebruikt u de link switch account op de toestemmingspagina. Het verbindingslabel in Zapier toont de sitenaam, zodat een verkeerde keuze gemakkelijk te herkennen is.
Toegang bekijken en intrekken
Elke verbinding verschijnt onder Connected Apps in het FastComments‑dashboard, met de rechten die het heeft en wanneer het voor het laatst is gebruikt. Het intrekken daarvan verbreekt Zapier onmiddellijk; elke Zap die die verbinding gebruikt, stopt totdat deze opnieuw wordt verbonden. U kunt de verbinding ook aan de Zapier‑kant verwijderen onder My Apps.
Triggers
Triggers
Triggers starten een Zap wanneer er iets gebeurt in FastComments. Alle drie zijn onmiddellijk: FastComments levert het evenement aan Zapier via een webhook op het moment dat het gebeurt. Er wordt niets gepolld op uw account en er worden geen API‑credits besteed aan wachten.
| Trigger | Wordt geactiveerd wanneer |
|---|---|
| Nieuwe reactie | Een reactie wordt geplaatst. Standaard worden alleen goedgekeurde, niet‑spam reacties geactiveerd. |
| Bijgewerkte reactie | Een reactie wordt bewerkt, goedgekeurd, beoordeeld, vastgezet, vergrendeld, of op een andere manier gewijzigd. |
| Verwijderde reactie | Een reactie wordt verwijderd. |
Elke trigger retourneert de volledige reactie: id, pagin URL en URL‑ID, naam en e‑mail van de reageerder, de reactietekst als markdown en als HTML, stemtellingen, goedkeurings‑ en spam‑vlaggen, de locale, het domein en eventuele vermeldingen. De velden komen overeen met de webhook‑payload die gedocumenteerd is onder Webhooks, Data Structures.
Opties
Domein. Elke trigger heeft een optioneel domeinfilter, waarin de domeinen staan die op uw account zijn geconfigureerd. Laat het leeg om gebeurtenissen van elk domein te ontvangen.
Include Unapproved and Spam Comments. Alleen op de Nieuwe reactie‑trigger. Reacties die in de wacht staan voor moderatie of als spam gemarkeerd zijn, worden standaard overgeslagen. Wanneer zo’n reactie later wordt goedgekeurd, wordt de Bijgewerkte reactie‑trigger geactiveerd voor die reactie, zodat een Zap die op elke zichtbaar wordende reactie moet reageren, de Bijgewerkte reactie gebruikt met een filter op het goedgekeurd‑veld.
Hoe levering werkt
Het inschakelen van een Zap maakt een webhook‑abonnement aan op uw account, zichtbaar op de Webhooks‑pagina met de bron API. Het uitschakelen van de Zap verwijdert dit. De eigen limieten van Zapier gelden voor het aantal evenementen dat per minuut wordt geaccepteerd; FastComments probeert een levering die mislukt opnieuw, met een toenemende vertraging, en schakelt een abonnement uit dat zes dagen lang blijft falen. Een uitgeschakeld abonnement kan opnieuw worden ingeschakeld vanaf de Webhooks‑pagina, of schakel de Zap eenvoudig uit en weer in om een nieuw abonnement te maken.
Een account kan maximaal 50 API‑abonnementen bevatten. Elke Zap die een FastComments‑trigger gebruikt, gebruikt er één.
Acties en zoekopdrachten
Acties en Zoekopdrachten
Acties maken data aan in FastComments; zoekopdrachten zoeken data op zodat een latere stap deze kan gebruiken. Elke actie roept de FastComments REST API aan en verbruikt dezelfde API‑credits die de oproep vanuit je eigen code zou kosten: één credit per oproep tenzij anders vermeld.
Commentaar Aanmaken
Plaatst een commentaar op een pagina.
| Veld | Verplicht | Opmerkingen |
|---|---|---|
| Pagina‑URL‑ID | Ja | De URL‑ID die de commentaarwidget op de pagina gebruikt. Commentaren worden hierop gegroepeerd. |
| Pagina‑URL | Ja | De volledige pagina‑URL, gebruikt in notificatie‑e‑mails. |
| Commentaar | Ja | De commentaartekst in FastComments markdown. |
| Naam van de commentator | Ja | Namen zijn uniek per e‑mail, dus het hergebruiken van een naam met een andere e‑mail mislukt. |
| E‑mail van de commentator | Nee | Er wordt een gebruiker aangemaakt voor het e‑mailadres wanneer deze nog niet bestaat. |
| Gebruikers‑ID | Nee | Een bestaand SSO‑gebruikers‑ID. Heeft voorrang boven de naam en e‑mail. |
| Bovenliggend commentaar‑ID | Nee | Instellen om een antwoord te plaatsen. |
| Goedgekeurd, Geverifieerd | Nee | Beide standaard op true. Niet‑goedgekeurde commentaren blijven verborgen tot moderatie. |
| Geplaatst op | Nee | Standaard op nu. |
| Avatar‑URL, Paginatitel, Taalinstelling | Nee | Taalinstelling standaard en_us. |
| Live weergeven in widget | Nee | Stuurt het commentaar in realtime naar kijkers. Kost 2 credits in plaats van 1. |
| Spamcontrole uitvoeren, E‑mails verzenden | Nee | Standaard uitgeschakeld. |
Pagina Aanmaken of Bijwerken
Maakt een paginarecord aan voordat er commentaren op bestaan, zodat deze kan worden weergegeven en beperkt. Neemt de URL‑ID, titel, URL en optioneel de SSO‑groeps‑IDs die het mogen zien. Als een pagina met die URL‑ID al bestaat, wordt deze bijgewerkt met de opgegeven velden, zodat een Zap herhaaldelijk voor dezelfde pagina kan draaien.
SSO‑gebruiker Aanmaken of Bijwerken
Maakt een single sign‑on‑gebruiker aan. Neemt je eigen gebruikers‑ID, gebruikersnaam en e‑mail, plus optioneel weergavenaam, weergavelabel, avatar, website, groeps‑IDs, en notificatie‑ en privacy‑vlaggen. Als een gebruiker met dat ID al bestaat, wordt deze in plaats daarvan bijgewerkt. Administratieve rollen kunnen niet via Zapier worden toegekend.
Feed‑bericht Aanmaken
Maakt een bericht in een FastComments‑feed aan vanuit HTML‑inhoud. Het auteur‑gebruikers‑ID is vereist (een FastComments‑ of SSO‑gebruikers‑ID); titel, tags en één link‑preview zijn optioneel.
Hashtag Aanmaken of Bijwerken
Maakt een hashtag aan die commentatoren kunnen gebruiken, met een optionele URL waarnaar deze linkt. Als de tag al bestaat, wordt deze bijgewerkt.
Commentaar Markeren
Markeert een commentaar voor moderatie‑review. Het ID van de gebruiker die de markering uitvoert is vereist; het auteur‑ID dat wordt geretourneerd door Create Comment werkt.
Zoekopdrachten
| Zoekopdracht | Invoer | Retourneert |
|---|---|---|
| Vind Commentaar | Commentaar‑ID | Het commentaar, of niets. |
| Vind SSO‑gebruiker | E‑mail | De SSO‑gebruiker, of niets. |
| Vind Pagina | URL‑ID | De pagina, of niets. |
Een zoekopdracht die niets vindt, veroorzaakt geen fout in de Zap. Find SSO User en Find Page bieden Zapier’s “create if it doesn’t exist”‑optie, die de bijbehorende aanmaak uitvoert wanneer er niets wordt gevonden.
Voorbeeld Zaps
Voorbeeld Zaps
Een paar workflows die in enkele minuten zijn opgezet.
Ontvang een melding over nieuwe reacties. Nieuwe reactie, dan Slack "Send Channel Message" of Discord "Send Channel Message". Koppel de naam van de reageerder, de reactietekst en de pagin URL in het bericht. Voeg de domeinfilter toe om een ander kanaal per site te informeren.
Houd een log bij van elke reactie. Nieuwe reactie, dan Google Sheets "Create Spreadsheet Row". Voeg Deleted Comment toe als een tweede Zap die een rij toevoegt met de reactie‑id, zodat het blad tevens dient als audit‑trail.
E‑mail de auteur wanneer een reactie is goedgekeurd. Updated Comment met een Zapier‑filter op Approved is true, dan Gmail "Send Email". Omdat Updated Comment bij elke wijziging wordt geactiveerd, zorgt het filter ervoor dat deze Zap alleen reageert op goedkeuringen.
Voeg reageerders toe aan je CRM of mailinglijst. Nieuwe reactie, dan HubSpot "Create or Update Contact" of Mailchimp "Add or Update Subscriber" met het e‑mailadres van de reageerder. Houd rekening met je privacybeleid en lokale wetgeving voordat je iemand aan een marketinglijst toevoegt.
Maak een reactie vanuit een formulier. Typeform of Google Forms "New Response", dan FastComments Create Comment met de pagina‑URL‑ID die je site gebruikt voor testimonials. Laat Approved uitgevinkt zodat je elke reactie kunt beoordelen voordat deze verschijnt.
Plaats aankondigingen in een feed. RSS by Zapier "New Item in Feed", dan Create Feed Post met de titel, inhoud en link van het item.
Voorzie leden van SSO‑gebruikers. Memberstack, Memberful, of je eigen webhook, dan Find SSO User gevolgd door Create SSO User in "find or create"‑modus.
Escaleer gerapporteerde reacties. Updated Comment, gefilterd op een vlag‑aantal hoger dan nul, dan Trello "Create Card" of Linear "Create Issue" met de reactie‑id en een link naar de moderatiepagina.
Publiceer pagina's zodra ze live gaan. WordPress of Ghost "New Post", dan Create Page met de post‑URL, zodat de pagina wordt vermeld en beperkt voordat de eerste reactie verschijnt.
Archiveer verwijderde reacties. Deleted Comment, dan Airtable "Create Record" met de volledige reactie voor nalevingsbewaring.
Probleemoplossing
Troubleshooting
"U heeft geen toestemming" bij het verbinden. De aangemelde gebruiker is geen API-beheerder op het account.
Vraag de accounteigenaar om de API-rechten toe te kennen op de Users‑pagina, of verbind als de eigenaar.
De verbinding is gelabeld met de verkeerde site. De toestemmingspagina verbindt met het account waarmee u op dat moment bent aangemeld. Ontkoppel in Zapier, wissel van account in het FastComments‑dashboard, en verbind opnieuw.
Evenementen komen niet meer binnen. Controleer de Webhooks‑pagina in het dashboard. Een abonnement waarvan het eindpunt zes dagen achter elkaar faalde, wordt automatisch uitgeschakeld en toont de reden. Schakel het daar opnieuw in, of zet de Zap uit en weer aan. Als het abonnement volledig ontbreekt, heeft iemand het verwijderd; het uit‑ en aanzetten van de Zap maakt het opnieuw aan.
Zapier zegt dat het account opnieuw moet worden verbonden. De verbinding is ingetrokken vanaf de Connected Apps‑pagina, de gebruiker die het heeft goedgekeurd verloor de API‑toestemming, of het account is verwijderd. Maak opnieuw verbinding vanuit Zapier.
Een actie mislukt met "heeft geen schrijfrechten". De verbinding was goedgekeurd met alleen‑lezen rechten. Maak opnieuw verbinding en keur beide rechten goed.
Rate limits en credits. Acties en zoekopdrachten gebruiken API‑credits van uw abonnement en vallen onder dezelfde rate limits als de REST API. Triggers gebruiken geen credits. Een Zap die tegen een limiet aanloopt, wordt door Zapier opnieuw geprobeerd na de vertraging die FastComments meldt.
De vervolgkeuzelijst Domein is leeg. Domeinen verschijnen zodra ze zijn geconfigureerd op de Domains‑pagina in het FastComments‑dashboard. Laat het veld leeg om gebeurtenissen voor elk domein te ontvangen.