# 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="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FA1PcjHNaPQzo4YlMY5a2%2Fimage.png?alt=media&#x26;token=70f9f006-7d75-49a4-8561-59c9e78d7c1f" 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="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FD4U6wdZVjSvRRC6j0LVU%2Fimage.png?alt=media&#x26;token=6dd52d65-2476-453d-9a48-9280c6f7e309" 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="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FEJcmVBLp25II3eNIq6Ku%2Fimage.png?alt=media&#x26;token=62b8ea23-b2be-47da-8041-4d8ccb2dabfc" 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="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FOrKICqJQRuHSBNAZ8Pqg%2Fimage.png?alt=media&#x26;token=5dc6fc6b-5bf8-4eae-9534-c52f4eb652b3" 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="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FYEOsIYq7qLAEZeixZG01%2Fimage.png?alt=media&#x26;token=31143131-86f6-410b-a754-d47f3bb889fe" 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="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FfOCx5MYzzveFbYf5Fsbm%2Fimage.png?alt=media&#x26;token=8e549523-c8f2-4910-8e15-aa6cc5e6a68e" 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="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2F75RrVWVHIPrJxdzF5iPL%2Fimage.png?alt=media&#x26;token=2bf9dc64-6b5f-4e2f-85c0-739d64e06fc7" 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="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2Fx6o0gPsyVTrhnJ4PeG1v%2Fimage.png?alt=media&#x26;token=f85d891e-50de-4ff1-be89-4dc41bbd1775" 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="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FP53xulrbPS4veEnzCNMH%2Fimage.png?alt=media&#x26;token=6fd3ad61-7035-4bd0-98c8-98bf5e0a542e" 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="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FPhwrMKyVMHK9dqzwuvUv%2Fimage.png?alt=media&#x26;token=aa966bfd-d347-4247-ae31-e120756d122a" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FN6wcvf3Yw5v8zlY6HwUV%2Fimage.png?alt=media&#x26;token=f76c77b1-e98c-400a-a9e4-b7928c25de8a" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FKyDJbA0y90h2hk7aNTiO%2Fimage.png?alt=media&#x26;token=0d08a142-cfd2-4230-a4b8-417b99a61e4d" 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.