Zapier: conectando o Zenovay ao Zapier

O Zapier permite conectar o Zenovay a milhares de outros apps sem escrever código. O Zenovay não publica um app Zapier dedicado — em vez disso, você encaminha eventos do Zenovay para o Zapier usando um webhook. Aponte um webhook do Zenovay para uma URL de « Catch Hook » do Zapier e você pode encaminhar conclusões de goal para seu CRM, enviar eventos para uma Google Sheet ou disparar uma mensagem do Slack quando o tráfego aumentar.

Como funciona

Os webhooks do Zenovay são de saída: quando algo acontece em um site rastreado, o Zenovay faz um POST de um payload JSON para uma URL que você especificar. O trigger Webhooks by Zapier do Zapier lhe fornece uma URL única de « Catch Hook » — cole isto em um webhook do Zenovay e cada evento correspondente inicia um zap.

Eventos que você pode encaminhar

Quando você cria um webhook, escolhe quais eventos o disparam:

• goal_completed — uma conclusão de goal/conversão foi concluída.
• traffic_spike — um aumento incomum do tráfego.
• traffic_drop — uma queda incomum do tráfego.
• error_spike — um aumento em erros de JavaScript front-end.
• website_down — o monitoramento de disponibilidade detectou que o site está fora do ar.
• website_up — o site foi recuperado.

Cada entrega inclui o tipo de evento no header X-Zenovay-Event e é assinada com HMAC-SHA256 no header X-Zenovay-Signature: sha256=<hex>, para que você possa verificar que veio do Zenovay.

Configurando

1. 1

   Crie o trigger do Zapier

   No Zapier, crie um novo zap e escolha Webhooks by Zapier → Catch Hook como o trigger. Copie a URL do webhook personalizado que o Zapier fornece.

2. 2

   Crie o webhook do Zenovay

   No Zenovay, acesse Settings → Webhooks, selecione o site e clique em Adicionar webhook. Cole a URL de Zapier Catch Hook (apenas HTTPS), nomeie-a (por ex. « Zapier ») e escolha os eventos que deseja encaminhar.

3. 3

   Envie um evento de teste

   Salve o webhook e clique em Enviar um evento de teste. O Zapier receberá o payload de amostra para que você possa mapear os campos em seu zap.

4. 4

   Finalize o zap

   De volta ao Zapier, adicione sua ação (Google Sheets, Slack, seu CRM, etc.), mapeie os campos do payload e ative o zap.

Exemplo: conclusões de goal para uma Google Sheet

1. Trigger: Webhooks by Zapier → Catch Hook (cole a URL em um webhook do Zenovay inscrito em goal_completed).
2. Ação: Google Sheets → Criar linha → mapeie os campos do payload do Zenovay (timestamp, nome do goal, fonte, país, etc.).
3. Teste o zap e o ative.

Cada nova conclusão de goal adicionará uma linha à planilha logo após dispará.

Enviar eventos na outra direção

O Zapier só pode receber eventos do Zenovay via webhooks — não há ação do Zenovay que escreva eventos de um zap de volta em sua analytics. Para registrar seus próprios eventos (por exemplo, um purchase após um pagamento do Stripe), envie você mesmo: use o comando track ou revenue do tracker in-page (window.zenovay('track', 'purchase', { ... })), ou envie de seu backend. Veja Enviar um evento personalizado para a API do navegador e Rastreamento do lado do servidor para a abordagem backend.

Limites de taxa

As entregas de webhooks respeitam os limites da sua conta — consulte limites de API. Para volumes de eventos muito altos, mantenha seus zaps enxutos e use filtros no Zapier para que você apenas atue sobre os eventos que se importa.

Disponibilidade por plano

Os webhooks — e portanto esta integração com Zapier — estão disponíveis no plano Pro e superior. O plano Free não inclui webhooks.

Leitura relacionada

• Integração de webhooks
• Visão geral da API
• Obtendo sua chave de API