Quiz iniciado
Quando a pessoa informa o telefone e começa, a ferramenta envia o primeiro evento. O lead nasce, ou é encontrado, pelo telefone.
SOB MEDIDAO evento que o seu funil precisaQualquer evento do funil
Operações Personalizadas: qualquer evento do seu funil ligado ao anúncio
Quiz, formulário, CRM ou checkout próprio enviam o evento para o Sparkle Tracker por webhook ou API. O evento é ligado ao lead pelo telefone e ganha a campanha, o conjunto e o criativo de origem.
Webhook de entrada e API REST
Evento com o nome que você definir
Planos Expert e Growth
Histórico de ações · um lead de quiz
Exemplo
Clicou no anúncioMeta · Criativo 04
origemQuiz IniciadoSparkle Webhook
eventoQuiz FinalizadoSparkle Webhook
eventoPurchaseSparkle API · Mentoria · R$ 1.997,00
vendaNomes de evento ilustrativos
3portas: webhook de entrada, API e webhook de saída
1chave que liga tudo: o telefone do lead
Resposta rápida
O que são Operações Personalizadas?
Operações Personalizadas são os funis que não se encaixam em grupo, conversa ou checkout integrado. Um quiz, um formulário, uma etapa do CRM ou um checkout próprio enviam um evento para o Sparkle Tracker, com o telefone da pessoa e o nome do evento.
O Sparkle Tracker liga esse evento ao lead pelo telefone. Se o lead já tinha origem, o evento herda a campanha, o conjunto e o criativo. O evento aparece no histórico do lead e segue para a Meta com o nome que você enviou. Para a venda que chega de plataformas prontas, veja o trackeamento de vendas.
Atualizado em
Webhook ou API, do jeito que o seu sistema envia
Ligado ao lead pelo telefone
Vai à Meta com o nome do seu evento
As três portas
Webhook de entrada, API ou webhook de saída: qual usar?
As duas primeiras trazem eventos para dentro do Sparkle. A terceira leva os eventos do Sparkle para o seu sistema.
| Porta | Como funciona | Quando usar |
|---|---|---|
| Webhook de entrada | O seu sistema envia um POST em JSON para um link do Sparkle. Você mapeia no painel qual campo do seu JSON é o telefone, o nome do evento e o valor | Ferramenta que já dispara webhook, como quiz, formulário, n8n, Make e Zapier |
| API REST | O seu sistema envia o evento com um token no cabeçalho, em campos fixos | Sistema próprio, com desenvolvedor, que precisa de controle e de resposta estruturada |
| Webhook de saída | O Sparkle envia cada evento de lead, com a origem, para a URL que você cadastrar | Levar entradas, saídas, conversas e eventos para o CRM, a planilha ou a automação |
O seu JSON, do seu jeito
No webhook de entrada o corpo pode ter a estrutura que o sistema já usa, com objetos aninhados. O mapeamento é feito no painel.
Reenvio não duplica
Com um identificador do evento, o reenvio do mesmo evento é recusado e a resposta traz o lead original.
Valor em centavos e em outra moeda
Valor em centavos é convertido, e outra moeda é convertida para real.
O exemplo do quiz
Como ver quem finalizou o quiz e quem parou no meio?
A ferramenta de quiz dispara um webhook em cada etapa. O Sparkle recebe, liga ao lead e mostra a origem.
Quiz finalizado
Ao terminar, um segundo evento chega com outro nome. No histórico do lead ficam os dois, com data e hora.
Quem parou no meio
É quem tem o evento de início e não tem o de fim. A diferença entre os dois mostra onde o funil perde gente.
De volta para a Meta
Cada evento vai à Meta com o nome que você enviou. Dá para criar público e conversão personalizada com quem finalizou.
O mesmo vale para formulário, etapa de CRM e reunião agendada. Muda só o nome do evento.
Campos
Quais campos o evento pode levar?
O telefone é o único obrigatório. Os demais enriquecem o lead e o evento.
| Campo | Exemplo | Para que serve |
|---|---|---|
| Telefone | 5511999999999 | Obrigatório. É a chave que liga o evento ao lead, de preferência com o código do país |
| Nome do evento | Quiz Finalizado | Aparece no histórico e vai à Meta como está. Sem nome, nada é enviado à Meta |
| Identificador do evento | ord_9f2a | Evita duplicar: o reenvio com o mesmo identificador é recusado |
| Valor e moeda | 97,00 e BRL | Somam ao valor que o lead já gerou. No webhook, só são lidos quando mapeados |
| Produto | Curso X | Aparece no histórico do lead e vai à Meta |
| Operação | op_a1b2c3d4e5 | Vincula o lead a uma operação. Vale na primeira vez: quem já tem operação fica na dele |
| UTMs e identificadores de clique | utm_source, fbclid, gclid | Para o sistema que captura a origem por conta própria e quer enviar junto |
| Campos livres | vendedor: Ana | Na API, dados do lead em chave e texto, que aparecem nos campos personalizados |
A resposta diz de onde veio a origem do lead: do corpo enviado, do que o lead já tinha, do histórico de cliques ou orgânica.
Como montar
O primeiro evento por webhook em três passos
Você precisa de um sistema que envie POST com corpo em JSON e do telefone do lead em algum campo.
1
Crie o link do webhook
Em Integrações, abra Webhooks e clique em Criar novo webhook. Copie a URL e cole no seu sistema. A URL é a senha do link.
Um link por webhook
2
Envie um teste e mapeie
Envie um POST de teste e clique em Recarregar JSON. Aponte qual campo é o telefone, o nome do evento, o valor e a moeda, e salve o mapeamento.
Preenchimento automático pelos nomes
3
Confira no lead
Envie de novo. Em Leads Capturados, o evento aparece no histórico como Sparkle Webhook, com o produto e o valor, e dá para abrir o JSON recebido.
Histórico com o JSON recebido
Antes e depois
Evento solto × evento com origem
Cada ferramenta com o seu relatório
- O quiz sabe quem finalizou, mas não de qual anúncio veio
- O CRM sabe quem fechou, sem campanha nem criativo
- A Meta só enxerga o clique e a visita
- Juntar tudo depende de exportar planilhas
Você sabe o que aconteceu, e não sabe o que causou.
Com Operações Personalizadas
- Cada evento no histórico do lead, com a origem
- O nome do evento é o seu, do quiz à venda fechada
- O evento volta para a Meta, para público e otimização
- O webhook de saída devolve tudo para o seu CRM
Você vê qual anúncio traz quem chega até o fim do funil.
Nos planos Expert e Growth
A API Sparkle e os webhooks fazem parte do Expert e do Growth. A quantidade de links de webhook e de eventos por dia vem do plano e aparece no painel.
Do mesmo assunto
O que usar junto com o seu funil
FAQs
Dúvidas sobre Operações Personalizadas
Dá. A ferramenta de quiz envia um webhook quando a pessoa começa e outro quando termina, com o telefone e o nome do evento. O Sparkle Tracker liga os eventos ao lead e mostra a campanha, o conjunto e o criativo de origem. Quem tem o início e não tem o fim parou no meio.
No webhook de entrada, o seu sistema envia o JSON que já usa para um link, e você mapeia os campos no painel, sem código. Na API REST, o envio leva um token no cabeçalho e usa campos fixos, o que dá mais controle para quem tem desenvolvedor.
Pelo telefone. Se o lead já existe com uma origem registrada, o evento herda essa origem. Se o seu sistema captura as UTMs e os identificadores de clique por conta própria, eles podem ser enviados no corpo. Sem nenhum dos dois, o lead entra como orgânico.
Vai, com o nome que você enviou, desde que o evento tenha nome e exista um pixel cadastrado. Como todo evento personalizado novo, ele chega bloqueado e precisa ser liberado nas configurações do pixel, na Meta, antes de ser usado nas campanhas.
Funciona. Qualquer ferramenta que envie um POST com corpo em JSON pode usar o webhook de entrada. No sentido contrário, o webhook de saída envia cada evento de lead para a URL do seu fluxo de automação.
Existe. O webhook de entrada aceita até 3.000 requisições por minuto por IP, com corpo de até 5 MB, e a API aceita até 200 requisições por minuto por IP. A quantidade de links e de eventos por dia vem do plano.
A API Sparkle e o envio de eventos por webhook fazem parte dos planos Expert e Growth. Ver os planos.
Ligue o seu funil ao anúncio que o alimenta.
Crie o link de webhook, envie o primeiro evento e veja de qual criativo veio quem chegou até o fim. 7 dias grátis no plano mensal.