> For the complete documentation index, see [llms.txt](https://ajuda.ensinio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.ensinio.com/integracoes/integrando-com-a-hotmart.md).

# 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?

* [x] Você precisa ter uma conta na Hotmart
* [x] Você precisa ter um produto aprovado na Hotmart
* [x] Plano ativo na Ensinio com **a opção de Checkouts Externos** habilitada
* [x] Uma conta administrativa na área de membros com permissão para criar **integrações/entregas**

{% hint style="success" %}
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](https://ajuda.ensinio.com/checkout-externo-integrando-com-outra-plataforma-de-vendas)
{% endhint %}

### 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:<br>

1. [Código de identificação do seu produto](#onde-encontrar-o-codigo-do-produto-na-hotmart)
2. [Token de autenticação](#obtendo-o-token-de-autenticacao)

Siga esses passos:

1. No "**Admin Console"**, vá até **App Store** na barra lateral de navegação.&#x20;
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**](#onde-encontrar-o-codigo-do-produto-na-hotmart). Esse é o código de identificação do seu produto na Hotmart.
7. Adicione o [**Token de autenticação**](#obtendo-o-token-de-autenticacao), obtido na Hotmart.
8. Crie um webhook na Hotmart e adicione nele a [URL de postback](#criando-o-webhook-adicionando-url-de-postback-na-hotmart) 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.&#x20;

1. Acesse sua conta na Hotmart.
2. No menu lateral esquerdo, clique no ícone de caixa e selecione **Meus Produtos**.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FSAx2aLG1aunTO8j2sVY7%2Fimage.png?alt=media&amp;token=33a673e5-4f90-4645-ac4a-4cb50bbdc445" alt=""><figcaption></figcaption></figure>

3. 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.
4. Se você clicar para editar o produto, esse mesmo número também aparecerá no final da URL do seu navegador (ex: `.../product/XXXXXXX`)

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FW6lNtvEPBmLLbFKUGUCy%2Fimage.png?alt=media&amp;token=adea4e64-eecc-42cf-8a4e-263fbf29d80d" alt=""><figcaption></figcaption></figure>

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. &#x20;

1. Vá em **Ferramentas,** seguido de **Ver todas**.&#x20;

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FnLCND1C56yUMEpyso3x5%2Fimage.png?alt=media&amp;token=9d91b04c-71aa-451b-a5be-b80ee1fa4273" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FjPnLWJht5nqzbFrvX9L7%2Fimage.png?alt=media&amp;token=998ccc37-54cd-48bb-8268-dcb182b3beea" alt=""><figcaption></figcaption></figure>

3. Dentro da área de Webhook, clique na aba **Autenticação**.
4. Copie o código alfanumérico exibido em "**Hottok de verificação**".

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FYe5qEd6saGRcOjwik6re%2Fimage.png?alt=media&amp;token=5e483c88-78aa-40e2-ae62-e3eed2818046" alt=""><figcaption></figcaption></figure>

5. Cole o token no campo  "**Token de autenticação**" solicitado na página de configuração da integração na Ensinio.&#x20;

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FygrVjqEjenfdvYZmOxIM%2Fimage.png?alt=media&amp;token=edae6b16-9402-468e-ac65-a32bc9f9c3dd" alt=""><figcaption></figcaption></figure>

### Criando o webhook /Adicionando URL de postback na Hotmart

{% hint style="success" %}
É 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**").
{% endhint %}

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

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2F2x1a18QHZwRAHfEKhH6P%2Fimage.png?alt=media&amp;token=6f651c02-bac2-46ff-8834-32bfc43d2a8e" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2Fx6ePgqDyqZ6f1XIvN0UQ%2Fimage.png?alt=media&amp;token=2e45b4bd-a504-4d52-a283-9fdad9cb23fd" alt=""><figcaption></figcaption></figure>

* **Nome da configuração**

  &#x20;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**&#x20;

  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`.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FmPLO8a3D64xzdKsjXCEI%2Fimage.png?alt=media&amp;token=974a6673-cad1-4d79-9528-483c4206cc10" alt=""><figcaption></figcaption></figure>

* **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 <a href="#configurando-a-expiracao-da-inscricao" id="configurando-a-expiracao-da-inscricao"></a>

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.

{% hint style="success" %}
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.
{% endhint %}

### Selecionando o grupo que o usuário receberá acesso <a href="#selecionando-o-grupo-que-o-usuario-recebera-acesso" id="selecionando-o-grupo-que-o-usuario-recebera-acesso"></a>

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.

{% hint style="success" %}
Você pode criar mais de uma entrega para o mesmo grupo caso o mesmo produto seja vendido em plataformas diferentes.
{% endhint %}

### A integração funcionou? <a href="#a-integracao-funcionou" id="a-integracao-funcionou"></a>

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.&#x20;

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.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FDz8Ti74bREFNMP6bK8XK%2Fimage.png?alt=media&amp;token=b1fdccf3-4d42-4705-a2eb-df64af289701" alt=""><figcaption></figcaption></figure>

### Checklist rápido: Integração com Hotmart

**Antes de começar:**

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

**Na Hotmart**

* [x] Copiei o **Código de identificação (ID)** de 7 dígitos em Meus Produtos
* [x] Copiei o **Token de Verificação (Hottok)** na aba Ferramentas > Webhook (API e Notificações) > Autenticação
* [x] Criei o webhook em Ferramentas > Webhook (API e Notificações) > Configurações > **+ Cadastrar Webhook**
* [x] Colei a **URL de Webhook** gerada pela Ensinio no campo "URL para envio de dados"
* [x] Selecionei o produto correspondente que será vendido
* [x] Selecionei a versão **2.0.0 (Recomendado)**
* [x] Selecionei **todos os eventos** disponíveis na lista para envio de notificações
* [x] Marquei a caixa de confirmação sobre a conformidade no tratamento de dados

**Na Ensinio**

* [x] Preenchi o **Nome da entrega**
* [x] Colei o ID do produto no campo **Código do produto na plataforma**
* [x] Colei o Token de Verificação (Hottok) no campo **Token de autenticação**
* [x] Configurei a expiração da inscrição, se o produto for de pagamento único
* [x] Selecionei o **Grupo** que receberá acesso ao conteúdo
* [x] Cliquei em **Salvar** no canto superior direito

**Por fim**

* [x] Fiz uma compra teste para confirmar que o acesso é liberado corretamente