🔌 Integrações

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

  1. Abra seu projeto no TrackCombo
  2. Vá em Integrações
  3. Clique em + Nova Integração
  4. Selecione Woovi
  5. Copie a URL do webhook gerada pelo TrackCombo

2. Configure o Webhook na Woovi

  1. Acesse o Painel da Woovi
  2. Vá em Configurações > Webhooks
  3. Adicione uma nova URL de webhook
  4. Cole a URL copiada do TrackCombo
  5. Selecione apenas o evento de cobrança paga (OPENPIX:CHARGE_COMPLETED)
  6. Salve a configuração

3. Teste a Integração

  1. Faça um pagamento de teste
  2. No TrackCombo, acesse o projeto e vá na aba Eventos
  3. 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.

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.

Pinterest

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
wooviintegraçãowebhookpixpagamentopixelapi de conversõesopenpix