Povežite FastComments z Zapierjem
The FastComments app for Zapier connects your comments to thousands of other apps without writing code.
Use it to post a Slack message when someone comments, log every comment to a spreadsheet, create a comment from a form submission, or add commenters to your CRM. Triggers fire the moment something happens, because they are backed by webhooks rather than polling, and actions call the FastComments API on your behalf.
This guide assumes you have a FastComments account. Lahko ga ustvarite tukaj.
This guide covers using the Zapier app. The endpoints it calls, along with request and response formats and the OAuth flow behind the connection, are documented in the API reference.
Povežite svoj račun 
Connect Your Account
-
In Zapier, add a FastComments step to a Zap, or open the FastComments app page in the Zapier App Directory.
→ V Zapierju dodajte korak FastComments v Zap ali odprite stran aplikacije FastComments v Zapierjevem imeniku aplikacij. -
Choose Sign in to FastComments. Zapier asks for your region first: pick United States unless your
account was created on the EU region (eu.fastcomments.com).
→ Izberite Sign in to FastComments. Zapier najprej vpraša za vašo regijo: izberite United States, razen če je bil vaš račun ustvarjen v EU regiji (eu.fastcomments.com). -
A FastComments window opens. Sign in if you are not already signed in.
→ Odpre se okno FastComments. Prijavite se, če še niste prijavljeni. -
Review the consent page. It shows the Zapier application, the account it will be connected to, and the
permissions requested (read and write). Choose Approve.
→ Preglejte stran za soglasje. Prikazuje aplikacijo Zapier, račun, s katerim bo povezana, in zahtevana dovoljenja (branje in pisanje). Izberite Approve. -
Zapier stores the connection and labels it with your site name and username.
→ Zapier shrani povezavo in jo označi z imenom vašega mesta in uporabniškim imenom.
The connection uses OAuth. No API key is copied into Zapier, and the token Zapier holds only works for the
account you approved.
→ Povezava uporablja OAuth. V Zapier ni kopiran noben API ključ, token, ki ga Zapier hrani, deluje le za račun, ki ste ga odobrili.
Who can connect
The person approving the connection must be an API admin on the FastComments account. Account owners
have this permission; other team members can be granted it on the Users page. Someone without it sees a
"you do not have permission" page instead of the consent form.
→ Oseba, ki odobri povezavo, mora biti API admin na računu FastComments. Lastniki računov imajo to dovoljenje; drugim članom ekipe ga je mogoče dodeliti na strani Uporabniki. Nekdo brez tega dovoljenja vidi stran "you do not have permission" namesto obrazca za soglasje.
Connecting the right site
The consent page connects the account you are currently signed in to. If you manage several accounts,
switch to the right one from the account switcher before approving, or use the switch account link on
the consent page. The connection label in Zapier shows the site name, so a wrong choice is easy to spot.
→ Stran za soglasje poveže račun, v katerega ste trenutno prijavljeni. Če upravljate z več računi, preklopite na pravi prek preklopnika računov pred odobritvijo ali uporabite povezavo switch account na strani za soglasje. Oznaka povezave v Zapierju prikazuje ime mesta, zato je napačna izbira enostavno opazna.
Reviewing and revoking access
Every connection appears under Connected Apps in the FastComments dashboard, with the permissions it
holds and when it was last used. Revoking it there disconnects Zapier immediately; any Zap using that
connection stops until it is reconnected. You can also remove the connection from the Zapier side under
My Apps.
→ Vsaka povezava se prikaže pod Connected Apps v nadzorni plošči FastComments, z dovoljenji, ki jih ima, in s časom zadnje uporabe. Preklic tam takoj prekine povezavo z Zapierjem; vsak Zap, ki uporablja to povezavo, se ustavi, dokler se ne ponovno poveže. Povezavo lahko tudi odstranite na strani Zapierja pod My Apps.
Sprožilci
Sprožilci
Sprožilci zaženejo Zap, ko se v FastComments zgodi nekaj. Vsi trije so takojšnji: FastComments pošlje dogodek Zapierju prek webhooka takoj, ko se zgodi. Nič ne poizveduje vašega računa in pri čakanju ne porabite API kreditov.
| Sprožilec | Ko se sproži |
|---|---|
| Nov komentar | Komentar je objavljen. Privzeto se sprožijo le odobreni, ne‑spam komentarji. |
| Posodobljen komentar | Komentar je urejen, odobren, glasovan, pripet, zaklenjen ali na drug način spremenjen. |
| Izbrisan komentar | Komentar je izbrisan. |
Vsak sprožilec vrne celoten komentar: id, URL strani in URL ID, ime in e‑mail komentatorja, besedilo komentarja kot markdown in kot HTML, število glasov, oznake odobritve in spama, jezikovno nastavitev, domeno in morebitne omembe. Polja se ujemajo s payloadom webhooka, dokumentiranim pod Webhooks, Data Structures.
Možnosti
Domena. Vsak sprožilec ima neobvezen filter domene, ki prikazuje domene, nastavljene v vašem računu. Pustite prazno, da prejmete dogodke iz vseh domen.
Vključi neodobrene in spam komentarje. Le pri sprožilcu Nov komentar. Komentarji, ki so zadržani za moderacijo ali označeni kot spam, so privzeto izpuščeni. Ko je tak komentar kasneje odobren, se sproži sprožilec Posodobljen komentar, zato Zap, ki naj bi reagiral na vsak komentar, ki postane viden, uporablja Posodobljen komentar s filtrom na polju odobren.
Kako deluje dostava
Vklop Zap-a ustvari naročnino na webhook v vašem računu, vidno na strani Webhooks s virom API. Izklop Zap-a jo odstrani. Zapierjeve lastne omejitve veljajo za število dogodkov, ki jih sprejme na minuto; FastComments ponovi pošiljanje, ki ne uspe, z naraščajočim zamikom, in onemogoči naročnino, ki ne uspe šest dni. Onemogočeno naročnino lahko ponovno omogočite na strani Webhooks ali preprosto izklopite in ponovno vklopite Zap, da ustvarite novo.
Račun lahko vsebuje največ 50 API naročnin. Vsak Zap, ki uporablja sprožilec FastComments, uporabi eno.
Dejanja in iskanja
Dejanja in Iskanja
Dejanja ustvarjajo podatke v FastComments; iskanja poiščejo podatke, da jih lahko kasnejši korak uporabi. Vsako dejanje kliče FastComments REST API in porabi enake API kredite, kot bi klic stal v vaši kodi: en kredit na klic, razen če je navedeno drugače.
Ustvari komentar
Objavi komentar na strani.
| Polje | Obvezno | Opombe |
|---|---|---|
| ID URL-ja strani | Da | ID URL-ja, ki ga uporablja pripomoček za komentarje na strani. Komentarji so po njem združeni. |
| URL strani | Da | Polni URL strani, ki se uporablja v e-poštnih obvestilih. |
| Komentar | Da | Telo komentarja v FastComments markdownu. |
| Ime komentatorja | Da | Imena so edinstvena glede na e-pošto, zato ponovna uporaba imena z drugo e-pošto ne uspe. |
| E‑pošta komentatorja | Ne | Uporabnik se ustvari za e‑pošto, če še ne obstaja. |
| ID uporabnika | Ne | Obstoječi SSO ID uporabnika. Ima prednost pred imenom in e‑pošto. |
| ID nadrejeni komentar | Ne | Nastavite za objavo odgovora. |
| Odobreno, Preverjeno | Ne | Oboje je privzeto nastavljeno na true. Neodobreni komentarji ostanejo skriti, dokler niso moderirani. |
| Objavljeno ob | Ne | Privzeto je trenutni čas. |
| URL avatarja, Naslov strani, Lokalizacija | Ne | Lokalizacija je privzeto en_us. |
| Prikaži v živo v pripomočku | Ne | Potiska komentar gledalcem v realnem času. Stane 2 kredita namesto 1. |
| Izvedi preverjanje spama, Pošlji e‑pošto | Ne | Privzeto izklopljeno. |
Ustvari ali posodobi stran
Ustvari zapis strani, preden na njej obstaja kakšen komentar, da jo je mogoče izpisati in omejiti. Sprejme ID URL-ja, naslov, URL in po želji SSO ID-je skupin, ki smejo videti stran. Če stran s tem ID URL-ja že obstaja, se posodobi z navedenimi polji, tako da lahko Zap večkrat za isto stran izvede.
Ustvari ali posodobi SSO uporabnika
Ustvari uporabnika za enotno prijavo (single sign-on). Sprejme vaš lasten ID uporabnika, uporabniško ime in e‑pošto, ter po želji prikazno ime, prikazno oznako, avatar, spletno stran, ID-je skupin ter oznake za obvestila in zasebnost. Če uporabnik s tem ID‑jem že obstaja, se namesto tega posodobi. Administrativnih vlog ni mogoče dodeliti prek Zapierja.
Ustvari objavo v viru
Ustvari objavo v FastComments viru iz HTML vsebine. ID avtorja (uporabnika) je obvezen (FastComments ali SSO ID uporabnika); naslov, oznake in en predogled povezave so neobvezni.
Ustvari ali posodobi hashtag
Ustvari hashtag, ki ga lahko komentatorji uporabljajo, z neobveznim URL‑jem, na katerega se povezuje. Če hashtag že obstaja, se posodobi.
Označi komentar
Označi komentar za pregled moderatorja. ID uporabnika, ki označuje, je obvezen; ID avtorja, ki ga vrne Ustvari komentar, deluje.
Iskanja
| Iskanje | Vnos | Vrne |
|---|---|---|
| Najdi komentar | ID komentarja | Komentar, ali nič. |
| Najdi SSO uporabnika | E‑pošta | SSO uporabnika, ali nič. |
| Najdi stran | ID URL‑ja | Stran, ali nič. |
Iskanje, ki ne najde ničesar, ne povzroči napake v Zap‑u. Najdi SSO uporabnika in Najdi stran ponujata Zapierjevo možnost "ustvari, če ne obstaja", ki izvede ustrezno ustvarjanje, ko nič ni najdeno.
Primeri Zapov
Primer Zaps
Nekaj delovnih tokov, ki jih je mogoče nastaviti v nekaj minutah.
Obvesti se o novih komentarjih. Nov komentar, nato Slack "Send Channel Message" ali Discord "Send Channel Message". Preslikaj ime komentatorja, besedilo komentarja in URL strani v sporočilo. Dodaj filter domene, da obvestiš različni kanal za vsako spletno mesto.
Vodi dnevnik vsakega komentarja. Nov komentar, nato Google Sheets "Create Spreadsheet Row". Dodaj Izbrisan komentar kot drugi Zap, ki doda vrstico z ID-jem komentarja, tako da list služi tudi kot revizijski sled.
Pošlji e-pošto avtorju, ko je komentar odobren. Posodobljen komentar z Zapier filtrom, kjer je Approved (odobreno) resničen, nato Gmail "Send Email". Ker se Posodobljen komentar sproži ob vsaki spremembi, filter omogoča, da ta Zap reagira le na odobritve.
Dodaj komentatorje v svoj CRM ali poštni seznam. Nov komentar, nato HubSpot "Create or Update Contact" ali Mailchimp "Add or Update Subscriber" z uporabo e-pošte komentatorja. Spoštujte svojo politiko zasebnosti in lokalno zakonodajo preden kdorkoli dodate na marketinški seznam.
Ustvari komentar iz obrazca. Typeform ali Google Forms "New Response", nato FastComments Create Comment z ID-jem URL strani, ki ga vaše spletno mesto uporablja za pričevanja. Pustite polje Approved neoznačeno, da pregledate vsak komentar, preden se prikaže.
Objavi obvestila v vir. RSS preko Zapier "New Item in Feed", nato Create Feed Post z elementa naslov, vsebina in povezava.
Omogoči članom SSO uporabnike. Memberstack, Memberful ali vaš lastni webhook, nato Find SSO User, sledijo Create SSO User v načinu "find or create" mode.
Povečaj obravnavo prijavljenih komentarjev. Posodobljen komentar, filtriran po številu zastav (flag) večjem od nič, nato Trello "Create Card" ali Linear "Create Issue" z ID-jem komentarja in povezavo do strani za moderiranje.
Objavi strani, ko postanejo žive. WordPress ali Ghost "New Post", nato Create Page z URL-jem objave, tako da je stran navedena in omejena pred prvim komentarjem.
Arhiviraj izbrisane komentarje. Izbrisan komentar, nato Airtable "Create Record" s celotnim komentarjem za skladnost in hrambo.
Odpravljanje težav
Odpravljanje težav
"You do not have permission" pri povezovanju. Prijavljeni uporabnik ni API skrbnik na računu.
Prosite lastnika računa, da dodeli API dovoljenje na strani Uporabniki, ali se povežite kot lastnik.
Povezava je označena z napačnim spletnim mestom. Stran za soglasje poveže račun, v katerega ste bili takrat prijavljeni.
Prekinite povezavo v Zapierju, preklopite račune v nadzorni plošči FastComments in se ponovno povežite.
Dogodki so prenehali priti. Preverite stran Webhookov v nadzorni plošči. Naročnina, katere končna točka je šest dni zaporedno odpovedovala, je samodejno onemogočena in prikazuje razlog.
Ponovno jo omogočite tam, ali izklopite in ponovno vklopite Zap. Če naročnina sploh manjka, jo je nekdo izbrisal; izklop in ponovni vklop Zapa jo ponovno ustvari.
Zapier pravi, da je treba račun ponovno povezati. Povezava je bila preklicana na strani Povezane aplikacije, uporabnik, ki jo je odobril, je izgubil API dovoljenje, ali je bil račun izbrisan.
Ponovno povežite iz Zapierja.
Dejanje spodleti z napako "does not have write access". Povezava je bila odobrena le s pravicami za branje.
Ponovno povežite in odobrite obe pravici.
Omejitve hitrosti in krediti. Dejanja in iskanja porabijo API kredite iz vašega paketa in so podvržena istim omejitvam hitrosti kot REST API. Sprožilci ne porabijo nobenega. Zap, ki naleti na omejitev, Zapier ponovi po zakasnitvi, ki jo FastComments poroča.
Spustni seznam Domene je prazen. Domene se pojavijo, ko so nastavljene na strani Domene v nadzorni plošči FastComments.
Pustite polje prazno, da prejemate dogodke za vsako domeno.