Voltar para documentação
Integrações

Integração Hotmart

Conecte sua conta Hotmart ao Synchro Hub para receber vendas em tempo real e consolidar métricas no dashboard.

Conecte sua conta Hotmart ao Synchro Hub para receber vendas em tempo real e consolidar métricas no dashboard.

Visão geral

Ao integrar a Hotmart, o Synchro Hub passa a:

  • Receber webhooks de vendas, reembolsos, chargebacks, assinaturas e carrinhos abandonados em tempo real.
  • Consultar a API da Hotmart para importar histórico e enriquecer dados.

Tempo estimado: 10 minutos. O que você vai precisar:

  • Conta Hotmart com perfil de Produtor (ou Co-produtor com permissão).
  • Workspace já criado no Synchro Hub.

Pré-requisitos

  • Estar logado no Synchro Hub com um workspace selecionado.
  • Ter acesso ao painel da Hotmart em app.hotmart.com.

Passo 1 — Gerar as credenciais de API na Hotmart

  1. Entre em app.hotmart.com e selecione “Gerenciar meu negócio”.
  2. No menu, vá em Ferramentas → Credenciais Hotmart.
  3. Clique em Nova Credencial.
  4. Selecione o tipo API Hotmart, dê um nome (ex.: Synchro Hub) e salve.
  5. A Hotmart exibirá o Client ID e o Client Secret. Guarde-os — você vai colá-los no Passo 3.

Importante: nunca compartilhe seu Client Secret. Ele dá acesso total à sua conta via API.

Passo 2 — Conectar a plataforma no Synchro Hub

  1. No menu lateral, acesse Integrações.
  2. Clique em + Adicionar Plataforma.

Tela de Integrações

  1. Selecione Hotmart e clique em Confirmar.

Modal de seleção de plataforma

  1. O card da Hotmart aparece com os status Ativa e Webhook não configurado.

Card da integração Hotmart criada

Passo 3 — Salvar as credenciais (Client ID e Client Secret)

  1. No card da Hotmart, clique em Atualizar credenciais.
  2. Cole o Client ID e o Client Secret copiados no Passo 1.
  3. Clique em Salvar.

O Synchro Hub valida as credenciais em tempo real conectando-se à Hotmart. Se algo estiver errado, você verá uma mensagem de erro — nesse caso, gere novas credenciais na Hotmart e tente novamente.

Passo 4 — Configurar o webhook na Hotmart

  1. No card da Hotmart, clique em Configurar Webhook.
  2. Copie a URL do Webhook exibida. O formato é: 
    https://api.synchrohub.com.br/v1/webhooks/hotmart/{seu-integration-id}

Modal de configuração do webhook

  1. Em outra aba, abra app.hotmart.com → Ferramentas → Webhook (Postback 2.0).
  2. Clique em Criar Webhook.
  3. Cole a URL copiada no campo URL do seu servidor.
  4. Marque os eventos recomendados:
    • PURCHASE_APPROVED
    • PURCHASE_COMPLETE
    • PURCHASE_CANCELED
    • PURCHASE_REFUNDED
    • PURCHASE_CHARGEBACK
    • PURCHASE_BILLET_PRINTED
    • PURCHASE_EXPIRED
    • SUBSCRIPTION_CANCELLATION
    • PURCHASE_OUT_OF_SHOPPING_CART
  5. Salve. A Hotmart vai gerar e exibir um hottok (token do webhook). Copie esse valor.

Importante: o hottok é gerado pela Hotmart, não pelo Synchro. Ele só aparece após você salvar o webhook no painel da Hotmart.

Passo 5 — Ativar o webhook no Synchro Hub

  1. Volte para o modal Webhook Hotmart no Synchro Hub (Passo 4, item 1).
  2. Cole o hottok no campo Token do Webhook.
  3. Clique em Ativar Webhook.

O card da integração passa a exibir Webhook ativo.

Integração com webhook ativo

Verificação

Para confirmar que tudo está funcionando:

  1. Gere uma venda de teste na Hotmart (use o ambiente sandbox ou um cupom de 100% em um produto seu).
  2. Abra Vendas no menu lateral do Synchro Hub.
  3. A venda deve aparecer em até 1 minuto após a aprovação na Hotmart.

Solução de problemas

SintomaO que fazer
”Credenciais inválidas” ao salvarGere um novo par Client ID / Client Secret na Hotmart e tente novamente.
Nenhuma venda chega após horasConfira se a URL colada na Hotmart está completa (sem espaços) e se todos os eventos recomendados estão marcados.
”Token inválido” ao ativar o webhookO hottok pode ter sido copiado com espaços. Copie novamente direto do painel da Hotmart.
Vendas antigas não aparecemWebhooks só enviam eventos novos. Use a funcionalidade de Importação de Histórico (em breve) para backfill.

Perguntas frequentes

Tenho vários produtos na mesma conta Hotmart. Preciso integrar cada um? Não. A integração é feita pela conta (Client ID/Secret). Todos os produtos daquela conta enviam eventos para o mesmo webhook.

Posso reprocessar vendas antigas? A Hotmart permite reenvio manual de webhooks pela tela de Histórico de Postbacks. Alternativamente, aguarde a funcionalidade de importação de histórico no Synchro Hub (desde que seu plano contempla a funcionalidade de importação retroativas).

Como desconecto a integração? No card da Hotmart, clique em Remover. Os dados também será apagados da Synchro Hub. Lembre-se de remover também o webhook no painel da Hotmart para evitar tentativas de entrega sem destino.