Zapier: leve os artigos do ClickHunt para qualquer sistema

O que você vai montar

O ClickHunt entrega cada artigo publicado no webhook do Zapier. O Zapier recebe, e no passo seguinte você escolhe para onde ele vai: Google Sheets, Notion, WordPress, HubSpot, Slack, e-mail, ou qualquer um dos milhares de apps do catálogo do Zapier.

ClickHunt  →  Webhook (Catch Hook do Zapier)  →  Destino que você escolher

Você não precisa programar nada. Todo o caminho é feito clicando, e o artigo de teste do ClickHunt serve para você ver os campos antes de publicar de verdade.

Antes de começar

• ClickHunt no plano Pro. O webhook é um destino de publicação do plano Pro. Se você ainda não conhece o webhook, o artigo Webhook: mande os artigos para o seu próprio sistema explica tudo o que ele envia.
• Zapier num plano pago. O app "Webhooks by Zapier" é um app premium do Zapier e não está disponível no plano gratuito. Cada artigo processado conta como uma tarefa (task) na sua cota mensal do Zapier.
• Uma conta no destino (a planilha, o CMS, o canal do Slack, o que for).

Passo 1: pegue a URL do webhook no Zapier

1. Entre no zapier.com e clique em Create e depois em Zaps para abrir o editor com um Zap em branco.
2. Clique no primeiro passo, Trigger. Na busca de apps, digite e escolha Webhooks by Zapier.
3. No campo Trigger event, escolha Catch Hook (não o "Catch Raw Hook"). Clique em Continue.
4. Na aba de configuração aparece o campo Pick off a Child Key. Deixe em branco. Clique em Continue.
5. Na aba Test, o Zapier mostra a sua URL única, parecida com https://hooks.zapier.com/hooks/catch/1234567/abcdefg/. Clique em Copy.

Deixe essa aba aberta. Você vai voltar a ela no passo 3.

Passo 2: conecte o ClickHunt à URL do Zapier

1. No ClickHunt, abra Integrações no projeto e escolha Webhook. Se o projeto ainda está sendo criado, escolha "Meu próprio sistema (webhook)" no wizard.
2. Em URL, cole a URL do Zapier exatamente como ela veio, com a barra no final.
3. Deixe Cabeçalhos em branco. O Zapier não exige nenhum.
4. Em Eventos, marque só o que você quer que chegue no Zapier. Se a sua automação só trata artigo novo, deixe apenas publicado marcado. Desmarcar aqui é mais simples do que filtrar no Zapier depois.
5. Em Formatos, marque HTML para destinos que aceitam texto formatado (WordPress, HubSpot, e-mail) e Markdown para destinos que preferem texto puro (Notion, GitHub, Slack). Deixe Blocos desmarcado, a menos que você vá programar em cima do JSON.
6. Clique em Conectar. O ClickHunt envia um ping para o Zapier, o Zapier responde na hora e a conexão fica pronta.
7. O ClickHunt mostra o segredo de assinatura uma única vez. O Zapier não usa esse segredo (veja "Assinatura" mais abaixo), mas guarde mesmo assim.
8. Ainda no painel do webhook, clique em Enviar artigo de teste. Isso manda um artigo completo de exemplo para o Zapier, e é com ele que você vai montar o mapeamento dos campos.

Passo 3: teste o gatilho no Zapier

1. Volte à aba Test do passo Trigger no Zapier e clique em Test trigger (em algumas contas o botão se chama Find new records).
2. O Zapier lista as requisições que recebeu. Vão aparecer duas: o ping e o artigo de teste. Escolha a que tem o campo event igual a article.test e clique em Continue with selected record. O ping não traz artigo, então não serve para mapear campos.
3. O Zapier mostra todos os campos do artigo, prontos para serem usados no passo seguinte.

Os campos aninhados do payload aparecem no Zapier com dois sublinhados no lugar do ponto. Os mais úteis:

Listas (categorias, tags, imagens) chegam separadas por vírgula ou como itens de linha, dependendo do destino. O payload completo, com todos os campos, está no artigo do webhook.

Passo 4: escolha o destino

