Integrar com Principia

Conecte sua conta Principia ao TrackCombo para rastrear o progresso de solicitações de crédito e conversões de vendas.

# Requisitos

• Conta de parceiro na Principia
• 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 Principia
5. Copie a URL do webhook gerada pelo TrackCombo

# 2. Configure o Webhook na Principia

1. Acesse o Portal do Parceiro
2. Vá em Configurações > Integrações > Webhooks
3. Clique em Criar webhook
4. Cole a URL copiada do TrackCombo
5. Salve a configuração

# 3. Teste a Integração

1. Crie uma solicitação de teste na Principia
2. No TrackCombo, acesse o container e vá em Logs
3. Verifique se os eventos de status estão sendo recebidos
4. Confirme que os dados do aluno e da transação foram registrados

# Eventos de Status Rastreados

A Principia envia eventos conforme o progresso da solicitação:

• basic_info_incomplete — Aluno iniciou mas não completou informações básicas
• document_info_incomplete — Documentação pendente
• approved — Solicitação de crédito aprovada
• waiting_signature — Contrato enviado ao aluno, aguardando assinatura
• signed — Contrato assinado
• waiting_payment — Aguardando pagamento ou análise de crédito
• made_effective — Venda efetivada, aluno ativo
• paid_first_installment — Primeira parcela paga

# Dados Rastreados

• CPF do aluno
• Valor do checkout (em centavos)
• ID do consultor/vendedor
• Histórico de status (logs)
• Cursos associados

# Dicas Importantes

• O evento made_effective é o mais importante — indica a conversão final
• Valores são enviados em centavos (ex: R$ 2.990,00 = 299000) — o TrackCombo converte automaticamente
• Use o CPF como identificador para rastrear o funil completo do aluno

# Problemas Comuns

Eventos não chegam?

• Verifique se a URL do webhook está correta no portal da Principia
• Confirme que o webhook está ativo
• Consulte o suporte da Principia se necessário

Conversão não registra como purchase?

• Verifique se o status made_effective está mapeado como evento de compra no TrackCombo
• Confira nos logs se o payload está chegando completo