Hotmart: autorizar a conta — os três campos, o vínculo por loja, o plano e o que remover apaga

O QUE VOCÊ AUTORIZA AQUI

A integração é o que dá ao sistema o direito de ler as suas vendas na Hotmart. Sem ela, nada mais funciona dentro do aplicativo: a tela inicial não mostra os atalhos e as demais telas avisam que aquela loja não está integrada. Autorizar não é um passo opcional, é o primeiro passo.

Uma coisa que autorizar NÃO faz: trazer venda. Ligar a conta só abre a porta. Trazer as vendas é outro passo, na tela de Vendas do aplicativo, e tem fonte própria nesta pasta. Quem espera ver pedido no ERP logo depois de configurar vai achar que a integração falhou, e não falhou.

A TELA DE APRESENTAÇÃO E OS CINCO ITENS QUE ELA PROMETE

Sem conta ligada, a tela de Integração abre numa página de apresentação com cinco itens, e a lista é fechada: Importação de vendas, Emissão de notas fiscais, Cadastro de clientes, Sincronização de infoprodutos e Automação e integração.

Leia o segundo item com cuidado, porque ele gera expectativa errada. Emissão de notas fiscais quer dizer que a venda importada fica pronta para virar nota no módulo fiscal do ERP. Nada dentro deste aplicativo emite documento fiscal.

Nessa mesma página existe um botão só, e ele muda conforme a situação: sem conta ligada aparece Adicionar integração, que leva ao formulário Configurar Integração; com conta ligada aparece Remover integração.

OS TRÊS CAMPOS DO FORMULÁRIO

O formulário de integração tem exatamente três campos, e todos são obrigatórios: Client ID, Client Secret e Basic Auth. A lista é fechada. Não existe quarto campo, não existe login, senha ou e-mail da Hotmart. Preenchidos os três, o botão que grava chama Configurar.

Se algum ficar em branco, a própria tela bloqueia o envio e destaca o campo — nada é enviado e nenhuma integração é criada. Chegando ao servidor sem um dos três, a recusa é a mensagem daquele campo: "O ClientId é obrigatório.", "O Client Secret é obrigatório." ou "O Basic Auth é obrigatório.".

A própria tela avisa onde encontrar esses dados: acesse sua conta de vendedor na Hotmart e navegue até o menu Ferramentas, Ver todas, Credenciais Hotmart. Esse é o único caminho dentro da Hotmart que o suporte orienta. O resto da configuração da plataforma é assunto do parceiro.

Nunca envie, cole nem repita esses valores em atendimento. São credenciais. Se um deles já apareceu numa conversa, considere-o exposto: gere outro no portal da Hotmart e use o novo.

O QUE ACONTECE AO CLICAR EM CONFIGURAR

Antes de salvar qualquer coisa, o sistema tenta autenticar na Hotmart com os três dados. Só se a Hotmart aceitar é que o registro é gravado. Por isso não existe integração salva com dado errado: ou entra funcionando, ou não entra.

Se a autenticação não passar, a resposta é "Falha na autenticação com o Hotmart. Verifique os dados e tente novamente.". Atenção: essa é a mensagem única de qualquer problema nessa etapa. Ela aparece tanto quando a Hotmart recusa os três valores quanto quando a comunicação com a Hotmart falha. Não conclua a causa pela mensagem. As causas mais comuns são credencial criada em outra conta, credencial revogada ou apagada na Hotmart, cópia incompleta de um dos três campos e, ocasionalmente, indisponibilidade momentânea da Hotmart — nesse último caso, tentar de novo minutos depois resolve.

Dando certo, aparece "Integração configurada com sucesso." e você volta para a tela inicial do aplicativo.

Na mesma gravação o sistema registra o uso do recurso para a sua empresa e loja. Se esse registro falhar, a integração recém-criada é apagada: nada fica pela metade, e você precisa tentar de novo.

A AUTORIZAÇÃO VALE POR EMPRESA E POR LOJA

Este é o ponto que mais gera chamado. A integração é gravada com a empresa e a loja em que você estava no momento de configurar. Toda consulta posterior procura a integração exatamente nessa empresa e nessa loja.

Consequência prática: quem troca de loja dentro do sistema pode cair numa loja que nunca foi integrada. O aplicativo então avisa "Esta loja não está integrada ao Hotmart.", a tela inicial deixa de mostrar os atalhos e passa a exibir o cartão de apresentação com o botão Adicionar integração, e as telas de Usuários, Grupos de usuários e Planos abertas por dentro do aplicativo devolvem você para a tela de Integração.

Isso não é erro nem perda de dado. É outra loja. Para trabalhar a Hotmart em mais de uma loja, é preciso configurar em cada uma. Antes de dizer que "parou", confira qual loja está selecionada. O conceito de vínculo por loja é o mesmo de todas as integrações do ERP e está explicado na fonte geral de Integrações.

O TOKEN RENOVA SOZINHO

Ao autorizar, o sistema guarda também um token de acesso com prazo de validade. A cada operação do aplicativo ele compara esse prazo com a hora atual e, se já venceu, se reautentica na Hotmart usando as credenciais salvas e grava o token novo. Você não precisa reconfigurar nada por causa de token vencido, e não existe botão de renovar — não há o que fazer de tempos em tempos.

Por isso, quando a integração "para do nada", quase nunca é o token. É credencial revogada, apagada ou trocada na Hotmart. Nesse caso a renovação automática também passa a falhar e as telas do aplicativo passam a mostrar a mesma mensagem de falha na autenticação. O caminho é gerar credencial nova no portal da Hotmart e reconfigurar — lendo antes a seção seguinte, porque remover a integração não é um passo inofensivo.