1. Clique no passo Action (o "+" abaixo do Trigger) e busque o app de destino.
2. Em Action event, escolha o que o Zapier deve fazer lá. Exemplos: "Create Spreadsheet Row" no Google Sheets, "Create Database Item" no Notion, "Create Post" no WordPress, "Send Channel Message" no Slack, "Send Email" no Gmail.
3. Em Account, conecte a sua conta do destino (ou escolha uma que já esteja conectada). Clique em Continue.
4. Na aba Configure, preencha os campos do destino. Ao clicar num campo, o Zapier abre a lista de dados do passo 1: escolha article__title para o título, article__body__html para o corpo, e assim por diante. Você pode misturar texto fixo com dados do artigo no mesmo campo.
5. Clique em Continue e depois em Test step. O Zapier executa a ação de verdade, com o artigo de teste: a linha aparece na planilha, o post aparece no WordPress como rascunho, a mensagem chega no Slack. Confira lá.
6. Se ficou como você queria, clique em Publish no canto superior direito. O Zap fica ligado.

A partir daí, cada artigo publicado no ClickHunt percorre o caminho inteiro sozinho, em segundos.

Exemplos de mapeamento

Para o WordPress, o ClickHunt já tem uma integração nativa, que traz o link do artigo de volta e cuida de imagens e categorias. Use o Zapier para o WordPress só se você precisar de algum passo intermediário que a integração nativa não faz.

Vários eventos, vários caminhos

O caminho mais simples é marcar no ClickHunt só o evento que interessa (passo 2, item 4). Se você precisa tratar mais de um evento de forma diferente, use os apps internos do Zapier entre o gatilho e a ação:

• Filter by Zapier: adicione um passo "Only continue if…" com event (Text) Exactly matches article.published. O Zap segue só para artigo novo e ignora os outros eventos.
• Paths by Zapier: cria um caminho por evento (publicado cria, atualizado edita, excluído remove). Lembre que o article.deleted chega enxuto, só com id, slug e previousSlugs, sem o resto do artigo.

Se você quer mandar o mesmo artigo para dois destinos, não precisa de dois webhooks: adicione uma segunda ação no mesmo Zap. O ClickHunt tem um webhook por projeto, e o Zapier faz a distribuição.

Assinatura

Toda entrega do ClickHunt vai assinada no cabeçalho X-ClickHunt-Signature. O "Catch Hook" do Zapier descarta os cabeçalhos, então nesse caminho a assinatura não é verificada. Na prática isso não é um problema: a URL do Zapier é longa, única e só você conhece, e ela funciona como a chave da porta.

Se a sua empresa exige a verificação, troque o gatilho por Catch Raw Hook (que mantém os cabeçalhos) e valide a assinatura num passo Code by Zapier com o código do artigo do webhook. É um caminho para quem programa.

Limites e detalhes

• O link "Ver no Blog" fica desativado no ClickHunt. O Zapier responde à entrega com o seu próprio identificador interno, não com o endereço final do artigo no destino. O ClickHunt só mostra o link quando o endpoint devolve uma url, e o Zapier não devolve. O endereço do artigo fica no próprio destino.
• Zap desligado. Se o Zap estiver desligado (pausado) quando um artigo for publicado, ele não é processado. Depois de religar, use Reenviar na aba Histórico do webhook no ClickHunt para mandar o artigo de novo.
• Retentativas. Se o Zapier estiver indisponível, o ClickHunt tenta de novo (5 minutos, 15 minutos, 1 hora, 6 horas), sempre com o mesmo deliveryId. Se o seu destino não tolera duplicata, use o deliveryId como chave de deduplicação.
• Tamanho. O Zapier aceita até 10 MB por requisição. Um artigo do ClickHunt, mesmo com os três formatos marcados, fica muito abaixo disso.
• Edições em rajada. Várias edições do mesmo artigo em menos de 15 segundos geram um único article.updated, então o Zapier não é inundado.

Perguntas frequentes

Funciona com o Make ou o n8n? Sim, com os mesmos passos. Nos dois, o gatilho se chama "Webhook": crie o webhook, copie a URL, cole no ClickHunt, mande o artigo de teste e monte o restante.

Posso testar sem publicar um artigo de verdade? Sim. O botão Enviar artigo de teste do painel do webhook entrega um artigo completo de exemplo com event igual a article.test. O Zapier trata ele como qualquer outro, então dá para testar o caminho inteiro. Se a sua ação cria algo no destino (uma linha, um post), lembre de apagar o item de teste depois.

Os artigos que eu já tinha publicado antes de conectar vão para o Zapier? Não. O webhook só entrega o que acontece a partir da conexão.

Preciso do segredo de assinatura em algum campo do Zapier? Não. Guarde ele, mas o Catch Hook não usa.