Połącz FastComments z Zapier
Aplikacja FastComments dla Zapier łączy twoje komentarze z tysiącami innych aplikacji bez pisania kodu.
Użyj jej, aby wysłać wiadomość Slack, gdy ktoś skomentuje, zapisać każdy komentarz w arkuszu kalkulacyjnym, utworzyć komentarz z formularza lub dodać komentujących do swojego CRM. Wyzwalacze uruchamiają się w momencie, gdy coś się wydarzy, ponieważ są oparte na webhookach, a nie na polling, a akcje wywołują API FastComments w twoim imieniu.
Ten przewodnik zakłada, że masz konto FastComments. Możesz je utworzyć tutaj.
Ten przewodnik obejmuje korzystanie z aplikacji Zapier. Endpointy, które wywołuje, wraz z formatami żądań i odpowiedzi oraz przepływem OAuth stojącym za połączeniem, są udokumentowane w referencji API.
Połącz swoje konto 
Połącz swoje konto
- W Zapierze dodaj krok FastComments do Zapa, lub otwórz stronę aplikacji FastComments w katalogu aplikacji Zapier.
- Wybierz Sign in to FastComments. Zapier najpierw pyta o region: wybierz United States, chyba że Twoje konto zostało utworzone w regionie UE (
eu.fastcomments.com). - Otwiera się okno FastComments. Zaloguj się, jeśli nie jesteś już zalogowany.
- Przejrzyj stronę zgody. Pokazuje ona aplikację Zapier, konto, z którym zostanie połączona, oraz żądane uprawnienia (odczyt i zapis). Wybierz Approve.
- Zapier zapisuje połączenie i oznacza je nazwą Twojej witryny oraz nazwą użytkownika.
Połączenie używa OAuth. Żaden klucz API nie jest kopiowany do Zapiera, a token przechowywany przez Zapier działa wyłącznie dla konta, które zatwierdziłeś.
Kto może połączyć
Osoba zatwierdzająca połączenie musi być API admin na koncie FastComments. Właściciele kont mają to uprawnienie; innym członkom zespołu można je przyznać na stronie Users. Osoba bez tego uprawnienia zobaczy stronę „you do not have permission” zamiast formularza zgody.
Łączenie właściwej witryny
Strona zgody łączy konto, do którego jesteś aktualnie zalogowany. Jeśli zarządzasz kilkoma kontami, przełącz się na właściwe za pomocą przełącznika kont przed zatwierdzeniem, lub użyj linku switch account na stronie zgody. Etykieta połączenia w Zapierze wyświetla nazwę witryny, więc błędny wybór łatwo zauważyć.
Przeglądanie i odwoływanie dostępu
Każde połączenie pojawia się w sekcji Connected Apps w panelu FastComments, wraz z uprawnieniami, które posiada, oraz informacją, kiedy było ostatnio używane. Odwołanie go tam natychmiast rozłącza Zapiera; każdy Zap używający tego połączenia przestaje działać, dopóki nie zostanie ponownie połączony. Możesz także usunąć połączenie po stronie Zapiera w sekcji My Apps.
Wyzwalacze
Wyzwalacze
Wyzwalacze uruchamiają Zapa, gdy w FastComments wydarzy się coś. Wszystkie trzy są natychmiastowe: FastComments dostarcza zdarzenie do Zapiera za pośrednictwem webhooka w momencie jego wystąpienia. Nic nie odpyta twojego konta i nie są zużywane żadne kredyty API podczas oczekiwania.
| Wyzwalacz | Uruchamia się gdy |
|---|---|
| Nowy komentarz | Komentarz zostaje opublikowany. Domyślnie wyzwalane są tylko zatwierdzone, nie‑spamowe komentarze. |
| Zaktualizowany komentarz | Komentarz jest edytowany, zatwierdzany, oceniany, przypinany, blokowany lub w inny sposób zmieniany. |
| Usunięty komentarz | Komentarz zostaje usunięty. |
Każdy wyzwalacz zwraca pełny komentarz: identyfikator, adres URL strony i identyfikator URL, imię i e‑mail komentującego, treść komentarza jako markdown i jako HTML, liczbę głosów, flagi zatwierdzenia i spamu, ustawienia regionalne, domenę oraz wszelkie wzmianki. Pola odpowiadają ładunkowi webhooka udokumentowanemu w sekcji Webhooks, Struktury danych.
Opcje
Domena. Każdy wyzwalacz ma opcjonalny filtr domeny, wymieniający domeny skonfigurowane na twoim koncie. Pozostaw puste, aby otrzymywać zdarzenia ze wszystkich domen.
Uwzględnij niezatwierdzone i spamowe komentarze. Tylko w wyzwalaczu Nowy komentarz. Komentarze, które są wstrzymane do moderacji lub oznaczone jako spam, są domyślnie pomijane. Gdy taki komentarz zostanie później zatwierdzony, wyzwalacz Zaktualizowany komentarz uruchamia się dla niego, więc Zap, który ma reagować na każdy komentarz stający się widoczny, używa Zaktualizowanego komentarza z filtrem na polu zatwierdzonym.
Jak działa dostarczanie
Włączenie Zapa tworzy subskrypcję webhooka na twoim koncie, widoczną na stronie Webhooks ze źródłem API. Wyłączenie Zapa usuwa ją. Własne limity Zapiera dotyczą liczby zdarzeń, które akceptuje na minutę; FastComments ponawia dostarczenie, które się nie powiodło, z rosnącym opóźnieniem, i wyłącza subskrypcję, która nieustannie zawodzi przez sześć dni. Wyłączona subskrypcja może zostać ponownie włączona ze strony Webhooks, lub po prostu wyłącz i włącz Zapa ponownie, aby utworzyć nową.
Konto może posiadać do 50 subskrypcji API. Każdy Zap korzystający z wyzwalacza FastComments używa jednej.
Akcje i wyszukiwania
Akcje i Wyszukiwania
Akcje tworzą dane w FastComments; wyszukiwania odszukują dane, aby późniejszy krok mógł je wykorzystać. Każda akcja wywołuje API REST FastComments i zużywa taką samą liczbę kredytów API, jaką kosztowałoby wywołanie z własnego kodu: jeden kredyt za wywołanie, chyba że zaznaczono inaczej.
Utwórz komentarz
Publikuje komentarz na stronie.
| Pole | Wymagane | Uwagi |
|---|---|---|
| Page URL ID | Tak | Identyfikator URL, którego używa widget komentarzy na stronie. Komentarze są grupowane według niego. |
| Page URL | Tak | Pełny adres URL strony, używany w e‑mailach powiadamiających. |
| Comment | Tak | Treść komentarza w formacie markdown FastComments. |
| Commenter Name | Tak | Nazwy są unikalne dla każdego e‑maila, więc ponowne użycie nazwy z innym e‑mailem kończy się niepowodzeniem. |
| Commenter Email | Nie | Użytkownik jest tworzony dla tego e‑maila, jeśli jeszcze nie istnieje. |
| User ID | Nie | Istniejący identyfikator użytkownika SSO. Ma pierwszeństwo przed nazwą i e‑mailem. |
| Parent Comment ID | Nie | Ustaw, aby opublikować odpowiedź. |
| Approved, Verified | Nie | Oba domyślnie ustawione na true. Niezatwierdzone komentarze pozostają ukryte, dopóki nie zostaną moderowane. |
| Posted At | Nie | Domyślnie ustawione na bieżącą datę i godzinę. |
| Avatar URL, Page Title, Locale | Nie | Locale domyślnie en_us. |
| Show Live In Widget | Nie | Wysyła komentarz do widzów w czasie rzeczywistym. Kosztuje 2 kredyty zamiast 1. |
| Run Spam Check, Send Emails | Nie | Domyślnie wyłączone. |
Utwórz lub zaktualizuj stronę
Tworzy rekord strony przed pojawieniem się na niej jakiegokolwiek komentarza, aby mogła być wyświetlana i ograniczana. Przyjmuje identyfikator URL, tytuł, URL oraz opcjonalnie identyfikatory grup SSO, które mają do niej dostęp. Jeśli strona o podanym identyfikatorze URL już istnieje, jest aktualizowana przy użyciu podanych pól, więc Zap może być uruchamiany wielokrotnie dla tej samej strony.
Utwórz lub zaktualizuj użytkownika SSO
Tworzy użytkownika jednokrotnego logowania (single sign‑on). Przyjmuje własny identyfikator użytkownika, nazwę użytkownika i e‑mail, a także opcjonalnie wyświetlaną nazwę, etykietę, awatar, stronę internetową, identyfikatory grup oraz flagi powiadomień i prywatności. Jeśli użytkownik o podanym identyfikatorze już istnieje, zostaje zaktualizowany. Role administracyjne nie mogą być przyznawane z poziomu Zapier.
Utwórz post w kanale
Tworzy post w kanale FastComments z treści HTML. Wymagany jest identyfikator użytkownika autora (identyfikator FastComments lub SSO); tytuł, tagi i podgląd jednego linku są opcjonalne.
Utwórz lub zaktualizuj hashtag
Tworzy hashtag, którego mogą używać komentujący, z opcjonalnym URL, do którego prowadzi. Jeśli hashtag już istnieje, zostaje zaktualizowany.
Oznacz komentarz
Oznacza komentarz do przeglądu przez moderatora. Wymagany jest identyfikator użytkownika dokonującego oznaczenia; identyfikator autora zwrócony przez Utwórz komentarz działa.
Wyszukiwania
| Wyszukiwanie | Wejście | Zwraca |
|---|---|---|
| Find Comment | Comment ID | Komentarz lub brak wyniku. |
| Find SSO User | Użytkownik SSO lub brak wyniku. | |
| Find Page | URL ID | Strona lub brak wyniku. |
Wyszukiwanie, które nie znajduje nic, nie powoduje niepowodzenia Zapa. Find SSO User i Find Page oferują opcję Zapier „utwórz, jeśli nie istnieje”, która uruchamia odpowiednie tworzenie, gdy nic nie zostanie znalezione.
Przykładowe Zaps
Przykładowe Zapy
Kilka workflow, których skonfigurowanie zajmuje kilka minut.
Otrzymuj powiadomienia o nowych komentarzach. New Comment, a następnie Slack "Send Channel Message" lub Discord "Send Channel Message". Zmapuj nazwę komentującego, treść komentarza i adres URL strony do wiadomości. Dodaj filtr domeny, aby powiadamiać inny kanał dla każdej witryny.
Prowadź dziennik każdego komentarza. New Comment, a następnie Google Sheets "Create Spreadsheet Row". Dodaj Deleted Comment jako drugiego Zapa, który dopisuje wiersz z identyfikatorem komentarza, dzięki czemu arkusz pełni jednocześnie rolę dziennika audytu.
Wysyłaj e-mail do autora po zatwierdzeniu komentarza. Updated Comment z filtrem Zapier na Approved is true, a następnie Gmail "Send Email". Ponieważ Updated Comment uruchamia się przy każdej zmianie, to filtr sprawia, że Zap reaguje tylko na zatwierdzenia.
Dodawaj komentujących do swojego CRM lub listy mailingowej. New Comment, a następnie HubSpot "Create or Update Contact" lub Mailchimp "Add or Update Subscriber" z użyciem adresu e-mail komentującego. Przed dodaniem kogokolwiek do listy marketingowej przestrzegaj swojej polityki prywatności i lokalnego prawa.
Twórz komentarze z formularza. Typeform lub Google Forms "New Response", a następnie FastComments Create Comment z identyfikatorem URL strony, którego Twoja witryna używa dla opinii. Pozostaw Approved niezaznaczone, aby przejrzeć każdy komentarz przed jego pojawieniem się.
Publikuj ogłoszenia w kanale. RSS by Zapier "New Item in Feed", a następnie Create Feed Post z tytułem, treścią i linkiem elementu.
Zapewnij członkom konta SSO. Memberstack, Memberful lub własny webhook, a następnie Find SSO User, po którym następuje Create SSO User w trybie "find or create".
Eskaluj zgłoszone komentarze. Updated Comment, filtrowany po liczbie flag większej od zera, a następnie Trello "Create Card" lub Linear "Create Issue" z identyfikatorem komentarza i linkiem do strony moderacji.
Publikuj strony, gdy tylko stają się aktywne. WordPress lub Ghost "New Post", a następnie Create Page z adresem URL wpisu, dzięki czemu strona jest widoczna na liście i ograniczona przed pierwszym komentarzem.
Archiwizuj usunięte komentarze. Deleted Comment, a następnie Airtable "Create Record" z pełną treścią komentarza dla celów zgodności i retencji.
Rozwiązywanie problemów
Rozwiązywanie problemów
"Nie masz uprawnień" podczas łączenia. Zalogowany użytkownik nie jest administratorem API na koncie.
Poproś właściciela konta o przyznanie uprawnień API na stronie Użytkownicy lub połącz się jako właściciel.
Połączenie jest oznaczone niewłaściwą witryną. Strona zgody łączy się z kontem, na które byłeś zalogowany
w tym momencie. Odłącz w Zapier, przełącz konta w panelu FastComments, a następnie połącz ponownie.
Zdarzenia przestały przychodzić. Sprawdź stronę Webhooków w panelu. Subskrypcja, której punkt końcowy nie działał
przez sześć dni, jest automatycznie wyłączana i wyświetla przyczynę. Włącz ją ponownie tam, lub wyłącz i włącz Zap
ponownie. Jeśli subskrypcja całkowicie zniknęła, ktoś ją usunął; wyłączenie i włączenie Zapa odtworzy ją.
Zapier informuje, że konto wymaga ponownego połączenia. Połączenie zostało odwołane na stronie Połączonych aplikacji,
użytkownik, który je zatwierdził, stracił uprawnienia API lub konto zostało usunięte. Połącz ponownie z Zapier.
Działanie nie powiodło się z komunikatem "brak uprawnień do zapisu". Połączenie zostało zatwierdzone z uprawnieniami tylko do odczytu
Połącz ponownie i zatwierdź oba uprawnienia.
Limity szybkości i kredyty. Działania i wyszukiwania zużywają kredyty API z Twojego planu i podlegają tym
samym limitom szybkości co REST API. Wyzwalacze nie zużywają kredytów. Zap, który napotka limit, jest ponawiany przez Zapier
po opóźnieniu zgłoszonym przez FastComments.
Lista rozwijana Domen jest pusta. Domeny pojawiają się po ich skonfigurowaniu na stronie Domen w
panelu FastComments. Pozostaw pole puste, aby otrzymywać zdarzenia dla każdej domeny.