--- title: "Integração Yampi: webhook de vendas e trackeamento" description: "Integre a Yampi ao Sparkle Tracker pelo webhook: 4 eventos, da venda ao reembolso, cada um ligado ao anúncio de origem. Passo a passo completo." url: https://sparkletracker.com/integracoes/yampi updated: 2026-11-12 language: pt-BR --- **INTEGRAÇÃO NATIVA** Yampi # Integração Yampi e Sparkle Tracker: _cada venda ligada ao anúncio de origem_ A Yampi avisa o Sparkle Tracker pelo webhook a cada venda, a cada pagamento gerado e a cada devolução. O Sparkle liga o evento ao lead, mostra de qual campanha, conjunto e criativo ele veio e envia a compra para o Meta e o Google. Webhook e API Compra enviada ao Meta e ao Google A partir do plano Pro [Teste grátis por 7 dias](https://sparkletracker.com/planos#planos) [Ver o passo a passo](https://sparkletracker.com/integracoes/yampi#passo-a-passo) **4** eventos da Yampi lidos pelo Sparkle **4** efeitos no painel: venda aprovada, venda iniciada, checkout iniciado e reembolso Resposta rápida ## Como rastrear as vendas da Yampi por anúncio? Para saber de qual anúncio veio cada venda da Yampi, cadastre na Yampi o link de webhook do **Sparkle Tracker**. A cada venda, a Yampi avisa o Sparkle, que liga a venda ao lead pelo telefone ou pelo e-mail do comprador. O lead já tem a campanha, o conjunto e o criativo do clique. A venda aparece no painel com essa origem e segue para o Meta e para o Google como compra. A venda devolvida desconta o valor do faturamento. É uma das [integrações nativas](https://sparkletracker.com/integracoes) do Sparkle Tracker. Atualizado em 12 de novembro de 2026 **Webhook e API** da Yampi **4 eventos** lidos, da venda ao reembolso Venda com **campanha, conjunto e criativo** O que chega ## Quais eventos da Yampi _o Sparkle Tracker recebe?_ São os eventos que você marca ao cadastrar o webhook na Yampi. Cada um tem um efeito diferente no painel. Eventos da Yampi e o efeito de cada um no Sparkle Tracker | Evento na Yampi | No Sparkle Tracker | Efeito | | --- | --- | --- | | Pedido pago order.paid | Venda aprovada | Entra no faturamento e envia a compra (Purchase) para o Meta e o Google | | Pedido criado order.created | Venda iniciada | Mostra quem gerou o pagamento e ainda não pagou. Não conta como venda | | Lembrete de carrinho, se a conta tiver cart.reminder | Checkout iniciado | Entra no funil como início de checkout, para recuperar quem não terminou | | Pedido reembolsado order.refunded | Reembolso | Desconta o valor do faturamento, para o ROAS do anúncio não ficar inflado | Pixel e UTM ## Pixel no checkout da Yampi _ou venda pelo webhook?_ O pixel no checkout depende do navegador do comprador. O webhook sai do servidor da Yampi e chega ao Sparkle com a venda confirmada. Como a origem do anúncio chega até a venda da Yampi | Pergunta | Como funciona com o Sparkle Tracker | | --- | --- | | Quem avisa que a venda aconteceu | A Yampi, pelo webhook, de servidor para servidor. Não depende do navegador nem de a pessoa voltar para a página de obrigado. | | Como a venda acha o anúncio | Pelo telefone ou e-mail do comprador, que o Sparkle compara com o lead. O lead já carrega a campanha, o conjunto e o criativo do primeiro clique. | | Para onde vão as UTMs | Na Venda Direta, o script do Sparkle guarda as UTMs por 30 dias e acrescenta UTMs, src, sck e xcod em todo link que leva ao checkout. O checkout guarda esses campos e devolve na venda. | | O que volta para o Meta e o Google | A compra (Purchase) com a origem, enviada pelo Sparkle. Para o Google Ads, a conversão vai quando o clique veio de um anúncio do Google. | A venda confirmada pelo gateway _não depende do que o navegador deixou passar._ Passo a passo ## Como integrar a Yampi _ao Sparkle Tracker_ Você precisa de uma operação criada no Sparkle e de acesso de administrador ou produtor na Yampi. ### 1Ative a integração no Sparkle 1. No painel do Sparkle, abra **Integrações**, encontre o cartão **Yampi** e clique em **Ativar integração**. 2. Em **Operação**, escolha de qual operação são as vendas e clique em **Continuar**. 3. Copie o link de webhook gerado pelo botão ao lado dele, sem montar o endereço à mão. Cada operação tem um link próprio. Para vender em mais de uma operação, gere um link para cada. ### 2Cole as credenciais de API da Yampi 1. Na Yampi, abra a tela **Credenciais de API**, no menu do seu perfil ou em Configurações, e copie o **User Token** e o **User Secret Key**. O **Alias da loja** é o nome curto da loja, sem espaços, que aparece nessa mesma tela e no endereço do painel. 2. Volte ao Sparkle, cole os valores e clique em **Testar e ativar**. A conexão é testada na hora. ### 3Crie o webhook na Yampi 1. Na Yampi, abra a tela de **Webhooks**, em Configurações. Se não achar, procure por "Webhooks" em Configurações ou em Apps. 2. Clique no botão de criar webhook. 3. Em **Nome**, escreva um nome que identifique a operação. 4. No campo de **URL**, cole o link copiado do Sparkle. 5. Marque todos os eventos da tabela acima e salve o webhook. ### 4Teste com uma compra 1. Faça uma compra de teste, ou use o botão de teste do painel, se houver. 2. No Sparkle, abra **Logs de Eventos**: a chamada aparece em poucos segundos. 3. Abra **Leads Capturados** e clique no comprador. Em Histórico de ações, a venda aparece com gateway, produto e valor. O guia com as telas está na documentação: [integração Yampi no Sparkle Tracker](https://docs.sparkletracker.com/yampi). Além do webhook ## O que as credenciais de API da Yampi _acrescentam?_ O webhook traz a venda. Com Alias da loja, User-Token e User-Secret-Key salvos, o Sparkle também lê a Yampi pela API. **Venda que o webhook perdeu** O Sparkle confere os pedidos na Yampi e recupera o pedido pago que não chegou pelo webhook. A mesma integração por webhook também está pronta para [Kirvano](https://sparkletracker.com/integracoes/kirvano), [Doppus](https://sparkletracker.com/integracoes/doppus), [Perfect Pay](https://sparkletracker.com/integracoes/perfectpay), [Braip](https://sparkletracker.com/integracoes/braip), [Payt](https://sparkletracker.com/integracoes/payt), [Ticto](https://sparkletracker.com/integracoes/ticto) e [Logzz](https://sparkletracker.com/integracoes/logzz), além de [Hotmart](https://sparkletracker.com/integracoes/hotmart), [Kiwify](https://sparkletracker.com/integracoes/kiwify), [Cakto](https://sparkletracker.com/integracoes/cakto) e [Eduzz](https://sparkletracker.com/integracoes/eduzz). Do mesmo assunto ## Outras integrações _e o que fazer com a venda_ [**Integração Kirvano** Eventos e passo a passo do webhook da Kirvano](https://sparkletracker.com/integracoes/kirvano)[**Integração Doppus** Eventos e passo a passo do webhook da Doppus](https://sparkletracker.com/integracoes/doppus)[**Integração Perfect Pay** Eventos e passo a passo do webhook da Perfect Pay](https://sparkletracker.com/integracoes/perfectpay)[**Trackeamento de vendas** Como a venda do gateway é ligada ao lead e ao anúncio](https://sparkletracker.com/trackeamento-de-vendas)[**Todas as integrações** Gateways, e-commerces, pixels, CRMs, API e webhooks](https://sparkletracker.com/integracoes)[**Trackeamento de venda direta** Página de vendas e checkout, sem WhatsApp no meio](https://sparkletracker.com/venda-direta) FAQs ## Dúvidas sobre _a integração Yampi_ Ative a integração Yampi no painel do Sparkle Tracker e escolha a operação. Cole as credenciais de API (Alias da loja, User-Token e User-Secret-Key). Copie o link de webhook gerado e cadastre esse link na Yampi, marcando todos os eventos de venda, pagamento pendente e devolução. Uma compra de teste confirma se a venda chegou. É o aviso que a Yampi, plataforma brasileira de e-commerce e checkout para lojas online, manda de servidor para servidor a cada evento de venda. Você cadastra um endereço na Yampi e escolhe os eventos. Para o Sparkle Tracker, esse endereço é o link gerado na integração. São 4: pedido pago, pedido criado, lembrete de carrinho e pedido reembolsado. Cada um vira um efeito no painel: venda aprovada, venda iniciada, checkout iniciado e reembolso. Sai. Com os eventos de devolução marcados no webhook, o valor é descontado do faturamento, e o ROAS e o lucro do anúncio que trouxe a venda ficam corretos. Há duas causas comuns. O comprador usou no checkout um telefone ou e-mail diferente do que tinha como lead, e a venda entrou como um lead novo de Venda Direta. Ou o anúncio estava sem o modelo de UTM nos parâmetros de URL. O modelo fica em Operações e UTMs, na aba UTMs. As integrações com checkouts, gateways e e-commerces fazem parte dos planos Pro, Expert e Growth. [Ver os planos](https://sparkletracker.com/planos). ## Veja de qual anúncio veio _a próxima venda da Yampi._ Ative a integração, cadastre o webhook e acompanhe a venda voltar ao criativo de origem. 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/integracoes/yampi para agentes de IA. Índice do site: https://sparkletracker.com/llms.txt