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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.ensinio.com/digital-manager-guru-configurando-o-webhook-para-integracao-com-a-ensinio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.