Pixel na Woovi: Facebook, Google Ads e TikTok
Envie cada cobrança PIX paga na Woovi (OpenPix) pro Facebook, Google Ads, GA4, TikTok, Pinterest, Taboola e OpenAI pela API de Conversões, server-side.
A integração com a Woovi (OpenPix) envia cada cobrança PIX paga (OPENPIX:CHARGE_COMPLETED) pros pixels do Facebook (Meta), Google Ads, GA4, TikTok, Pinterest, Taboola e OpenAI, pela API de Conversões de cada plataforma (server-side). A venda vai como evento de compra com valor em reais, ID da transação, nome do pagador e, quando a cobrança tem um cliente cadastrado com esses dados, email, telefone e o ID do cliente (correlationID).
O webhook da Woovi não traz os cookies do navegador nem as UTMs. Por isso o Track Combo cruza a venda com a visita registrada pela Web Tag na página onde o cliente gera o PIX e completa o evento com fbp, fbc, gclid, ttclid e UTMs antes de enviar pros pixels. Como a Woovi muitas vezes não manda email nem telefone, esse cruzamento é o que liga a venda ao anúncio.
Requisitos
- Conta ativa na Woovi
- Projeto criado no TrackCombo
- Web Tag instalada na página onde o cliente gera o PIX, pra venda ser ligada ao clique no anúncio
- Pelo menos um pixel cadastrado no projeto com a API de Conversões ativa
Passo a Passo
1. Adicione a Integração no TrackCombo
- Abra seu projeto no TrackCombo
- Vá em Integrações
- Clique em + Nova Integração
- Selecione Woovi
- Copie a URL do webhook gerada pelo TrackCombo
2. Configure o Webhook na Woovi
- Acesse o Painel da Woovi
- Vá em Configurações > Webhooks
- Adicione uma nova URL de webhook
- Cole a URL copiada do TrackCombo
- Selecione apenas o evento de cobrança paga (OPENPIX:CHARGE_COMPLETED)
- Salve a configuração
3. Teste a Integração
- Faça um pagamento de teste
- No TrackCombo, acesse o projeto e vá na aba Eventos
- Verifique se o evento de pagamento apareceu corretamente
Pixels que funcionam com a Woovi
A Woovi gera um único evento no Track Combo: a cobrança PIX paga (OPENPIX:CHARGE_COMPLETED), tratada como compra (purchase). Cada pixel recebe a venda com o nome que a plataforma de anúncio espera.
Facebook (Meta)
Cobrança paga na Woovi vira Purchase na API de Conversões, com valor, moeda, ID da transação e dados do comprador. Precisa do Token de Conversão cadastrado no pixel. Veja como configurar o pixel do Facebook.
Google Ads
Cobrança paga vira a conversão de compra do Google Ads. O envio usa o Conversion Label que você cadastra no pixel pro evento purchase; sem label, a venda não é enviada. Veja como configurar o pixel do Google Ads.
GA4 (Google Analytics)
Cobrança paga vira purchase no GA4 pelo Measurement Protocol, com valor, moeda, ID da transação e as UTMs da visita registrada pela Web Tag. A Woovi não manda itens no webhook. Precisa do API Secret no pixel. Veja como configurar o GA4.
TikTok
Cobrança paga vira CompletePayment na Events API do TikTok. Precisa do token de acesso no pixel. Veja como configurar o pixel do TikTok.
Cobrança paga vira checkout, o evento de compra da API de Conversões do Pinterest. Precisa do token no pixel. Veja como configurar o pixel do Pinterest.
Taboola
Cobrança paga vira make_purchase. Só vão pro Taboola as vendas de quem chegou por um anúncio do Taboola (com o clique tbclid registrado pela Web Tag). Veja como configurar o pixel do Taboola.
OpenAI (anúncios no ChatGPT)
Cobrança paga vira order_created na Conversions API da OpenAI. Veja como configurar o pixel da OpenAI.
Dados Traqueados
A integração envia automaticamente:
- ID da transação
- Valor do pagamento (a Woovi manda em centavos e o TrackCombo converte pra reais)
- Nome do pagador
- Email e telefone do cliente (quando cadastrados na cobrança)
- ID do cliente na Woovi (
correlationID) - Método de pagamento (PIX)
Problemas Comuns
Como instalar o pixel do Facebook na Woovi?
Cadastre o pixel do Facebook com o Token de Conversão no seu projeto do Track Combo e conecte a Woovi pelo webhook (passo a passo acima). Cada cobrança paga chega no Facebook como Purchase pela API de Conversões, sem depender do navegador do comprador.
A Woovi envia conversões pro Google Ads?
Sim. Com a integração ativa e o pixel do Google Ads cadastrado com o Conversion Label de compra, cada cobrança paga na Woovi é enviada como conversão. O gclid vem da visita registrada pela Web Tag na página onde o PIX foi gerado.
Por que marcar só o evento OPENPIX:CHARGE_COMPLETED no webhook?
A integração da Woovi não filtra o tipo de evento: todo webhook que chega é tratado como compra. Marcar outros eventos (cobrança criada, cobrança expirada) pode fazer PIX gerado e não pago aparecer como venda nos seus pixels.
Pagamentos não aparecem no TrackCombo?
- Verifique se a URL do webhook está correta na Woovi
- Confirme que os eventos estão selecionados
- Aguarde até 5 minutos para o processamento