--- title: "Rastreamento por webhook e API: quiz, CRM e formulário" description: "Ligue quiz, formulário, CRM ou checkout próprio ao anúncio de origem: envie eventos por webhook ou API e veja qual campanha trouxe quem chegou ao fim." url: https://sparkletracker.com/operacoes-personalizadas updated: 2026-11-12 language: pt-BR --- **SOB MEDIDA** O evento que o seu funil precisa Qualquer 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 [Teste grátis por 7 dias](https://sparkletracker.com/planos#planos) [Ver as três portas](https://sparkletracker.com/operacoes-personalizadas#tres-portas) **3** portas: webhook de entrada, API e webhook de saída **1** chave 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](https://sparkletracker.com/trackeamento-de-vendas). Atualizado em 6 de outubro de 2026 **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. Comparação entre webhook de entrada, API REST e webhook de saída | 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 iniciado Quando a pessoa informa o telefone e começa, a ferramenta envia o primeiro evento. O lead nasce, ou é encontrado, pelo telefone. ### 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. Principais campos de um evento enviado por webhook ou API | 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. Dados soltos Sem origem Planilha ### 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. Evento com origem Nome próprio Ida e volta ### 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. [Comparar os planos](https://sparkletracker.com/planos) Do mesmo assunto ## O que usar _junto com o seu funil_ [**Integração Meta Ads** Para onde vai o evento com o seu nome](https://sparkletracker.com/integracoes/meta-ads)[**Guia: evento personalizado no Meta Ads** Como liberar e usar o evento nas campanhas](https://sparkletracker.com/blog/evento-personalizado-meta-ads)[**Trackeamento de vendas** A venda dos checkouts integrados, sem código](https://sparkletracker.com/trackeamento-de-vendas)[**Para gestores de tráfego** Um funil por cliente, com o número real](https://sparkletracker.com/para/gestores-de-trafego) 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](https://sparkletracker.com/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. [Iniciar o teste grátis](https://sparkletracker.com/planos#planos) --- Versão em Markdown de https://sparkletracker.com/operacoes-personalizadas para agentes de IA. Índice do site: https://sparkletracker.com/llms.txt