> 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/duvidas-frequentes-1/digital-manager-guru-configurando-o-webhook-para-integracao-com-a-ensinio.md).

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

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

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

{% hint style="warning" %}
**Atenção:** não compartilhe o seu Token API com ninguém.
{% endhint %}

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.

<figure><img src="/files/v4QIhmUMHFBe4yAy9lKo" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/nfdCV9u66BpXBwKuToQv" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/sy82DsmoKKwOEzfss7et" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/QD2qK7jlJLg1aKCfUjrw" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="212.5555419921875">Status</th><th width="238.5555419921875">Situação</th><th>O que acontece na Ensinio</th></tr></thead><tbody><tr><td><strong>Aprovada</strong></td><td>Compra aprovada</td><td>Cria o acesso do aluno ao grupo</td></tr><tr><td><strong>Trial</strong></td><td>Período de teste iniciado</td><td>Cria o acesso do aluno ao grupo</td></tr><tr><td><strong>Reembolsada</strong></td><td>Reembolso aprovado</td><td>Bloqueia o acesso do aluno</td></tr><tr><td><strong>Cancelada</strong></td><td>Cancelamento da compra</td><td>Bloqueia o acesso do aluno</td></tr><tr><td><strong>Reclamada</strong></td><td>Chargeback</td><td>Bloqueia o acesso do aluno</td></tr></tbody></table>

Esses eventos deverão ser adicionados em "[**Status**](#criando-o-webhook-de-vendas)" no webhook.

### Acessando os webhooks na Guru

1. Acesse o admin da Guru em [digitalmanager.guru](https://digitalmanager.guru/admin/auth/login?utm_term=pt-br-home).
2. No menu lateral, clique em **"Configurações"** e depois em **"Webhooks"**.

<figure><img src="/files/uQd6Dp3tKCAxK0852TMO" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/KZkl0jIUE6FcIO1B85Xe" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/ATFFpK3KqqVPTv16M2L0" alt=""><figcaption></figcaption></figure>

4. Configure os envios simultâneos, sempre 5.
5. Em "**Status"**, selecione:   "**Aprovada", "Trial", "Reembolsada", "Cancelada"** e "**Reclamada"**.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      &#x20;
6. Em "**Filtrar por"**, selecione "**Produtos"** e escolha o produto desejado.
7. Selecione o(s) produto(s) que deseja relacionar a esse Webhook.
8. Ative o toggle **"Ativo"** e clique em **"Enviar"** para salvar.

<figure><img src="/files/W7KutXdl1SLrSURMHtgx" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/cFChpjYRb9IlTNlIC1sn" alt=""><figcaption></figcaption></figure>

### 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**.

<figure><img src="/files/TXlIRqtSRMuK1200wEuu" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/QEuyxNe9WP7ynEus9iZT" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/ivZEhG7h80kBgGfLCR9B" alt=""><figcaption></figcaption></figure>

4. Verifique se os eventos aparecem com status de **sucesso**.
5. Caso apareçam com **erro**, revise a URL de postback cadastrada e certifique-se de que a integração na Ensinio está ativa.