O QUE ACONTECE AO REMOVER — LEIA ANTES DE REMOVER

Há dois lugares que removem, e os dois fazem a mesma coisa. Na tela de Integração existe o botão Remover integração, com a confirmação "Deseja realmente remover sua integração do Hotmart?". Na tela de Adicionar integração, quando a conta já está vinculada, o formulário não aparece: no lugar dele vem o aviso "Sua conta Hotmart está vinculada com o sistema." e o botão Desvincular, com a confirmação "Deseja realmente remover sua conta?".

Remover apaga o registro da integração daquela empresa e loja, baixa o uso do recurso e apaga junto tudo o que o aplicativo havia registrado para aquela loja:

  • os mapeamentos de formas de pagamento entre a Hotmart e o ERP;
  • os mapeamentos de situações de venda;
  • os vínculos de clientes, produtos e serviços já sincronizados;
  • o registro das vendas já importadas e o histórico de sincronizações do aplicativo.

O que foi criado no ERP permanece: cliente cadastrado, pedido gerado, movimentação financeira e nota emitida continuam no ERP, porque são dados do ERP e não do aplicativo. O que se perde é a ligação entre eles e a Hotmart.

Isso tem um efeito prático importante. Como o aplicativo evita reimportar uma venda comparando com o registro dele — é ele que produz o aviso "Todas as vendas no período informado ja foram sincronizadas." —, depois de remover e configurar de novo as vendas antigas deixam de ser reconhecidas como sincronizadas. Sincronizar um período já trabalhado pode gerar pedido repetido no ERP. Se precisar reconfigurar, sincronize a partir da data de retomada e confira antes de puxar período antigo.

Remover, portanto, não é "desligar a sincronização por uns dias". Sem integração o aplicativo simplesmente não consulta mais a Hotmart, e os mapeamentos precisam ser refeitos depois. O efeito de remover uma integração, em termos gerais, está na fonte geral de Integrações.

Dá para configurar de novo depois? Dá. A tela volta a oferecer Adicionar integração e você refaz com os três campos, que precisam estar válidos na Hotmart naquele momento. Adicionar e remover ficam registrados no log do sistema, então dá para saber quem fez e quando.

SEM PLANO, O APLICATIVO INTEIRO PARA

A checagem de plano vale para todas as telas do aplicativo, inclusive a própria integração. Sem plano que contemple a integração com a Hotmart, a resposta é "O seu plano atual não lhe permite integrar com o Hotmart. Por favor, contrate outro plano!", e o sistema encaminha para Meu plano levando essa mensagem. Não adianta refazer as credenciais: como configurar a integração também passa por essa checagem, nem a gravação funciona enquanto o plano não permitir. Preço e condição são assunto do time comercial.

Se a mensagem for "Você não tem permissão para acessar esta área!", o assunto é permissão de usuário, não integração. Veja a fonte de permissões. Uma observação útil: configurar e remover a integração não passam por essa checagem de permissão, então quem já entra no aplicativo consegue fazer as duas coisas.

OS OITO ATALHOS DA TELA INICIAL

Com a integração ativa, a tela inicial mostra oito atalhos, e essa lista é fechada: Clientes, Vendas, Produtos, Serviços, Formas de pagamento, Situações, Integração e Usuários. Não há outros.

TELAS QUE PARECEM DO APLICATIVO MAS SÃO DO ERP

Dentro do aplicativo Hotmart, as telas de Usuários, Grupos de usuários, Permissões, Planos, Lojas, Domínios e Ajuda não pertencem ao aplicativo: são as mesmas telas do ERP, reaproveitadas. O que você mudar ali vale no sistema inteiro, não só na Hotmart. Usuário criado ali é usuário do ERP; permissão alterada ali muda o acesso em todos os módulos. Para dúvidas sobre esses cadastros, use as fontes do próprio ERP em vez de tratá-los como configuração da Hotmart. Um detalhe que confunde: os blocos de permissão do Hotmart só aparecem quando você abre Usuários por dentro do aplicativo. Isso é assunto da fonte de permissões do Hotmart.

O QUE COSTUMA DAR ERRADO

Credencial gerada no lugar errado da Hotmart. O cliente pega um dado de outra área da plataforma e cola nos três campos, e recebe falha na autenticação. Os três valores saem juntos, do mesmo lugar, na conta de vendedor, em Ferramentas, Ver todas, Credenciais Hotmart.

Autorizar numa loja e cobrar o resultado em outra. Configurou na loja A, trabalha na loja B e reclama que "sumiu" ou que "não existe integração". A integração está lá, na loja A.

Remover achando que só desliga a sincronização. O cliente remove para "dar uma pausa" e perde, além da autorização, todos os mapeamentos e o registro das vendas já importadas.

Reconfigurar e sincronizar tudo de novo. Depois de remover, o aplicativo não sabe mais o que já foi importado. Sincronizar período antigo pode duplicar pedidos no ERP.

Colar a credencial no atendimento. A partir daí ela deve ser tratada como exposta: gere outra na Hotmart e reconfigure.

Insistir em refazer credencial quando a trava é de plano. A mensagem de plano não muda com credencial nova.

O QUE NÃO É DESTA FONTE

Esta fonte responde por ligar e desligar a conta. Sincronizar vendas, gerar a venda uma a uma, o de-para de situações e de formas de pagamento, a escolha entre produto e serviço e as listas e relatórios do aplicativo têm cada um a sua fonte nesta pasta; a visão geral e o índice da Hotmart, também. Permissão e o aplicativo não aparecer para ninguém são da fonte de permissões. O desenho comum das integrações, o vínculo por loja e o efeito de remover estão na fonte raiz de Integrações. Configuração dentro da plataforma Hotmart e geração de credenciais são do suporte da Hotmart.