Como Conectar Webhooks de Quiz
Webhooks de quiz enviam dados estruturados de envio do AtomicQuiz para um endpoint seguro que você controla — CRM, middleware, ferramentas de automação ou sistemas de pontuação personalizados.
Configure-os em Configurações do quiz → Webhooks e depois publique para que visitantes ao vivo disparem a configuração.
Antes de Começar
Certifique-se de ter:
- Um quiz aberto no editor do AtomicQuiz (salvo, com etapas e Fluxo prontos).
- Um endpoint HTTPS pronto para receber payloads JSON (TLS obrigatório).
- Nomes de webhook que sua equipe reconhecerá nos logs.
- Acesso a Entrega de webhooks de quiz ou logs do seu receptor para verificação.
Webhooks rodam em paralelo a Leads — envios ainda são armazenados no Atomicat quando Leads está habilitado.
Veja Webhooks de quiz (referência).
Passo 1: Abrir Configurações de Webhook
- Abra o quiz no editor.
- Clique em Configurações no cabeçalho.
- Selecione Webhooks na barra lateral de configurações.
Passo 2: Adicionar um Webhook
- Clique em Adicionar webhook.
- Preencha:
| Campo | Requisito |
|---|---|
| Nome do webhook | Rótulo interno curto (obrigatório). |
| URL do webhook | Deve começar com https:// (obrigatório). |
| Descrição | Notas opcionais da equipe. |
- Escolha um gatilho de envio (próximo passo).
- Clique em Salvar no painel de webhooks.
O produto valida nome e URL e rejeita URLs que não sejam HTTPS.
Passo 3: Escolher um Gatilho de Envio
| Gatilho | Quando dispara |
|---|---|
| A cada etapa | Depois que o respondente completa uma etapa do quiz — útil para enriquecimento progressivo. |
| Gatilho baseado em clique | Quando itens clicáveis selecionados disparam a ação configurada — informe identificadores separados por vírgula conforme o produto solicita. |
Notas:
- Voltar para A cada etapa limpa automaticamente listas de identificadores baseados em clique.
- Use gatilhos baseados em clique quando apenas botões ou opções específicos devem disparar o webhook.
Encontre identificadores nos rótulos do editor de quiz exibidos para itens clicáveis configurados para ações.
Passo 4: Revisar o Payload de Exemplo
A tela de configura ções inclui uma entrega de exemplo para sua equipe técnica preparar o receptor:
- Tipo de evento e metadados do quiz
- Respostas e status de conclusão
- Tempo e contexto básico do visitante
Nomes de campos de resposta dependem de como você nomeou perguntas e opções no Construtor.
Compartilhe o exemplo com quem implementa o endpoint antes de ir ao ar.
Passo 5: Salvar e Publicar
- Salve webhooks nas configurações.
- O produto lembra de publicar o quiz — alterações de webhook se aplicam ao tráfego ao vivo somente após publicar.
- Clique em Publicar e confirme site/domínio/slug. Veja Como publicar um quiz.
Salvamentos de webhook em rascunho não afetam visitantes na URL já publicada até você republicar.
Passo 6: Testar na URL Publicada
- Abra o link HTTPS ao vivo do quiz em anônimo.
- Complete um caminho que deve disparar o webhook.
- Confirme que seu endpoint recebeu o payload.
- Abra Entrega de webhooks de quiz no Atomicat para inspecionar status de entrega quando disponível.
Teste cada tipo de gatilho que você habilitou (conclusão de etapa vs baseado em clique).
Opcional: Chaves de API
Se seu destino valida remetentes confiáveis, configure chaves via Chaves de API de webhook e combine a validação no seu servidor.
Solução de Problemas
| Problema | O que tentar |
|---|---|
| URL rejeitada | Use apenas HTTPS; verifique erros de digitação ou espaços. |
| Sem entrega no quiz ao vivo | Republice após salvar webhook; teste URL publicada, não só Visualização. |
| Gatilho por clique nunca dispara | Verifique se IDs separados por vírgula correspondem aos identificadores do editor. |
| Receptor retorna 4xx/5xx | Compare payload ao exemplo; verifique auth e validação de campos. |
| Eventos duplicados | Gatilho por etapa dispara por etapa — ajuste gatilho ou dedupe no servidor. |
Resultado
Seu quiz envia dados de envio para seu endpoint HTTPS nos gatilhos configurados — ao vivo após publicar e testável pelo receptor e logs de entrega do Atomicat.
Documentação Relacionada
- Webhooks de quiz (referência)
- Configurações de quiz
- Entrega de webhooks de quiz
- Chaves de API de webhook
- Visão geral de Leads
FAQ
Posso usar HTTP sem TLS?
Não. Apenas URLs HTTPS passam na validação.
Webhooks substituem Leads?
Não. Leads ainda armazena envios no Atomicat. Webhooks são um canal de entrega adicional.
Preciso republicar após editar webhooks?
Sim. Visitantes ao vivo usam a configuração publicada.
De onde vêm identificadores baseados em clique?
Use rótulos ou identificadores exibidos no editor de quiz para os itens clicáveis que você configurou.
Posso adicionar vários webhooks?
Sim. Adicione linhas separadas para cada destino com seu próprio nome, URL e gatilho.