Integrar com Hubla

Conecte sua conta Hubla ao TrackCombo para rastrear vendas e eventos automaticamente via webhook.

# Requisitos

• Conta de produtor na Hubla
• Container criado no TrackCombo

# Passo a Passo

# 1. Adicione a Integração no TrackCombo

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

# 2. Configure o Webhook na Hubla

O TrackCombo usa o webhook v2 da Hubla (versão atual). Configure assim:

1. Acesse o Painel da Hubla e clique em Integrações no menu lateral
2. Desça até a seção Automações e clique em Webhook
3. Abra a aba Configurações e clique em Adicionar regra
4. Em Nome, use algo como "TrackCombo"
5. Em URL, cole a URL copiada do TrackCombo
6. Em Produtos, selecione Todos os seus produtos (ou os produtos que quer rastrear)
7. Em Eventos, marque Pagamento da fatura realizado (invoice.payment_succeeded)
8. Salve a regra

Esse único evento cobre vendas avulsas e assinaturas (o pagamento aprovado de qualquer fatura). Não é preciso selecionar outros eventos.

# 3. Teste a Integração

1. Faça uma compra de teste no seu produto Hubla e conclua o pagamento
2. No TrackCombo, acesse o container e vá em Logs
3. Verifique se o evento de venda apareceu corretamente
4. Confirme que os dados (nome, email, valor, produto) foram recebidos

# Dados Rastreados

A integração envia automaticamente:

• ID da transação
• Nome, email e telefone do comprador
• Documento (CPF/CNPJ) do comprador
• Endereço de cobrança (cidade, estado, CEP, país)
• Valor da compra e moeda
• Nome do produto
• Método de pagamento (PIX, cartão, etc.)
• Parâmetros de campanha (UTMs) e cookies de rastreamento (fbclid, sck) capturados no checkout

Esses dados de campanha e cookies vêm no próprio webhook v2, o que melhora a qualidade das conversões enviadas para as plataformas de anúncios.

# Dicas Importantes

• A URL do webhook é única por container. Não compartilhe entre containers diferentes
• Se você alterar o container, será necessário atualizar a URL na Hubla
• Só o evento Pagamento da fatura realizado é processado. Faturas pendentes (pix gerado e não pago) não geram conversão, como esperado

# Problemas Comuns

Vendas não aparecem no TrackCombo?

• Verifique se a URL do webhook está correta na regra da Hubla
• Confirme que o evento Pagamento da fatura realizado está marcado
• Confirme que a regra cobre o produto da venda (em Produtos)
• Aguarde até 5 minutos para o processamento

Dados incompletos?

• Verifique se o comprador preencheu todos os campos no checkout da Hubla
• Campos opcionais podem chegar vazios dependendo da configuração do produto