# Eduzz: Configurando o Webhook para Integração com a Ensinio

Este artigo orienta como configurar o webhook na Eduzz 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 seguir 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 %}

### Criando o produto na Eduzz e obtendo o ID 

Para que a integração funcione, o produto precisa estar cadastrado na Eduzz. Caso ainda não tenha criado, acesse o Órbita em [orbita.eduzz.com](https://orbita.eduzz.com), vá em **Produtos > Novo Produto** e siga o processo de cadastro.

Após o produto estar criado, você precisará do **ID** do produto para inserir na integração da Ensinio. Para encontrá-lo:

1. No menu lateral, clique em **Produtos > Meus Produtos**.
2. Localize o produto desejado. O ID aparece logo abaixo do nome do produto.
3. Copie esse número — 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%2F1kKJPx6JVcpCy4FcS0TE%2Fimage.png?alt=media&#x26;token=a031eb1f-b992-479b-8cf0-b43faa15664f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FRIrE7ItB2RRqdiVbJ0bl%2Fimage.png?alt=media&#x26;token=2a022079-9599-40a1-9c12-361a780c8759" alt=""><figcaption></figcaption></figure>

Onde adicionar o ID do produto na página da integração na Ensinio:

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FObkjX0aRIfkOIG1DVC4V%2Fimage.png?alt=media&#x26;token=26d33b0e-ffea-47ea-97b2-0b3caf616bcf" alt=""><figcaption></figcaption></figure>

### Eventos e o que cada um faz na Ensinio

Ao configurar o webhook, você escolhe quais eventos serão enviados à Ensinio.&#x20;

Selecione os eventos dentro do grupo **MyEduzz** de acordo com o tipo de venda:

**Pagamento único**

| Evento                       | Situação                           | O que acontece na Ensinio       |
| ---------------------------- | ---------------------------------- | ------------------------------- |
| `myeduzz.invoice_paid`       | Compra aprovada                    | Cria o acesso do aluno ao grupo |
| `myeduzz.invoice_refunded`   | Reembolso aprovado                 | Bloqueia o acesso do aluno      |
| `myeduzz.invoice_chargeback` | Contestação na operadora do cartão | Bloqueia o acesso do aluno      |
| `myeduzz.invoice_canceled`   | Cancelamento da compra             | Bloqueia o acesso do aluno      |

**Recorrência (assinatura)**

| Evento                     | Situação                              | O que acontece na Ensinio   |
| -------------------------- | ------------------------------------- | --------------------------- |
| `myeduzz.contract_created` | Contrato de assinatura criado         | Libera o acesso do aluno    |
| `myeduzz.contract_updated` | Atualização do contrato de assinatura | Atualiza o status do acesso |

{% hint style="success" %}
Para vendas de **pagamento único**, selecione os quatro eventos de fatura.&#x20;

Para vendas **recorrentes (assinaturas)**, selecione também os eventos de contrato.
{% endhint %}

### Acessando o webhook no Órbita

1. Acesse sua conta no Órbita em [orbita.eduzz.com](https://orbita.eduzz.com).
2. No menu lateral esquerdo, desça até a seção **"Avançado"** e clique em **"Webhooks"**.
3. Clique em + Novo Webhook.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FNv4828eXR3y1L4bHL0BM%2Fimage.png?alt=media&#x26;token=348936f0-d46d-4e5e-bf59-9b2c52a02697" alt=""><figcaption></figcaption></figure>

4. Uma janela será exibida informando que o cadastro de novos webhooks foi migrado para o Developer Hub.                                                                                                                                             &#x20;
5. Clique em **"Acessar Developer Hub"**.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FexIN9BFR09vJYI7OMIk9%2Fimage.png?alt=media&#x26;token=6042769c-ad5a-4a38-ac86-2dc2128947ce" alt=""><figcaption></figcaption></figure>

### Criando o webhook no Developer Hub

Já no Developer Hub:

1. No menu lateral, em **Webhook**, clique em **"Configurações"**.
2. Clique em **"+ Nova configuração"**.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FjmrjoozkZfWvHjyUyyL9%2Fimage.png?alt=media&#x26;token=64935ac2-487f-461c-899a-5624992701de" alt=""><figcaption></figcaption></figure>

3. Na **Criação de configuração** preencha os campos:

* **Nome da configuração** — defina um nome (com 10 caracteres, no mínimo) para identificar essa integração.                                                                                                                                       Exemplo: *Ensinio - Curso de Marketing*                                                                                                      &#x20;
* **Secret** - mantenha a opção **"Padrão"** selecionada.
* **URL para envio dos dados** - 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/eduzz`.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FYV7im1TTgYODhb75nPP6%2Fimage.png?alt=media&#x26;token=4a33558f-7c78-45d9-a1c4-dc75135eb266" alt=""><figcaption></figcaption></figure>

Onde adicionar a URL postback na configuração do Webhook na Eduzz:

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2F4tXPtBrK7KNfzJHUGmLP%2Fimage.png?alt=media&#x26;token=c81b4173-e268-490c-a67a-36a9eead7558" alt=""><figcaption></figcaption></figure>

4. Na seção **"Quais eventos você deseja receber?"**, expanda o grupo **MyEduzz** e selecione os eventos conforme a[ tabela da seção 2](#eventos-e-o-que-cada-um-faz-na-ensinio).

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2F3I87sRWqOGOSPqKwBavL%2Fimage.png?alt=media&#x26;token=af1d100b-6823-4600-bef9-14b23c7d968b" alt=""><figcaption></figcaption></figure>

5. Clique em **"Criar configuração"** para salvar.

{% hint style="warning" %}
O webhook enviará eventos apenas dos produtos pertencentes à conta que você está utilizando. Verifique se está logado na conta correta antes de criar a configuração.
{% endhint %}

### Verificando se a integração está funcionando

Após configurar o webhook, acompanhe os envios diretamente no Developer Hub:

1. No menu lateral, clique em **"Histórico de envios"**.
2. Verifique se os eventos aparecem com status de **sucesso**.
3. Caso apareçam com **erro**, revise a URL de postback cadastrada e certifique-se de que a integração na Ensinio está ativa.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2F3YHDvSzbx0h8npYYbDZM%2Fimage.png?alt=media&#x26;token=d783358a-ae62-4f42-8daf-df72849c0497" alt=""><figcaption></figcaption></figure>