XQuiz

Zapier

Nó de integração que dispara um Zap com as variáveis da sessão quando o visitante passa por ele no fluxo

Zapier é uma integração: um nó do fluxo que dispara um Zap num ponto da jornada, enviando um POST com as variáveis da sessão. Você o arrasta da paleta, aberta pelo botão Criar, do grupo Integrações — ao lado de HTTP Request, ActiveCampaign, RD Station e Google Sheets. Tem uma entrada e uma única saída, sem ramo de sucesso ou de erro: depois de disparar, o fluxo segue para o nó conectado. Não há credencial a cadastrar nem app no marketplace do Zapier: tudo fica na URL colada no próprio nó. Na aba Configurações há só o campo Nome, identificação interna.

Antes de começar

No Zapier, crie um Zap e escolha o gatilho Webhooks by Zapier, evento Catch Hook — ele gera a URL do Catch Hook. Copie essa URL; é ela que você cola no campo abaixo. O botão Abrir o Zapier, no nó, leva à página do app Webhooks by Zapier no Zapier.

O que você configura

Na aba Conteúdo, o único campo é:

  • URL do webhook — obrigatória; a URL do Catch Hook copiada do Zapier, no formato https://hooks.zapier.com/hooks/catch/.... Só aceita https://. Se o host colado não for hooks.zapier.com, um aviso aparece — não bloqueia (proxy ou domínio alternativo do Zapier são legítimos), mas vale conferir antes de publicar.

Não há mapeamento de campos: o payload é fixo — todas as variáveis do funil vão no envio. Escolher quais usar, e o de-para com os campos do Zap, é feito do lado do Zapier, no passo de teste a seguir.

Testando e mapeando os campos

Com a URL colada, o botão Enviar teste dispara um POST real para o Catch Hook, com valores de exemplo no lugar das variáveis. É esse envio que faz o editor do Zapier reconhecer os campos disponíveis para mapear nas ações do seu Zap. Volte à aba do Zapier, mapeie os campos recebidos e publique o Zap. Por fim, publique o funil: o nó usa a URL da versão publicada.

O que é enviado

O corpo do POST é um objeto plano, sem aninhamento, com:

  • submittedAt — data e hora do disparo, em ISO 8601.
  • funnelId — o ID do funil.
  • uma chave por variável do funil, com o nome exato da variável (veja Variável).

Se uma variável do funil se chamar submittedAt ou funnelId, ela substitui o metadado de mesmo nome no envio.

No funil publicado

Ao passar pelo nó, o disparo acontece em segundo plano e o fluxo segue na hora: nada trava, o visitante não espera nem vê erro. O limite é de 10 segundos, não há reenvio em caso de falha ou timeout, e a falha é silenciosa. O nó só funciona com o funil publicado; no modo Testar ele não executa. Alterações no nó só valem depois de publicar de novo.

Onde conferir o resultado

Não há histórico de disparos em Leads nem em Analytics. Use o botão Enviar teste, no próprio nó, para checar o status da chamada. A confirmação de que o Zap disparou de verdade é no histórico de execuções do próprio Zapier.

Nesta página