For the complete documentation index, see llms.txt. This page is also available as Markdown.

Checkout Externo: Integrando com Outra Plataforma de Vendas

A Ensinio permite que você utilize o checkout de outra plataforma para processar suas vendas e, ao mesmo tempo, entregue o acesso ao conteúdo automaticamente na sua plataforma. Assim, você mantém a experiência de aprendizado na Ensinio sem abrir mão da receita de vendas em plataformas como Hotmart, Kiwify, Monetizze, entre outras.

Antes de configurar a integração na Ensinio

Antes de configurar a integração aqui na Ensinio, é necessário configurar um webhook na plataforma externa para que ela envie notificações referentes aos eventos de quando um pedido for:

  1. Aprovado - cria a inscrição e libera o acesso ao curso.

  2. Reembolsado/Cancelado - bloqueia o acesso do aluno ao curso.

  3. Sofrer um chargeback - bloqueia o acesso do aluno ao curso.

Caso a venda seja por recorrência, selecione também os eventos de:

  1. Assinatura renovada - mantém o acesso ativo para cursos recorrentes.

  2. Assinatura cancelada - cancela uma recorrência.

No caso de uma venda, o webhook é necessário para que a Ensinio não precise ficar perguntando a cada segundo à plataforma de checkout se "tem venda nova? ". O checkout externo (quando configurado corretamente) envia uma notificação automática (o webhook) para a Ensinio assim que o pagamento é aprovado.

Exemplo de um fluxo de integração:

  1. Evento: Um aluno compra seu curso no checkout externo.

  2. Gatilho (Webhook): A plataforma de checkout detecta a compra aprovada e envia os dados (dados do usuário como nome, e-mail e o curso comprado) para uma URL específica da Ensinio.

  3. Ação da Ensinio: A Ensinio recebe essa informação e cria o usuário, libera o acesso ao curso e, muitas vezes, envia os dados de login para o aluno automaticamente.

Acessando os Checkouts Externos

  1. No "Admin Console", clique no ícone "App Store" no menu lateral esquerdo.

  2. Clique em "Checkouts externos".

  3. Clique em "+ Criar uma integração externa".

  1. Uma janela será exibida com informações sobre a funcionalidade. Leia o aviso e clique em "Entendi, quero continuar" para prosseguir.

Configurando a entrega

Após clicar em "Entendi, quero continuar", você será direcionado para a tela "Criando uma entrega".

  1. No campo "Nome da entrega", digite um nome para identificar essa integração.

    Exemplo: Hotmart - Curso de Marketing.

  2. No campo "Código do produto na plataforma", insira o código do produto correspondente na plataforma externa. Esse código é fornecido pela plataforma que você escolher.

Selecionando a plataforma

Na seção "Selecione a plataforma", clique na plataforma que você utiliza para processar suas vendas.

As plataformas disponíveis atualmente são: Hotmart, Kiwify, Ticto, Monetizze, Lastlink, Greenn, Digital Manager Guru, Asaas, PagBank, Payt, Appmax, Zouti, Eduzz, Hubla, TMB e Lia.

Como configurar a integração na Ensinio

Ao clicar em Criar integração e selecionar a plataforma de vendas serão exibidos campos de preenchimento obrigatório e um link da URL de Webhook/Postback.

Abaixo segue uma tabela explicativa resumida com todos esses campos, inclusive "Nome de entrega" e "Código do produto na plataforma", já mencionados nesta seção.

Campo
Onde encontrar/gerar
Onde colar
Para que serve

Nome da entrega

Você define esse nome. Serve apenas para reconhecimento interno.

Direto no campo "Nome da entrega", na integração da Ensinio

Identificar essa integração dentro do painel da Ensinio

Código do produto na plataforma

É o código do produto correspondente obtido na plataforma externa.

No campo "Código do produto na plataforma", na integração da Ensinio

Conectar a cobrança da plataforma de vendas ao produto correspondente na Ensinio

URL de Webhook/Postback

Gerada automaticamente pela Ensinio ao criar a integração

No campo "URL" do webhook configurado na plataforma de vendas

Permite que a plataforma de vendas envie as notificações de pagamento para a Ensinio

Token de autenticação*

Gerado no webhook configurado na plataforma de vendas

No campo "Token de autenticação", na integração da Ensinio

Autenticar as notificações recebidas, confirmando que vêm da plataforma de vendas

Chave da API*

Gerada no painel da plataforma de vendas

No campo "Chave da API", na integração da Ensinio

Permitir que a Ensinio se comunique com a conta na plataforma de vendas

URL de postback

Ao selecionar uma plataforma será exibida a URL de postback.

A URL exibida é o endereço de webhook da sua plataforma Ensinio. Copie esse link e cadastre-o na plataforma externa escolhida — geralmente em Configurações > Webhooks ou similar. É por meio dessa URL que a plataforma externa saberá onde notificar a Ensinio quando uma venda for aprovada, reembolsada ou cancelada.

Token de autenticação

Ao clicar em ALGUMAS plataformas será exibido também um campo para acrescentar um token de autenticação.

O token solicitado aqui é gerado pela plataforma externa. Acesse as configurações da plataforma que você escolheu — geralmente em Configurações > API ou Tokens — copie o token disponibilizado lá e cole neste campo. Ele garante que apenas a plataforma autorizada consiga enviar notificações para a sua plataforma.

Chave da API

Ao clicar em ALGUMAS plataformas será exibido também um campo para acrescentar uma Chave de API.

Essa chave é obtida na plataforma de vendas e colada no campo especificado na página de integração aqui na Ensinio.

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.

Selecionando o grupo que o usuário receberá acesso

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

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

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

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: Checkout Externo (Geral)

Antes de começar

Na Ensinio

Na Plataforma de Vendas Externa

Finalizando na Ensinio

Por fim

Last updated