AISAC SocialAISAC Social Docs
Integracoes

Compras da Hotmart no CRM

Traga as compras da sua conta Hotmart para o CRM — quem comprou, qual produto, status e de onde e o comprador — e filtre contatos por compra e por localizacao.

Com a sincronizacao ligada, cada compra da sua conta Hotmart vira (ou atualiza) um contato no CRM: voce passa a ver quem comprou, qual produto, o status da compra e a localizacao declarada pelo comprador. Isso substitui o cruzamento de planilhas para saber "quem ja comprou o produto X".

Pre-requisitos

  1. Plano Pro no AISAC Social.
  2. Para as compras novas: o webhook da Hotmart configurado em uma conexao WhatsApp (veja Integracao com Hotmart).
  3. Para o historico: as credenciais de API da Hotmart conectadas em Configuracoes → Hotmart.

Como ligar

  1. Abra Configuracoes → Hotmart e va ate o card Compras no CRM.
  2. Leia o aviso de finalidade e ligue a sincronizacao.
  3. Em Importar desde, o padrao e "desde o inicio" (01/01/2011). Se quiser, escolha uma data mais recente.

Ao ligar pela primeira vez, o historico comeca a ser importado. O card mostra o progresso ("Importando… 640 vendas lidas, 412 contatos atualizados") e, no fim, o resumo da ultima sincronizacao. Uma conta com alguns milhares de vendas termina em poucos minutos.

Depois disso:

  • Compras novas chegam pelo webhook em segundos.
  • Todo dia as 06:00 (Brasilia) uma revisao confere os ultimos 45 dias e pega reembolsos dentro da garantia e eventos que o webhook nao entregou.
  • O botao Importar historico traz tudo de novo quando voce precisar (uma vez por hora).

O que e gravado

  • Da compra: produto, status e datas do pedido e da aprovacao.
  • Do comprador: nome, e-mail, telefone e a localizacao declarada (pais, estado e cidade).
  • Nao gravamos CPF, endereco (rua, numero, CEP) nem valor da compra.

O status da Hotmart vira um de cinco grupos:

No CRMStatus da Hotmart
AprovadaAprovada, Completa
PendenteAguardando pagamento, Boleto impresso, Em analise, Iniciada, Pre-venda, Processando, Atrasada
CanceladaCancelada, Expirada, Sem saldo, Bloqueada
ReembolsadaReembolsada, Parcialmente reembolsada
ChargebackChargeback, Reclamada (pedido de reembolso)

Quem tem uma compra aprovada passa para o estagio Cliente. O AISAC Social nunca rebaixa o estagio de um contato por causa de reembolso.

No CRM

  • Coluna Compras: ate dois produtos comprados e "+N" quando ha mais.
  • Coluna Local: cidade/UF ou so a UF. O sinal ≈ marca o que e estimado pelo DDD.
  • Filtros Tag e Comprou o produto. "Comprou" considera so compras aprovadas.
  • No contato, a secao Compras lista as compras da mais recente para a mais antiga.
  • O Exportar CSV ganha as colunas pais, estado, cidade e localizacao_estimada.

Editar a localizacao

No contato, os campos Pais, Estado e Cidade podem ser editados. O que voce editar fica marcado como "editado por voce" e a Hotmart nao muda mais. Limpar localizacao apaga os campos e deixa a Hotmart preencher de novo.

Onde estao

No CRM, o botao Onde estao mostra um ranking por pais, estado, cidade ou regiao do DDD, para os compradores (com filtro de produto e de status) ou para todos os contatos. A linha de cobertura no topo diz quanto e informado, quanto e estimado e quanto nao tem localizacao. A tabela abaixo do grafico tem os mesmos numeros.

Estimativa pelo DDD

A Hotmart quase nunca traz estado e cidade de compradores brasileiros (o pais vem sempre). Para preencher esse buraco, o AISAC Social estima o estado pelo DDD do telefone. E so uma estimativa: o DDD e onde a linha foi habilitada, nao onde a pessoa mora (portabilidade e mudanca de cidade nao aparecem). Por isso ela sempre aparece marcada e pode ser desligada em Incluir estimativa pelo DDD.

Limites conhecidos

  • Telefone diferente do WhatsApp: se a pessoa comprou com um telefone e conversa com voce por outro, o AISAC Social nao liga as duas coisas sozinho. Quando o contato tem os dois (por exemplo, a IA juntou pelo e-mail), funciona.
  • Compradores de fora do Brasil entram pelo e-mail, sem chave de telefone.
  • Venda como coprodutor ou afiliado ainda nao foi testada em conta real.
  • Contato apagado que comprou nos ultimos 45 dias volta na revisao diaria.

Desligar e apagar

Ao desligar a sincronizacao, voce escolhe entre manter as compras ja importadas ou apagar todas (digitando APAGAR para confirmar). Apagar remove so as compras; os contatos continuam no CRM. Mesmo sem o plano Pro, voce pode apagar as compras quando quiser.

Problemas comuns

  • "Credencial da Hotmart invalida" — reconecte as credenciais em Configuracoes → Hotmart e clique em Importar historico.
  • "A Hotmart limitou as consultas" — espere alguns minutos e importe de novo.
  • "Voce ja importou o historico na ultima hora" — a importacao manual e uma por hora; a revisao diaria continua rodando.
  • Compra nova nao aparece — confira se o webhook da Hotmart esta configurado na conexao WhatsApp e se a sincronizacao esta ligada.

Veja tambem: Integracao com Hotmart.

On this page