Digital Manager Guru: Configurando o Webhook para Integração com a Ensinio

Este artigo orienta como configurar o webhook na Digital Manager Guru para que ela envie notificações à sua plataforma Ensinio sempre que ocorrer uma transação relevante — garantindo que o acesso dos alunos seja liberado ou bloqueado automaticamente.

Antes de prosseguir com este artigo, certifique-se de que já criou a integração na Ensinio.

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

Checkout Externo: Integrando com Outra Plataforma de Vendas.

Obtendo o Token de Autenticação

O token de autenticação solicitado na integração da Ensinio corresponde ao Token API da sua conta na Digital Manager Guru. Ele é um código único e confidencial que autoriza a comunicação segura entre as duas plataformas.

Atenção: não compartilhe o seu Token API com ninguém.

Para encontrá-lo:

1. Acesse o admin da Guru com seu usuário e senha.

2. No menu superior direito, clique em "Minha Conta".

3. Em "Detalhes", localize o campo "Token API" e copie o valor exibido.

1. Cole esse token no campo "Token de autenticação" exibido na integração criada na sua plataforma Ensinio.

Obtendo o ID do produto na Guru

Para que a integração funcione, você precisará do código de identificação do produto cadastrado na Guru para inserir na integração da Ensinio.

1. No admin da Guru, acesse "Produtos" no menu lateral.

2. Clique no produto desejado para abrir os detalhes.

3. Na seção "Detalhe", localize o campo "Código" - ele é gerado automaticamente pela Guru no momento da criação do produto. Se desejar, você pode personalizar o código do produto na Guru antes de utilizá-lo na integração. Após definido, mantenha o mesmo código em ambas as plataformas.

1. Copie esse código - ele será o "Código do produto na plataforma" na integração criada na Ensinio.

Eventos e o que cada um faz na Ensinio

Na Guru, você precisará criar apenas um webhook do tipo Vendas. Todos os eventos relevantes para a integração com a Ensinio são tratados por esse tipo, independentemente de ser pagamento único ou recorrência.

Webhook de Vendas

Status	Situação	O que acontece na Ensinio
Aprovada	Compra aprovada	Cria o acesso do aluno ao grupo
Trial	Período de teste iniciado	Cria o acesso do aluno ao grupo
Reembolsada	Reembolso aprovado	Bloqueia o acesso do aluno
Cancelada	Cancelamento da compra	Bloqueia o acesso do aluno
Reclamada	Chargeback	Bloqueia o acesso do aluno

Esses eventos deverão ser adicionados em "Status" no webhook.

Acessando os webhooks na Guru

1. Acesse o admin da Guru em digitalmanager.guru.

2. No menu lateral, clique em "Configurações" e depois em "Webhooks".

Criando o webhook de Vendas

1. Na tela de Webhooks, clique em "Vendas".

2. Clique nos 3 pontinhos e em "Adicionar" para adicionar o Webhook.

1. Preencha os campos:

   1. Nome - defina um nome para identificar a integração. Exemplo: Ensinio — [Nome do Produto].

   2. URL - 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/dmguru.

1. Configure os envios simultâneos, sempre 5.

2. Em "Status", selecione: "Aprovada", "Trial", "Reembolsada", "Cancelada" e "Reclamada".

3. Em "Filtrar por", selecione "Produtos" e escolha o produto desejado.

4. Selecione o(s) produto(s) que deseja relacionar a esse Webhook.

5. Ative o toggle "Ativo" e clique em "Enviar" para salvar.

Se quiser que todos os seus produtos sejam associados automaticamente, selecione Todos. Assim, novos produtos criados na Guru já serão incluídos nesse webhook.

1. O Webhook configurado aparecerá após clicar em "Enviar".

Verificando se a integração está funcionando

Após configurar os webhooks, você pode verificar se os eventos estão sendo enviados corretamente:

1. No admin da Guru, acesse Configurações > Webhooks.

1. Clique em "Vendas" e no webhook criado para ver o histórico de envios.

1. Verifique o histórico com as atividades do Webhook em "Atividades".

1. Verifique se os eventos aparecem com status de sucesso.

2. Caso apareçam com erro, revise a URL de postback cadastrada e certifique-se de que a integração na Ensinio está ativa.