Conecte FastComments ao Zapier
O aplicativo FastComments para Zapier conecta seus comentários a milhares de outros aplicativos sem escrever código.
Use-o para publicar uma mensagem no Slack quando alguém comentar, registrar cada comentário em uma planilha, criar um
comentário a partir de uma submissão de formulário, ou adicionar comentaristas ao seu CRM. Os gatilhos disparam no momento em que algo acontece,
pois são baseados em webhooks em vez de polling, e as ações chamam a API do FastComments em seu
nome.
Este guia assume que você tem uma conta FastComments. Você pode criar uma aqui.
Conecte sua conta 
Conecte sua conta
- No Zapier, adicione um passo do FastComments a um Zap ou abra a página do aplicativo FastComments no Diretório de Aplicativos do Zapier.
- Escolha Sign in to FastComments. O Zapier solicita sua região primeiro: selecione United States a menos que sua conta tenha sido criada na região da UE (
eu.fastcomments.com). - Uma janela do FastComments é aberta. Faça login se ainda não estiver conectado.
- Revise a página de consentimento. Ela mostra o aplicativo Zapier, a conta à qual será conectado e as permissões solicitadas (leitura e escrita). Escolha Approve.
- O Zapier armazena a conexão e a rotula com o nome do seu site e nome de usuário.
A conexão usa OAuth. Nenhuma chave de API é copiada para o Zapier, e o token que o Zapier mantém funciona apenas para a conta que você aprovou.
Quem pode conectar
A pessoa que aprova a conexão deve ser um API admin na conta FastComments. Os proprietários da conta têm essa permissão; outros membros da equipe podem recebê‑la na página de Usuários. Alguém sem essa permissão vê uma página "you do not have permission" em vez do formulário de consentimento.
Conectando o site correto
A página de consentimento conecta a conta na qual você está atualmente conectado. Se você gerencia várias contas, troque para a correta usando o alternador de contas antes de aprovar, ou use o link switch account na página de consentimento. O rótulo da conexão no Zapier mostra o nome do site, portanto uma escolha errada é fácil de identificar.
Revisando e revogando o acesso
Cada conexão aparece em Connected Apps no painel do FastComments, com as permissões que possui e quando foi usada pela última vez. Revogá‑la lá desconecta o Zapier imediatamente; qualquer Zap que use essa conexão para de funcionar até que seja reconectado. Você também pode remover a conexão do lado do Zapier em My Apps.
Gatilhos
Gatilhos
Os gatilhos iniciam um Zap quando algo acontece no FastComments. Todos os três são instantâneos: o FastComments entrega o evento ao Zapier através de um webhook no momento em que ocorre. Nada faz polling na sua conta e nenhum crédito de API é gasto aguardando.
| Gatilho | Dispara quando |
|---|---|
| Novo Comentário | Um comentário é publicado. Por padrão, apenas comentários aprovados e que não são spam disparam. |
| Comentário Atualizado | Um comentário é editado, aprovado, votado, fixado, bloqueado ou alterado de outra forma. |
| Comentário Excluído | Um comentário é excluído. |
Cada gatilho retorna o comentário completo: id, URL da página e ID da URL, nome e e‑mail do comentarista, o texto do comentário como markdown e como HTML, contagens de votos, sinalizadores de aprovação e spam, o locale, o domínio e quaisquer menções. Os campos correspondem à carga útil do webhook documentada em Webhooks, Estruturas de Dados.
Opções
Domínio. Cada gatilho tem um filtro de domínio opcional, listando os domínios configurados na sua conta. Deixe em branco para receber eventos de todos os domínios.
Incluir Comentários Não Aprovados e Spam. Apenas no gatilho Novo Comentário. Comentários que ficam retidos para moderação ou marcados como spam são ignorados por padrão. Quando tal comentário é aprovado posteriormente, o gatilho Comentário Atualizado dispara para ele, de modo que um Zap que deve reagir a todo comentário que se torna visível usa Comentário Atualizado com um filtro no campo aprovado.
Como a entrega funciona
Ativar um Zap cria uma assinatura de webhook na sua conta, visível na página Webhooks com a origem API. Desativar o Zap a remove. Os limites próprios do Zapier se aplicam ao número de eventos que ele aceita por minuto; o FastComments tenta novamente uma entrega que falha, com atraso crescente, e desabilita uma assinatura que continua falhando por seis dias. Uma assinatura desabilitada pode ser reativada a partir da página Webhooks, ou simplesmente desligue e ligue o Zap novamente para criar uma nova.
Uma conta pode conter até 50 assinaturas de API. Cada Zap que usa um gatilho FastComments consome uma.
Ações e Pesquisas
Ações e Pesquisas
Ações criam dados no FastComments; pesquisas buscam dados para que uma etapa posterior possa usá-los. Cada ação chama a API REST do FastComments e consome os mesmos créditos de API que a chamada custaria no seu próprio código: um crédito por chamada, a menos que indicado.
Criar Comentário
Publica um comentário em uma página.
| Campo | Obrigatório | Observações |
|---|---|---|
| ID da URL da página | Sim | O ID da URL que o widget de comentários usa na página. Comentários são agrupados por ele. |
| URL da página | Sim | A URL completa da página, usada em e‑mails de notificação. |
| Comentário | Sim | O corpo do comentário em markdown do FastComments. |
| Nome do Comentador | Sim | Nomes são únicos por e‑mail, portanto reutilizar um nome com um e‑mail diferente falha. |
| E‑mail do Comentador | Não | Um usuário é criado para o e‑mail quando ainda não existe. |
| ID do Usuário | Não | Um ID de usuário SSO existente. Tem precedência sobre o nome e o e‑mail. |
| ID do Comentário Pai | Não | Defina para publicar uma resposta. |
| Aprovado, Verificado | Não | Ambos padrão como verdadeiro. Comentários não aprovados permanecem ocultos até serem moderados. |
| Publicado Em | Não | Padrão para agora. |
| URL do Avatar, Título da Página, Local | Não | Local padrão é en_us. |
| Mostrar ao Vivo no Widget | Não | Envia o comentário para os visualizadores em tempo real. Custa 2 créditos ao invés de 1. |
| Executar Verificação de Spam, Enviar E‑mails | Não | Desativado por padrão. |
Criar Página
Cria um registro de página antes que exista qualquer comentário nela, para que possa ser listada e restrita. Recebe o ID da URL, título, URL e, opcionalmente, os IDs de grupos SSO que podem visualizá‑la.
Criar Usuário SSO
Cria um usuário de login único (single sign‑on). Recebe seu próprio ID de usuário, nome de usuário e e‑mail, além de nome de exibição opcional, rótulo de exibição, avatar, site, IDs de grupos e sinalizadores de notificação e privacidade. Funções administrativas não podem ser concedidas via Zapier.
Criar Postagem no Feed
Cria uma postagem em um feed do FastComments a partir de conteúdo HTML, com título opcional, autor, tags e uma pré‑visualização de link.
Criar Tag de Hash
Cria uma tag de hash que os comentadores podem usar, com uma URL opcional para a qual ela aponta.
Sinalizar Comentário
Sinaliza um comentário para revisão de moderador. Forneça o ID do usuário que está sinalizando, ou deixe em branco para sinalizar como a integração Zapier.
Pesquisas
| Pesquisa | Entrada | Retorna |
|---|---|---|
| Encontrar Comentário | ID do Comentário | O comentário, ou nada. |
| Encontrar Usuário SSO | E‑mail | O usuário SSO, ou nada. |
| Encontrar Página | ID da URL | A página, ou nada. |
Uma pesquisa que não encontra nada não falha o Zap. Combine uma pesquisa com uma criação no modo “encontrar ou criar” do Zapier para criar a página ou o usuário quando estiver ausente.
Exemplos de Zaps
Exemplos de Zaps
Alguns fluxos de trabalho que levam minutos para configurar.
Receba notificações sobre novos comentários. Novo Comentário, então Slack "Send Channel Message" ou Discord "Send Channel Message". Mapeie o nome do comentarista, o texto do comentário e a URL da página na mensagem. Adicione o filtro de domínio para notificar um canal diferente por site.
Mantenha um registro de cada comentário. Novo Comentário, então Google Sheets "Create Spreadsheet Row". Adicione Deleted Comment como um segundo Zap que acrescenta uma linha com o ID do comentário, de modo que a planilha também funcione como trilha de auditoria.
Envie e‑mail ao autor quando um comentário for aprovado. Updated Comment com um filtro Zapier onde Approved é true, então Gmail "Send Email". Como Updated Comment dispara a cada alteração, o filtro é o que faz este Zap reagir apenas a aprovações.
Adicione comentaristas ao seu CRM ou lista de e‑mail. Novo Comentário, então HubSpot "Create or Update Contact" ou Mailchimp "Add or Update Subscriber" usando o e‑mail do comentarista. Respeite sua política de privacidade e a legislação local antes de adicionar alguém a uma lista de marketing.
Crie um comentário a partir de um formulário. Typeform ou Google Forms "New Response", então FastComments Create Comment com o ID da URL da página que seu site usa para depoimentos. Deixe Approved desmarcado para revisar cada um antes que apareça.
Publique anúncios em um feed. RSS by Zapier "New Item in Feed", então Create Feed Post com o título, conteúdo e link do item.
Provisionar membros como usuários SSO. Memberstack, Memberful ou seu próprio webhook, então Find SSO User seguido de Create SSO User no modo "find or create".
Escalar comentários denunciados. Updated Comment, filtrado com contagem de sinalizações acima de zero, então Trello "Create Card" ou Linear "Create Issue" com o ID do comentário e um link para a página de moderação.
Publicar páginas à medida que são lançadas. WordPress ou Ghost "New Post", então Create Page com a URL da postagem, de modo que a página seja listada e restrita antes do primeiro comentário.
Arquivar comentários excluídos. Deleted Comment, então Airtable "Create Record" com o comentário completo para retenção de conformidade.
Solução de Problemas
Solução de Problemas
"Você não tem permissão" ao conectar. O usuário conectado não é um administrador da API na conta.
Peça ao proprietário da conta que conceda permissão de API na página Usuários, ou conecte-se como proprietário.
A conexão está rotulada com o site errado. A página de consentimento conecta a conta na qual você estava conectado no momento. Desconecte no Zapier, troque de conta no painel do FastComments e conecte novamente.
Os eventos pararam de chegar. Verifique a página Webhooks no painel. Uma assinatura cujo endpoint ficou falhando por seis dias é desativada automaticamente e mostra o motivo. Reative-a lá, ou desligue e ligue o Zap novamente. Se a assinatura estiver totalmente ausente, alguém a excluiu; desligar e ligar o Zap a recria.
O Zapier informa que a conta precisa ser reconectada. A conexão foi revogada na página Aplicativos Conectados, o usuário que a aprovou perdeu a permissão de API, ou a conta foi excluída. Reconecte a partir do Zapier.
Uma ação falha com "não tem acesso de gravação". A conexão foi aprovada com permissão somente leitura. Reconecte e aprove ambas as permissões.
Limites de taxa e créditos. Ações e buscas consomem créditos de API do seu plano e estão sujeitas aos mesmos limites de taxa da API REST. Gatilhos não consomem nenhum. Um Zap que atinge um limite é reexecutado pelo Zapier após o atraso que o FastComments relata.
O menu suspenso Domínio está vazio. Domínios aparecem assim que são configurados na página Domínios no painel do FastComments. Deixe o campo em branco para receber eventos de todos os domínios.