FastComments mit Zapier verbinden
Die FastComments-App für Zapier verbindet Ihre Kommentare mit Tausenden anderer Apps, ohne Code zu schreiben.
Verwenden Sie sie, um eine Slack-Nachricht zu posten, wenn jemand kommentiert, jeden Kommentar in einer Tabelle zu protokollieren, einen
Kommentar aus einer Formularübermittlung zu erstellen oder Kommentatoren zu Ihrem CRM hinzuzufügen. Trigger werden ausgelöst, sobald etwas passiert,
weil sie durch Webhooks statt durch Polling unterstützt werden, und Aktionen rufen die FastComments-API in Ihrem
Namen auf.
Dieser Leitfaden geht davon aus, dass Sie ein FastComments-Konto haben. Sie können hier eines erstellen.
Dieser Leitfaden behandelt die Verwendung der Zapier-App. Die Endpunkte, die sie aufruft, zusammen mit den Anforderungs- und Antwortformaten sowie dem OAuth
Ablauf hinter der Verbindung, sind in der API-Referenz dokumentiert.
Konto verbinden 
Konto verbinden
- Fügen Sie in Zapier einen FastComments-Schritt zu einem Zap hinzu oder öffnen Sie die FastComments-App-Seite im Zapier App Directory.
- Wählen Sie Sign in to FastComments. Zapier fragt zuerst nach Ihrer Region: Wählen Sie United States, es sei denn, Ihr
Konto wurde in der EU-Region erstellt (
eu.fastcomments.com). - Ein FastComments-Fenster öffnet sich. Melden Sie sich an, falls Sie nicht bereits angemeldet sind.
- Prüfen Sie die Zustimmungsseite. Sie zeigt die Zapier-Anwendung, das Konto, mit dem sie verbunden wird, und die angeforderten Berechtigungen (Lesen und Schreiben). Wählen Sie Approve.
- Zapier speichert die Verbindung und beschriftet sie mit Ihrem Website-Namen und Benutzernamen.
Die Verbindung verwendet OAuth. Es wird kein API-Schlüssel in Zapier kopiert, und das Token, das Zapier hält, funktioniert nur für das Konto, das Sie genehmigt haben.
Wer eine Verbindung herstellen kann
Die Person, die die Verbindung genehmigt, muss ein API-Administrator auf dem FastComments-Konto sein. Kontoinhaber haben diese Berechtigung; andere Teammitglieder können sie auf der Benutzerseite erhalten. Jemand ohne diese Berechtigung sieht eine Seite mit der Meldung „Sie haben keine Berechtigung" anstelle des Zustimmungsformulars.
Die richtige Website verbinden
Die Zustimmungsseite verbindet das Konto, bei dem Sie aktuell angemeldet sind. Wenn Sie mehrere Konten verwalten, wechseln Sie vor der Genehmigung über den Konto-Umschalter zum richtigen Konto oder verwenden Sie den Link switch account auf der Zustimmungsseite. Das Verbindungslabel in Zapier zeigt den Website-Namen, sodass eine falsche Auswahl leicht zu erkennen ist.
Zugriff überprüfen und widerrufen
Jede Verbindung erscheint unter Connected Apps im FastComments-Dashboard, mit den Berechtigungen, die sie besitzt, und wann sie zuletzt verwendet wurde. Wenn Sie sie dort widerrufen, wird Zapier sofort getrennt; jeder Zap, der diese Verbindung verwendet, stoppt, bis sie wieder verbunden ist. Sie können die Verbindung auch von der Zapier-Seite unter My Apps entfernen.
Auslöser
Auslöser
Auslöser starten einen Zap, wenn etwas in FastComments passiert. Alle drei sind sofortig: FastComments liefert das Ereignis an Zapier über einen Webhook im Moment des Auftretens. Es wird nichts Ihr Konto abgefragt und es werden keine API-Guthaben für das Warten verbraucht.
| Auslöser | Wird ausgelöst, wenn |
|---|---|
| Neuer Kommentar | Ein Kommentar wird gepostet. Standardmäßig werden nur genehmigte, nicht‑Spam‑Kommentare ausgelöst. |
| Aktualisierter Kommentar | Ein Kommentar wird bearbeitet, genehmigt, abgestimmt, angeheftet, gesperrt oder anderweitig geändert. |
| Gelöschter Kommentar | Ein Kommentar wird gelöscht. |
Jeder Auslöser gibt den vollständigen Kommentar zurück: ID, Seiten‑URL und URL‑ID, Name und E‑Mail des Kommentators, der Kommentartext als Markdown und als HTML, Abstimmungszahlen, Genehmigungs‑ und Spam‑Flags, die Locale, die Domain und etwaige Erwähnungen. Die Felder entsprechen dem Webhook‑Payload, das unter Webhooks, Datenstrukturen dokumentiert ist.
Optionen
Domain. Jeder Auslöser hat einen optionalen Domain‑Filter, der die auf Ihrem Konto konfigurierten Domains auflistet. Lassen Sie das Feld leer, um Ereignisse von allen Domains zu erhalten.
Ungeprüfte und Spam‑Kommentare einbeziehen. Nur beim Auslöser „Neuer Kommentar“. Kommentare, die zur Moderation zurückgehalten oder als Spam markiert werden, werden standardmäßig übersprungen. Wenn ein solcher Kommentar später genehmigt wird, löst der Auslöser „Aktualisierter Kommentar“ aus, sodass ein Zap, der auf jeden Kommentar reagieren soll, der sichtbar wird, den „Aktualisierter Kommentar“-Auslöser mit einem Filter auf das Feld „approved“ verwendet.
Wie die Zustellung funktioniert
Das Aktivieren eines Zaps erstellt ein Webhook‑Abonnement in Ihrem Konto, das auf der Seite Webhooks mit der Quelle API sichtbar ist. Das Deaktivieren des Zaps entfernt es. Die eigenen Limits von Zapier gelten dafür, wie viele Ereignisse pro Minute akzeptiert werden; FastComments versucht eine fehlgeschlagene Zustellung erneut, mit zunehmender Verzögerung, und deaktiviert ein Abonnement, das sechs Tage lang fehlschlägt. Ein deaktiviertes Abonnement kann auf der Seite Webhooks wieder aktiviert werden, oder Sie schalten den Zap einfach aus und wieder ein, um ein neues zu erstellen.
Ein Konto kann bis zu 50 API‑Abonnements halten. Jeder Zap, der einen FastComments‑Auslöser verwendet, nutzt eines.
Aktionen und Suchen
Aktionen und Suchen
Aktionen erstellen Daten in FastComments; Suchen rufen Daten ab, damit ein späterer Schritt sie verwenden kann. Jede Aktion ruft die FastComments REST‑API auf und verbraucht die gleichen API‑Credits, die der Aufruf in Ihrem eigenen Code kosten würde: ein Credit pro Aufruf, sofern nicht anders angegeben.
Kommentar erstellen
Veröffentlicht einen Kommentar auf einer Seite.
| Feld | Erforderlich | Hinweise |
|---|---|---|
| Page URL ID | Ja | Die URL‑ID, die das Kommentar‑Widget auf der Seite verwendet. Kommentare werden danach gruppiert. |
| Page URL | Ja | Die vollständige Seiten‑URL, die in Benachrichtigungs‑E‑Mails verwendet wird. |
| Comment | Ja | Der Kommentartext im FastComments‑Markdown. |
| Commenter Name | Ja | Namen sind pro E‑Mail eindeutig, daher schlägt die Wiederverwendung eines Namens mit einer anderen E‑Mail fehl. |
| Commenter Email | Nein | Ein Benutzer wird für die E‑Mail erstellt, wenn er noch nicht existiert. |
| User ID | Nein | Eine vorhandene SSO‑Benutzer‑ID. Hat Vorrang vor Name und E‑Mail. |
| Parent Comment ID | Nein | Festlegen, um eine Antwort zu posten. |
| Approved, Verified | Nein | Beide sind standardmäßig true. Nicht genehmigte Kommentare bleiben verborgen, bis sie moderiert werden. |
| Posted At | Nein | Standardmäßig jetzt. |
| Avatar URL, Page Title, Locale | Nein | Locale ist standardmäßig en_us. |
| Show Live In Widget | Nein | Schiebt den Kommentar in Echtzeit zu den Betrachtern. Kostet 2 Credits statt 1. |
| Run Spam Check, Send Emails | Nein | Standardmäßig deaktiviert. |
Seite erstellen oder aktualisieren
Erstellt einen Seiten‑Datensatz, bevor ein Kommentar darauf existiert, sodass er aufgelistet und eingeschränkt werden kann. Akzeptiert die URL‑ID, den Titel, die URL und optional die SSO‑Gruppen‑IDs, die die Seite sehen dürfen. Wenn bereits eine Seite mit dieser URL‑ID existiert, wird sie mit den angegebenen Feldern aktualisiert, sodass ein Zap wiederholt für dieselbe Seite ausgeführt werden kann.
SSO‑Benutzer erstellen oder aktualisieren
Erstellt einen Single‑Sign‑On‑Benutzer. Akzeptiert Ihre eigene Benutzer‑ID, Benutzernamen und E‑Mail sowie optional Anzeigenamen, Anzeige‑Label, Avatar, Website, Gruppen‑IDs und Benachrichtigungs‑ sowie Datenschutz‑Flags. Wenn bereits ein Benutzer mit dieser ID existiert, wird er stattdessen aktualisiert. Administrative Rollen können nicht über Zapier vergeben werden.
Feed‑Beitrag erstellen
Erstellt einen Beitrag in einem FastComments‑Feed aus HTML‑Inhalt. Die Autor‑Benutzer‑ID ist erforderlich (eine FastComments‑ oder SSO‑Benutzer‑ID); Titel, Tags und eine Link‑Vorschau sind optional.
Hashtag erstellen oder aktualisieren
Erstellt einen Hashtag, den Kommentatoren verwenden können, mit einer optionalen URL, zu der er verlinkt. Wenn der Tag bereits existiert, wird er stattdessen aktualisiert.
Kommentar melden
Markiert einen Kommentar zur Moderatoren‑Überprüfung. Die ID des Benutzers, der die Meldung vornimmt, ist erforderlich; die vom Erstellen‑Kommentar zurückgegebene Autor‑ID funktioniert.
Suchen
| Suche | Eingabe | Rückgabe |
|---|---|---|
| Find Comment | Comment ID | Der Kommentar oder nichts. |
| Find SSO User | Der SSO‑Benutzer oder nichts. | |
| Find Page | URL ID | Die Seite oder nichts. |
Eine Suche, die nichts findet, lässt den Zap nicht fehlschlagen. Find SSO User und Find Page bieten Zapier‑Option „erstellen, wenn nicht vorhanden“ an, die das passende Erstellen ausführt, wenn nichts gefunden wird.
Beispiel-Zaps
Beispiel-Zaps
Einige Workflows, die in wenigen Minuten eingerichtet sind.
Benachrichtigt werden, wenn neue Kommentare eingehen. New Comment, dann Slack "Send Channel Message" oder Discord "Send Channel Message". Mappe den Namen des Kommentators, den Kommentartext und die Seiten‑URL in die Nachricht. Füge den Domain‑Filter hinzu, um pro Seite einen anderen Kanal zu benachrichtigen.
Führe ein Protokoll jedes Kommentars. New Comment, dann Google Sheets "Create Spreadsheet Row". Füge Deleted Comment als zweiten Zap hinzu, der eine Zeile mit der Kommentar‑ID anhängt, sodass das Sheet gleichzeitig als Audit‑Trail dient.
E‑Mail an den Autor senden, wenn ein Kommentar genehmigt wird. Updated Comment mit einem Zapier‑Filter, bei dem Approved true ist, dann Gmail "Send Email". Da Updated Comment bei jeder Änderung ausgelöst wird, sorgt der Filter dafür, dass dieser Zap nur bei Genehmigungen reagiert.
Kommentatoren zu deinem CRM oder deiner Mailingliste hinzufügen. New Comment, dann HubSpot "Create or Update Contact" oder Mailchimp "Add or Update Subscriber" mit der E‑Mail des Kommentators. Beachte deine Datenschutz‑Richtlinie und lokale Gesetze, bevor du jemanden zu einer Marketing‑Liste hinzufügst.
Einen Kommentar aus einem Formular erstellen. Typeform oder Google Forms "New Response", dann FastComments Create Comment mit der Seiten‑URL‑ID, die deine Seite für Testimonials verwendet. Lasse Approved deaktiviert, um jeden Kommentar vor dem Anzeigen zu prüfen.
Ankündigungen in einen Feed posten. RSS by Zapier "New Item in Feed", dann Create Feed Post mit dem Titel, Inhalt und Link des Elements.
Mitglieder als SSO‑Benutzer bereitstellen. Memberstack, Memberful oder dein eigener Webhook, dann Find SSO User gefolgt von Create SSO User im Modus "find or create".
Gemeldete Kommentare eskalieren. Updated Comment, gefiltert nach einer Flag‑Anzahl größer als null, dann Trello "Create Card" oder Linear "Create Issue" mit der Kommentar‑ID und einem Link zur Moderationsseite.
Seiten veröffentlichen, sobald sie live gehen. WordPress oder Ghost "New Post", dann Create Page mit der Beitrags‑URL, sodass die Seite gelistet und eingeschränkt ist, bevor der erste Kommentar erscheint.
Gelöschte Kommentare archivieren. Deleted Comment, dann Airtable "Create Record" mit dem vollständigen Kommentar für die Aufbewahrungspflicht.
Fehlerbehebung
Fehlerbehebung
„Sie haben keine Berechtigung" beim Verbinden. Der angemeldete Benutzer ist kein API-Administrator auf dem Konto. Bitten Sie den Kontoinhaber, die API-Berechtigung auf der Benutzerseite zu erteilen, oder verbinden Sie sich als Kontoinhaber.
Die Verbindung ist der falschen Website zugeordnet. Die Zustimmungsseite verbindet das Konto, bei dem Sie zum Zeitpunkt der Verbindung angemeldet waren. Trennen Sie die Verbindung in Zapier, wechseln Sie im FastComments-Dashboard das Konto, und verbinden Sie sich erneut.
Ereignisse kommen nicht mehr an. Prüfen Sie die Webhooks-Seite im Dashboard. Ein Abonnement, dessen Endpunkt sechs Tage lang fehlgeschlagen ist, wird automatisch deaktiviert und zeigt den Grund an. Aktivieren Sie es dort wieder, oder schalten Sie den Zap aus und wieder ein. Wenn das Abonnement vollständig fehlt, wurde es von jemandem gelöscht; das Aus- und Wiedereinschalten des Zaps erstellt es neu.
Zapier meldet, dass das Konto neu verbunden werden muss. Die Verbindung wurde über die Seite „Connected Apps" widerrufen, der Benutzer, der sie genehmigt hat, hat die API-Berechtigung verloren, oder das Konto wurde gelöscht. Verbinden Sie sich erneut über Zapier.
Eine Aktion schlägt mit „does not have write access" fehl. Die Verbindung wurde nur mit Leseberechtigung genehmigt. Verbinden Sie sich erneut und genehmigen Sie beide Berechtigungen.
Ratenlimits und Credits. Aktionen und Suchvorgänge verbrauchen API-Credits aus Ihrem Plan und unterliegen denselben Ratenlimits wie die REST-API. Trigger verbrauchen keine. Ein Zap, der auf ein Limit stößt, wird von Zapier nach der von FastComments gemeldeten Verzögerung erneut ausgeführt.
Die Domain-Dropdown-Liste ist leer. Domains erscheinen, sobald sie auf der Domains-Seite im FastComments-Dashboard konfiguriert sind. Lassen Sie das Feld leer, um Ereignisse für alle Domains zu erhalten.