# 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="/files/VIPhDSPDKa5jErgmY8Tk" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/3FKROA35LkThOwGEDJns" 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="/files/bTqya6w6D9JLPQmoovM5" 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="/files/5IuRQnroTFBHjw6wDtqM" 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="/files/j5LebDxCbjyRh0aocylt" 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="/files/hkyczjpQzkZ9vDie3dIN" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/S0vxYNeNDbBPqPAtEamG" 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="/files/STevhyJZPVkdheMtVMzv" 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="/files/2UhWlxnPU8NR6D9mn5s8" alt=""><figcaption></figcaption></figure>


---

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