Skip to main content
A integração com a Hotmart permite que a Timely.ai reaja automaticamente a eventos do seu produto digital — aprovação de compra, reembolso, cancelamento de assinatura e muito mais. O fluxo começa quando a Hotmart entrega um evento ao webhook da Timely.ai e termina com uma mensagem personalizada para o comprador.
Painel de integracao Hotmart

​
Conectando sua conta

1

Acesse a pagina de integracao

No menu lateral, vá até Integrações > Hotmart.
2

Adicione uma conexao

Clique em Nova Conexão e informe um nome identificador. A Timely.ai gerará automaticamente a URL do webhook e o hottok de segurança.
3

Configure o webhook na Hotmart

No painel da Hotmart, acesse Ferramentas > Webhooks e cadastre a URL gerada. Cole o hottok no campo correspondente da Hotmart para autenticar os eventos.
4

Confirme a conexao

Clique em Testar conexão na Timely.ai. A Hotmart enviará um evento de teste e você verá a confirmação de recebimento.
A URL do webhook segue o padrão: POST /functions/v1/hotmart-webhook?company_id={seu-company-id}. Cada empresa tem sua própria URL — nunca compartilhe a mesma URL entre contas diferentes.

​
Eventos suportados

A Timely.ai processa 14 tipos de eventos da Hotmart, organizados em dois grupos:

​
Ciclo de vida de compra

Evento HotmartO que significa
PURCHASE_APPROVEDCompra aprovada — gatilho principal de boas-vindas
PURCHASE_COMPLETEPagamento compensado (tratado igual ao aprovado)
PURCHASE_CANCELEDCompra cancelada pelo comprador
PURCHASE_REFUNDEDReembolso processado
PURCHASE_PROTESTContestação aberta
PURCHASE_CHARGEBACKChargeback registrado
PURCHASE_EXPIREDPrazo de pagamento expirado
PURCHASE_DELAYEDPagamento em análise
PURCHASE_BILLET_PRINTEDBoleto gerado (aguardando pagamento)
PURCHASE_OUT_OF_SHOPPING_CARTAbandono de carrinho

​
Ciclo de vida de assinatura

Evento HotmartO que significa
SUBSCRIPTION_CANCELLATIONAssinatura cancelada
SWITCH_PLANMudança de plano
UPDATE_SUBSCRIPTION_CHARGE_DATEAlteração da data de cobrança
CLUB_FIRST_ACCESSPrimeiro acesso ao Clube Hotmart

​
Automações por evento

Na aba Automações da integração, você ativa ou desativa individualmente as respostas automáticas para cada tipo de evento. Por exemplo:
  • PURCHASE_APPROVED → enviar mensagem de boas-vindas + link de acesso
  • PURCHASE_REFUNDED → enviar mensagem de confirmação de reembolso
  • SUBSCRIPTION_CANCELLATION → iniciar fluxo de retenção ou pesquisa de saída
  • PURCHASE_OUT_OF_SHOPPING_CART → enviar mensagem de recuperação de carrinho
A autenticação usa o campo hottok enviado pela Hotmart no corpo do payload (ou no header X-Hotmart-Hottok). Eventos recebidos sem o hottok correto são rejeitados com 401. Guarde o secret gerado em local seguro.

​
Templates de mensagem

Na aba Templates, você personaliza as mensagens enviadas para cada evento. Use variáveis dinâmicas populadas com dados do payload da Hotmart:
VariávelDado
{{comprador_nome}}Nome do comprador
{{produto_nome}}Nome do produto comprado
{{valor}}Valor da transação
{{data_compra}}Data da aprovação

​
Log de eventos e métricas

  • Aba Eventos: exibe todos os eventos recebidos com status de processamento (pending, processed, failed), timestamp e payload completo.
  • Aba Métricas: gráficos de volume de eventos por tipo e taxa de sucesso de processamento ao longo do tempo.
Use o log de eventos para depurar configurações. Se um evento aparece como failed, o payload recebido fica armazenado para inspeção — facilitando a identificação de problemas de mapeamento.