Povežite FastComments s Zapierom
FastComments aplikacija za Zapier povezuje vaše komentare s tisućama drugih aplikacija bez pisanja koda.
Koristite je za slanje Slack poruke kada netko komentira, bilježenje svakog komentara u tablicu, stvaranje komentara iz podnošenja obrasca, ili dodavanje komentatora u vaš CRM. Okidači se aktiviraju u trenutku kada se nešto dogodi, jer su podržani webhookovima umjesto periodičnog provjeravanja, a radnje pozivaju FastComments API u vaše ime.
Ovaj vodič pretpostavlja da imate FastComments račun. Možete ga kreirati ovdje.
Ovaj vodič pokriva korištenje Zapier aplikacije. Krajnje točke koje poziva, zajedno s formatima zahtjeva i odgovora te OAuth protokom koji stoji iza veze, dokumentirani su u API referenciji.
Povežite svoj račun 
Povežite svoj račun
- U Zapieru dodajte FastComments korak u Zap ili otvorite FastComments stranicu aplikacije u Zapier App Directory.
- Odaberite Sign in to FastComments. Zapier prvo traži vašu regiju: odaberite United States osim ako je vaš
račun stvoren na EU regiji (
eu.fastcomments.com). - Otvorit će se FastComments prozor. Prijavite se ako već niste prijavljeni.
- Pregledajte stranicu s privolom. Prikazuje Zapier aplikaciju, račun s kojim će se povezati i tražene dozvole (čitanje i pisanje). Odaberite Approve.
- Zapier pohranjuje vezu i označava je nazivom vaše stranice i korisničkim imenom.
Veza koristi OAuth. API ključ se ne kopira u Zapier, a token koji Zapier drži radi samo za račun koji ste odobrili.
Tko može povezati
Osoba koja odobrava vezu mora biti API admin na FastComments računu. Vlasnici računa imaju ovu dozvolu; drugim članovima tima može se dodijeliti na stranici Users. Netko tko je nema vidjet će stranicu "nemate dozvolu" umjesto obrasca s privolom.
Povezivanje ispravne stranice
Stranica s privolom povezuje račun na koji ste trenutno prijavljeni. Ako upravljate više računa, prebacite se na ispravni putem prekidača računa prije odobravanja ili koristite poveznicu switch account na stranici s privolom. Oznaka veze u Zapieru prikazuje naziv stranice, pa je pogrešan izbor lako uočiti.
Pregled i opoziv pristupa
Svaka veza pojavljuje se pod Connected Apps u FastComments nadzornoj ploči, s dozvolama koje ima i vremenom posljednje upotrebe. Opozivom tamo veza se odmah prekida; svaki Zap koji koristi tu vezu staje dok se ne ponovno poveže. Vezu možete ukloniti i sa strane Zapiera pod My Apps.
Okidači
Okidači
Okidači pokreću Zap kada se nešto dogodi u FastComments. Sva tri su trenutna: FastComments isporučuje događaj Zapieru putem webhooka u trenutku kada se dogodi. Ništa ne ispituje vaš račun i ne troše se API krediti čekajući.
| Okidač | Pokreće se kada |
|---|---|
| Novi komentar | Komentar je objavljen. Prema zadanim postavkama okidač se aktivira samo za odobrene, ne‑spam komentare. |
| Ažurirani komentar | Komentar je uređen, odobren, glasao se za njega, zakačen, zaključan ili na drugi način promijenjen. |
| Izbrisani komentar | Komentar je izbrisan. |
Svaki okidač vraća cijeli komentar: id, URL stranice i URL ID, ime i e‑mail komentatora, tekst komentara kao markdown i kao HTML, broj glasova, oznake odobrenja i spama, jezik, domenu i sve spominjanja. Polja odgovaraju payloadu webhooka dokumentiranom pod Webhooks, Data Structures.
Opcije
Domain. Svaki okidač ima opcionalni filter domene, koji navodi domene konfigurirane na vašem računu. Ostavite prazno da primate događaje sa svih domena.
Include Unapproved and Spam Comments. Samo na okidaču Novi komentar. Komentari koji su zadržani za moderaciju ili označeni kao spam po defaultu se preskaču. Kada takav komentar kasnije bude odobren, okidač Ažurirani komentar se aktivira za njega, pa Zap koji treba reagirati na svaki komentar koji postane vidljiv koristi Ažurirani komentar s filterom na polju odobrenja.
Kako funkcionira isporuka
Uključivanje Zapa stvara pretplatu na webhook na vašem računu, vidljivu na stranici Webhooks s izvorom API. Isključivanje Zapa uklanja je. Zapierova vlastita ograničenja primjenjuju se na broj događaja koje prihvaća po minuti; FastComments ponavlja isporuku koja ne uspije, s rastućim odgodom, i onemogućuje pretplatu koja neprestano ne uspijeva šest dana. Onemogućenu pretplatu možete ponovo omogućiti s stranice Webhooks, ili jednostavno isključiti i ponovno uključiti Zap kako biste stvorili novu.
Račun može imati najviše 50 API pretplata. Svaki Zap koji koristi FastComments okidač koristi jednu.
Radnje i pretrage
Radnje i pretrage
Radnje stvaraju podatke u FastComments; pretrage traže podatke kako bi ih kasniji korak mogao koristiti. Svaka radnja poziva FastComments REST API i troši iste API kredite koliko bi poziv koštao iz vašeg vlastitog koda: jedan kredit po pozivu, osim ako nije drugačije navedeno.
Stvaranje komentara
Objavljuje komentar na stranici.
| Polje | Obavezno | Napomene |
|---|---|---|
| ID URL-a stranice | Da | ID URL-a koji widget za komentare koristi na stranici. Komentari su grupirani po njemu. |
| URL stranice | Da | Puni URL stranice, koristi se u obavijesnim e‑mailovima. |
| Komentar | Da | Tijelo komentara u FastComments markdownu. |
| Ime komentatora | Da | Imena su jedinstvena po e‑mailu, pa ponovno korištenje imena s drugim e‑mailom ne uspijeva. |
| E‑mail komentatora | Ne | Korisnik se kreira za taj e‑mail ako još ne postoji. |
| ID korisnika | Ne | Postojeći SSO ID korisnika. Ima prednost nad imenom i e‑mailom. |
| ID nadređenog komentara | Ne | Postavite za objavu odgovora. |
| Odobreno, Potvrđeno | Ne | Oba zadano su postavljena na true. Neodobreni komentari ostaju skriveni dok se ne moderiraju. |
| Objavljeno u | Ne | Zadano je sada. |
| URL avatara, Naslov stranice, Lokalitet | Ne | Lokalitet zadano je en_us. |
| Prikaži uživo u widgetu | Ne | Gura komentar gledateljima u stvarnom vremenu. Košta 2 kredita umjesto 1. |
| Pokreni provjeru spama, Šalji e‑mailove | Ne | Zadano isključeno. |
Stvaranje ili ažuriranje stranice
Stvara zapis stranice prije nego što na njoj postoji bilo koji komentar, kako bi se mogla izlistati i ograničiti. Prima ID URL-a, naslov, URL i opcionalno SSO ID‑ove grupa kojima je dozvoljeno vidjeti je. Ako stranica s tim ID‑om URL‑a već postoji, ažurira se s navedenim poljima, tako da Zap može više puta pokrenuti za istu stranicu.
Stvaranje ili ažuriranje SSO korisnika
Stvara korisnika za jedinstvenu prijavu (single sign‑on). Prima vaš vlastiti ID korisnika, korisničko ime i e‑mail, plus opcionalno prikazno ime, prikaznu oznaku, avatar, web‑stranicu, ID‑ove grupa te oznake za obavijesti i privatnost. Ako korisnik s tim ID‑om već postoji, umjesto toga se ažurira. Administrativne uloge ne mogu se dodijeliti putem Zapiera.
Stvaranje objave u feedu
Stvara objavu u FastComments feedu iz HTML sadržaja. ID korisnika autora je obavezan (FastComments ili SSO ID korisnika); naslov, oznake i jedan pregled poveznice su opcionalni.
Stvaranje ili ažuriranje hash oznake
Stvara hash oznaku koju komentatori mogu koristiti, s opcionalnim URL‑om na koji vodi. Ako oznaka već postoji, umjesto toga se ažurira.
Označavanje komentara
Označava komentar za pregled moderatora. ID korisnika koji označava je obavezan; ID autora vraćen od Stvaranja komentara funkcionira.
Pretrage
| Pretraga | Ulaz | Vraća |
|---|---|---|
| Pronađi komentar | ID komentara | Komentar, ili ništa. |
| Pronađi SSO korisnika | E‑mail | SSO korisnik, ili ništa. |
| Pronađi stranicu | ID URL‑a | Stranica, ili ništa. |
Pretraga koja ne pronađe ništa ne uzrokuje neuspjeh Zapa. Pretrage Pronađi SSO korisnika i Pronađi stranicu nude Zapierovu opciju „stvori ako ne postoji“, koja pokreće odgovarajuće stvaranje kada se ništa ne pronađe.
Primjeri Zapova
Primjeri Zapova
Nekoliko radnih tokova čije postavljanje traje samo nekoliko minuta.
Dobijte obavijest o novim komentarima. New Comment, a zatim Slack "Send Channel Message" ili Discord "Send Channel Message". Mapirajte ime komentatora, tekst komentara i URL stranice u poruku. Dodajte filter domene kako biste obavještavali različite kanale za različite stranice.
Vodite evidenciju svakog komentara. New Comment, a zatim Google Sheets "Create Spreadsheet Row". Dodajte Deleted Comment kao drugi Zap koji dodaje red s ID-om komentara, tako da tablica istovremeno služi kao revizijski trag.
Pošaljite e-mail autoru kada je komentar odobren. Updated Comment s Zapier filterom na Approved is true, a zatim Gmail "Send Email". Budući da se Updated Comment aktivira pri svakoj promjeni, upravo filter čini da ovaj Zap reagira samo na odobrenja.
Dodajte komentatore u svoj CRM ili mailing listu. New Comment, a zatim HubSpot "Create or Update Contact" ili Mailchimp "Add or Update Subscriber" koristeći e-mail komentatora. Poštujte svoju politiku privatnosti i lokalne zakone prije dodavanja ikoga na marketinšku listu.
Stvorite komentar iz obrasca. Typeform ili Google Forms "New Response", a zatim FastComments Create Comment s ID-om URL-a stranice koji vaša stranica koristi za preporuke. Ostavite Approved neoznačenim kako biste pregledali svaki komentar prije nego što se pojavi.
Objavite najave u feed. RSS by Zapier "New Item in Feed", a zatim Create Feed Post s naslovom, sadržajem i poveznicom stavke.
Osigurajte članove kao SSO korisnike. Memberstack, Memberful ili vlastiti webhook, a zatim Find SSO User nakon kojeg slijedi Create SSO User u načinu rada "find or create".
Escalirajte prijavljene komentare. Updated Comment, filtriran na broj zastavica veći od nule, a zatim Trello "Create Card" ili Linear "Create Issue" s ID-om komentara i poveznicom na stranicu za moderaciju.
Objavite stranice čim postanu aktivne. WordPress ili Ghost "New Post", a zatim Create Page s URL-om objave, tako da je stranica navedena i ograničena prije prvog komentara.
Arhivirajte izbrisane komentare. Deleted Comment, a zatim Airtable "Create Record" s potpunim komentarom radi usklađenosti s pravilima zadržavanja podataka.
Rješavanje problema
Rješavanje problema
"Nemate dozvolu" prilikom povezivanja. Prijavljeni korisnik nije API administrator na računu.
Zatražite od vlasnika računa da odobri API dozvolu na stranici Korisnici, ili se povežite kao vlasnik.
Veza je označena s pogrešnom stranicom. Stranica za odobrenje povezuje račun na koji ste bili prijavljeni
u tom trenutku. Prekinite vezu u Zapieru, promijenite račun u FastComments nadzornoj ploči i ponovno se povežite.
Događaji su prestali dolaziti. Provjerite stranicu Webhookova u nadzornoj ploči. Pretplata čiji je krajnji punkt neuspješno radila šest dana automatski se onemogućuje i prikazuje razlog. Ponovno je omogućite tamo, ili isključite i ponovno uključite Zap. Ako pretplata uopće nedostaje, netko ju je izbrisao; isključivanje i ponovno uključivanje Zapa će je ponovno stvoriti.
Zapier kaže da je račun potrebno ponovno povezati. Veza je povučena s stranice Povezane aplikacije, korisnik koji ju je odobrio izgubio je API dozvolu, ili je račun izbrisan. Ponovno se povežite iz Zapia.
Radnja ne uspijeva s porukom "nema pristup za pisanje". Veza je odobrena s dozvolom samo za čitanje. Ponovno se povežite i odobrite obje dozvole.
Ograničenja brzine i krediti. Radnje i pretrage troše API kredite iz vašeg plana i podliježu istim ograničenjima brzine kao REST API. Okidači ne troše ništa. Zap koji dosegne ograničenje ponovno se pokušava od strane Zapia nakon kašnjenja koje FastComments prijavljuje.
Padajući izbornik Domene je prazan. Domene se pojavljuju nakon što su konfigurirane na stranici Domene u FastComments nadzornoj ploči. Ostavite polje prazno da primate događaje za svaku domenu.