Integrando com a Hotmart

Com a integração oficial da Ensinio com a Hotmart, você pode vender seus produtos na Hotmart e receber seus usuários em sua área de membros premium na Ensinio para que tenham uma experiência muito superior, digna do seu negócio digital. Desta forma, você consegue manter sua base de vendas na Hotmart, além de reter seus afiliados, sem ter que sacrificar a experiência do seu cliente.

Neste artigo, vamos te explicar como você pode configurar Entregas de produtos vendidos na Hotmart para que usuários acessem o conteúdo posteriormente em sua área de membros na Ensinio.

Antes de começar

Para você configurar uma Entrega via Hotmart, é necessário que alguns requisitos sejam satisfeitos, então confira e garanta que está tudo OK antes de prosseguir, tudo certo?

• Você precisa ter uma conta na Hotmart

• Você precisa ter um produto aprovado na Hotmart

• Plano ativo na Ensinio com a opção de Checkouts Externos habilitada

• Uma conta administrativa na área de membros com permissão para criar integrações/entregas

Certifique-se de que já criou a integração na Ensinio antes de prosseguir com este artigo.

Caso ainda não tenha feito, acesse o artigo:

Checkout Externo: Integrando com Outra Plataforma de Vendas

Criando uma integração externa com a Hotmart

Para criar uma integração com a Hotmart é necessário obter alguns dados que devem ser obtidos na sua conta na Hotmart:

1. Código de identificação do seu produto

2. Token de autenticação

Siga esses passos:

1. No "Admin Console", vá até App Store na barra lateral de navegação.

2. Clique em "Checkouts externos".

3. Clique em " + Criar nova integração externa " para configurar uma nova Entrega.

4. No modal com informações sobre os benefícios de utilizar a Ensinio Pay, você pode clicar em Entendi, quero continuar caso não queira seguir com a integração.

5. Configure a nova Entrega definindo um "Nome de entrega". Esse nome é apenas para identificação interna e você pode chamá-lo como desejar.

6. Adicione o Código do produto na plataforma. Esse é o código de identificação do seu produto na Hotmart.

7. Adicione o Token de autenticação, obtido na Hotmart.

8. Crie um webhook na Hotmart e adicione nele a URL de postback indicada na página da integração aqui na Ensinio.

9. Selecione o grupo que os usuários obterão acesso através dessa integração.

10. Habilite, ou não, a expiração do acesso.

11. Clique em "Salvar".

Onde encontrar o código do produto na Hotmart

Para encontrar o código de identificação do seu produto na Hotmart, vá até a Central do Vendedor na Hotmart e busque pelo produto desejado.

1. Acesse sua conta na Hotmart.

2. No menu lateral esquerdo, clique no ícone de caixa e selecione Meus Produtos.

1. Na lista, localize o seu produto. O ID (um número de 6 a 7 dígitos) estará listado logo abaixo ou ao lado do nome do produto.

2. Se você clicar para editar o produto, esse mesmo número também aparecerá no final da URL do seu navegador (ex: .../product/XXXXXXX)

Agora você precisa configurar o Token de autenticação.

Obtendo o Token de autenticação

Este token possibilita garantir que a informação é realmente enviada pela Hotmart e não foi forjada por um ator malicioso.

1. Vá em Ferramentas, seguido de Ver todas.

1. Procure e clique na opção Webhook (API e notificações) ou busque diretamente na barra de busca da página.

1. Dentro da área de Webhook, clique na aba Autenticação.

2. Copie o código alfanumérico exibido em "Hottok de verificação".

1. Cole o token no campo "Token de autenticação" solicitado na página de configuração da integração na Ensinio.

Criando o webhook /Adicionando URL de postback na Hotmart

É na configuração do webhook que você vai colar a U"RL de postback" informada na página de integração na Ensinio (logo acima do campo "Token de autenticação").

1. Ainda na tela de Webhook (API e Notificações) da Hotmart, clique no botão " + Cadastrar Webhook " no canto superior direito.

Para concluir o cadastro do Webhook na tela da Hotmart exibida na imagem, você precisa preencher e marcar as seguintes informações antes de salvar:

• Nome da configuração

• Selecione um produto

• URL para envio de dados

• Selecione uma versão

• Eventos para enviar

