Collega FastComments a Zapier
L'app FastComments per Zapier collega i tuoi commenti a migliaia di altre app senza scrivere codice.
Usala per inviare un messaggio Slack quando qualcuno commenta, registrare ogni commento in un foglio di calcolo, creare un commento da una risposta a un modulo, o aggiungere i commentatori al tuo CRM. I trigger si attivano nel momento in cui accade qualcosa, perché sono supportati da webhook anziché da polling, e le azioni chiamano l'API FastComments per tuo conto.
Questa guida presuppone che tu abbia un account FastComments. Puoi crearne uno qui.
Questa guida copre l'uso dell'app Zapier. Gli endpoint che chiama, insieme ai formati di richiesta e risposta e al flusso OAuth alla base della connessione, sono documentati nella riferimento API.
Collega il tuo account 
Connetti il tuo account
- In Zapier, aggiungi un passaggio FastComments a uno Zap, o apri la pagina dell'app FastComments nella directory delle app di Zapier.
- Scegli Sign in to FastComments. Zapier chiede prima la tua regione: scegli United States a meno che il tuo account non sia stato creato nella regione EU (
eu.fastcomments.com). - Si apre una finestra FastComments. Accedi se non sei già connesso.
- Rivedi la pagina di consenso. Mostra l'applicazione Zapier, l'account a cui sarà collegata e le autorizzazioni richieste (lettura e scrittura). Scegli Approve.
- Zapier memorizza la connessione e la etichetta con il nome del tuo sito e il nome utente.
La connessione utilizza OAuth. Nessuna chiave API viene copiata in Zapier, e il token che Zapier detiene funziona solo per l'account che hai approvato.
Chi può connettere
La persona che approva la connessione deve essere un API admin sull'account FastComments. I proprietari dell'account hanno questa autorizzazione; altri membri del team possono ottenerla nella pagina Utenti. Chi non la possiede vede una pagina "you do not have permission" invece del modulo di consenso.
Collegare il sito corretto
La pagina di consenso collega l'account a cui sei attualmente connesso. Se gestisci più account, passa a quello corretto tramite il selettore di account prima di approvare, oppure usa il link switch account nella pagina di consenso. L'etichetta della connessione in Zapier mostra il nome del sito, quindi una scelta errata è facile da individuare.
Revisione e revoca dell'accesso
Ogni connessione appare sotto Connected Apps nella dashboard di FastComments, con le autorizzazioni che possiede e quando è stata usata l'ultima volta. Revocandola lì, Zapier si disconnette immediatamente; qualsiasi Zap che utilizza quella connessione si ferma finché non viene riconnessa. Puoi anche rimuovere la connessione dal lato Zapier sotto My Apps.
Trigger
Trigger
I trigger avviano uno Zap quando si verifica qualcosa in FastComments. Tutti e tre sono istantanei: FastComments invia l'evento a Zapier tramite un webhook nel momento in cui accade. Nessuno interroga il tuo account e non vengono spesi crediti API in attesa.
| Trigger | Si attiva quando |
|---|---|
| Nuovo commento | Un commento viene pubblicato. Per impostazione predefinita, solo i commenti approvati e non spam attivano il trigger. |
| Commento aggiornato | Un commento viene modificato, approvato, votato, evidenziato, bloccato o altrimenti modificato. |
| Commento eliminato | Un commento viene eliminato. |
Ogni trigger restituisce il commento completo: id, URL della pagina e ID URL, nome e email del commentatore, il testo del commento in markdown e in HTML, conteggi dei voti, flag di approvazione e spam, la lingua, il dominio e eventuali menzioni. I campi corrispondono al payload del webhook documentato nella sezione Webhooks, Strutture dati.
Opzioni
Dominio. Ogni trigger ha un filtro dominio opzionale, che elenca i domini configurati sul tuo account. Lascia vuoto per ricevere eventi da tutti i domini.
Includi commenti non approvati e spam. Solo sul trigger Nuovo commento. I commenti trattenuti per moderazione o contrassegnati come spam vengono ignorati per impostazione predefinita. Quando tale commento viene approvato in seguito, il trigger Commento aggiornato si attiva per esso, quindi uno Zap che deve reagire a ogni commento che diventa visibile utilizza Commento aggiornato con un filtro sul campo approvato.
Come funziona la consegna
Attivare uno Zap crea un abbonamento webhook sul tuo account, visibile nella pagina Webhooks con la sorgente API. Disattivare lo Zap lo rimuove. I limiti di Zapier si applicano al numero di eventi che accetta al minuto; FastComments ritenta una consegna che fallisce, con un ritardo crescente, e disabilita un abbonamento che continua a fallire per sei giorni. Un abbonamento disabilitato può essere riattivato dalla pagina Webhooks, oppure basta disattivare e riattivare lo Zap per crearne uno nuovo.
Un account può contenere fino a 50 abbonamenti API. Ogni Zap che utilizza un trigger FastComments ne utilizza uno.
Azioni e ricerche
Azioni e Ricerche
Le azioni creano dati in FastComments; le ricerche recuperano dati in modo che un passaggio successivo possa usarli. Ogni azione chiama l'API REST di FastComments e consuma gli stessi crediti API che la chiamata costerebbe dal tuo codice: un credito per chiamata, salvo diversa indicazione.
Crea Commento
Pubblica un commento su una pagina.
| Campo | Obbligatorio | Note |
|---|---|---|
| Page URL ID | Sì | L'ID URL che il widget dei commenti utilizza sulla pagina. I commenti sono raggruppati per questo. |
| Page URL | Sì | L'URL completo della pagina, usato nelle email di notifica. |
| Comment | Sì | Il corpo del commento in markdown di FastComments. |
| Commenter Name | Sì | I nomi sono unici per email, quindi riutilizzare un nome con un'email diversa fallisce. |
| Commenter Email | No | Un utente viene creato per l'email se non esiste ancora. |
| User ID | No | Un ID utente SSO esistente. Ha la precedenza su nome ed email. |
| Parent Comment ID | No | Impostare per pubblicare una risposta. |
| Approved, Verified | No | Entrambi predefiniti a true. I commenti non approvati rimangono nascosti fino a quando non vengono moderati. |
| Posted At | No | Predefinito a ora corrente. |
| Avatar URL, Page Title, Locale | No | Il locale predefinito è en_us. |
| Show Live In Widget | No | Invia il commento ai visualizzatori in tempo reale. Costa 2 crediti invece di 1. |
| Run Spam Check, Send Emails | No | Disattivati per impostazione predefinita. |
Crea o Aggiorna Pagina
Crea un record di pagina prima che esista un commento su di essa, così può essere elencata e limitata. Richiede l'ID URL, il titolo, l'URL e, facoltativamente, gli ID dei gruppi SSO autorizzati a vederla. Se una pagina con quell'ID URL esiste già, viene aggiornata con i campi forniti, così uno Zap può essere eseguito più volte per la stessa pagina.
Crea o Aggiorna Utente SSO
Crea un utente single sign‑on. Richiede il tuo ID utente, nome utente ed email, più opzionalmente nome visualizzato, etichetta visualizzata, avatar, sito web, ID dei gruppi e flag di notifica e privacy. Se un utente con quell'ID esiste già, viene aggiornato invece. I ruoli amministrativi non possono essere concessi da Zapier.
Crea Post del Feed
Crea un post in un feed FastComments a partire da contenuto HTML. È richiesto l'ID utente dell'autore (un ID FastComments o SSO); titolo, tag e un'anteprima del link sono opzionali.
Crea o Aggiorna Hashtag
Crea un hashtag che i commentatori possono utilizzare, con un URL opzionale a cui collegarlo. Se l'hashtag esiste già, viene aggiornato invece.
Segnala Commento
Segnala un commento per la revisione di un moderatore. È richiesto l'ID dell'utente che effettua la segnalazione; l'ID autore restituito da Crea Commento funziona.
Ricerche
| Ricerca | Input | Restituisce |
|---|---|---|
| Find Comment | Comment ID | Il commento, o nulla. |
| Find SSO User | L'utente SSO, o nulla. | |
| Find Page | URL ID | La pagina, o nulla. |
Una ricerca che non trova nulla non fa fallire lo Zap. Find SSO User e Find Page offrono l'opzione "crea se non esiste" di Zapier, che esegue la creazione corrispondente quando non viene trovato alcun risultato.
Esempi di Zap
Esempi di Zap
Alcuni flussi di lavoro che richiedono pochi minuti per essere configurati.
Ricevi una notifica per i nuovi commenti. Nuovo commento, poi Slack "Send Channel Message" o Discord "Send Channel Message". Mappa il nome del commentatore, il testo del commento e l'URL della pagina nel messaggio. Aggiungi il filtro di dominio per notificare un canale diverso per sito.
Mantieni un registro di ogni commento. Nuovo commento, poi Google Sheets "Create Spreadsheet Row". Aggiungi Deleted Comment come secondo Zap che aggiunge una riga con l'ID del commento, così il foglio funge anche da tracciamento di audit.
Invia un'email all'autore quando un commento viene approvato. Updated Comment con un filtro Zapier su Approved è true, poi Gmail "Send Email". Poiché Updated Comment si attiva a ogni modifica, il filtro è ciò che fa reagire questo Zap solo alle approvazioni.
Aggiungi i commentatori al tuo CRM o alla tua mailing list. Nuovo commento, poi HubSpot "Create or Update Contact" o Mailchimp "Add or Update Subscriber" usando l'email del commentatore. Rispetta la tua politica sulla privacy e le leggi locali prima di aggiungere qualcuno a una lista di marketing.
Crea un commento da un modulo. Typeform o Google Forms "New Response", poi FastComments Create Comment con l'ID URL della pagina che il tuo sito usa per le testimonianze. Lascia Approved deselezionato per rivedere ciascuno prima che appaia.
Pubblica annunci su un feed. RSS by Zapier "New Item in Feed", poi Create Feed Post con il titolo, il contenuto e il link dell'elemento.
Fornisci i membri come utenti SSO. Memberstack, Memberful, o il tuo webhook, poi Find SSO User seguito da Create SSO User in modalità "find or create".
Escalare i commenti segnalati. Updated Comment, filtrato su un conteggio di segnalazioni superiore a zero, poi Trello "Create Card" o Linear "Create Issue" con l'ID del commento e un link alla pagina di moderazione.
Pubblica le pagine quando vanno in diretta. WordPress o Ghost "New Post", poi Create Page con l'URL del post, così la pagina è elencata e limitata prima del primo commento.
Archivia i commenti eliminati. Deleted Comment, poi Airtable "Create Record" con il commento completo per la conservazione conforme.
Risoluzione dei problemi
Risoluzione dei problemi
"Non hai l'autorizzazione" durante la connessione. L'utente connesso non è un amministratore API sull'account.
Chiedi al proprietario dell'account di concedere l'autorizzazione API nella pagina Utenti, oppure connettiti come proprietario.
La connessione è etichettata con il sito sbagliato. La pagina di consenso collega l'account con cui eri connesso al momento. Disconnetti in Zapier, cambia account nella dashboard di FastComments e riconnetti.
Gli eventi hanno smesso di arrivare. Controlla la pagina Webhooks nella dashboard. Una sottoscrizione il cui endpoint ha continuato a fallire per sei giorni viene disabilitata automaticamente e mostra il motivo. Riabilitala lì, oppure disattiva e riattiva lo Zap. Se la sottoscrizione manca del tutto, qualcuno l'ha eliminata; disattivare e riattivare lo Zap la ricrea.
Zapier dice che l'account deve essere riconnesso. La connessione è stata revocata dalla pagina App connesse, l'utente che l'ha approvata ha perso l'autorizzazione API, o l'account è stato eliminato. Riconnetti da Zapier.
Un'azione fallisce con "non ha accesso in scrittura". La connessione è stata approvata con autorizzazione solo lettura. Riconnetti e approva entrambe le autorizzazioni.
Limiti di velocità e crediti. Azioni e ricerche consumano crediti API dal tuo piano e sono soggetti agli stessi limiti di velocità dell'API REST. I trigger non ne consumano. Uno Zap che raggiunge un limite viene ritentato da Zapier dopo il ritardo segnalato da FastComments.
Il menu a discesa Dominio è vuoto. I domini appaiono una volta configurati nella pagina Domini della dashboard di FastComments. Lascia il campo vuoto per ricevere eventi per tutti i domini.