• Nome da configuração

  Digite um nome para identificar essa integração. Recomendo algo direto, como Integração Ensinio.

• Selecione um produto

  Clique no campo e escolha na lista o produto específico que você vai vender na Hotmart e entregar pela Ensinio.

• URL para envio de dados

  Cole aqui a URL de postback gerada na sua integração na Ensinio. Para encontrá-la, acesse no Admin Console da sua plataforma Ensinio: App Store > Checkouts externos, clique na integração criada e copie a URL exibida no campo "URL de postback". Ela terá um formato semelhante a: https://suaplataforma.ensinio.cloud/api/v2/postback/hotmart.

• Selecione uma versão

  Mantenha a opção padrão já selecionada: 2.0.0 (Recomendado).

• Eventos para enviar

  Clique no campo, abra o menu de seleção e marque todas as opções de eventos disponíveis (como Compra Aprovada, Cancelada, Reembolso, etc.), conforme o seu plano de marcar todos.

Clique em "Salvar".

Configurando a expiração da inscrição

Na seção "Expiração da inscrição", você define por quanto tempo o usuário terá acesso ao conteúdo após a compra.

• Se o acesso for vitalício, mantenha a opção "Habilitar expiração da inscrição" desativada.

• Se o acesso for por tempo limitado, ative a opção e defina o período de acesso.

Essa configuração é recomendada para venda de produtos de pagamento único, já que o checkout externo não envia a expiração do acesso automaticamente.

Selecionando o grupo que o usuário receberá acesso

1. Na seção "Grupo que o usuário receberá acesso", clique em "+ Selecionar grupo".

2. Escolha o grupo ao qual o usuário deverá ter acesso após a compra ser confirmada pela Asaas.

Com tudo preenchido, clique em "Salvar", no canto superior direito, para concluir a configuração.

Você pode criar mais de uma entrega para o mesmo grupo caso o mesmo produto seja vendido em plataformas diferentes.

A integração funcionou?

Faça testes de compra, para verificar se o acesso será criado na Plataforma corretamente.

Removendo uma integração de Entrega

Caso você não queira mais receber novos usuários a partir de vendas realizadas na Hotmart, você pode excluir a integração de Entrega na Ensinio. Desta forma, mesmo que a Hotmart envie para nós informações sobre novas compras, nós não iremos processar ou conceder acesso aos usuários notificados a nós pela Hotmart.

Note que notificações realizadas enquanto uma integração de Entrega não está ativa serão perdidas e não podem ser reprocessadas, você precisará recriá-las ou, se possível, re-enviar as notificações a partir da Hotmart para que o sistema receba todas e processe novamente.

1. Acesse o Admin Console.

2. Vá até App Store na barra lateral de navegação.

3. Clique em Checkouts externos para conferir as integrações.

4. Clique no ícone de lixeira no canto direito.

5. Confirme que você está ciente que a ação é irreversível clicando em Excluir integração.

6. Pronto, a integração está removida e sua área de membros não receberá novos usuários a partir desta Entrega via Hotmart.

Checklist rápido: Integração com Hotmart

Antes de começar:

• Já criou a integração na Ensinio (artigo "Checkout Externo: Integrando com Outra Plataforma de Vendas")

Na Hotmart

• Copiei o Código de identificação (ID) de 7 dígitos em Meus Produtos

• Copiei o Token de Verificação (Hottok) na aba Ferramentas > Webhook (API e Notificações) > Autenticação

• Criei o webhook em Ferramentas > Webhook (API e Notificações) > Configurações > + Cadastrar Webhook

• Colei a URL de Webhook gerada pela Ensinio no campo "URL para envio de dados"

• Selecionei o produto correspondente que será vendido

• Selecionei a versão 2.0.0 (Recomendado)

• Selecionei todos os eventos disponíveis na lista para envio de notificações

• Marquei a caixa de confirmação sobre a conformidade no tratamento de dados

Na Ensinio

• Preenchi o Nome da entrega

• Colei o ID do produto no campo Código do produto na plataforma

• Colei o Token de Verificação (Hottok) no campo Token de autenticação

• Configurei a expiração da inscrição, se o produto for de pagamento único

• Selecionei o Grupo que receberá acesso ao conteúdo

• Cliquei em Salvar no canto superior direito

Por fim

• Fiz uma compra teste para confirmar que o acesso é liberado corretamente