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.

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.

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

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

Eventos e o que cada um faz na Ensinio

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

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

Para vendas de pagamento único, selecione os quatro eventos de fatura.

Para vendas recorrentes (assinaturas), selecione também os eventos de contrato.

Acessando o webhook no Órbita

1. Acesse sua conta no Órbita em 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.

1. Uma janela será exibida informando que o cadastro de novos webhooks foi migrado para o Developer Hub.

2. Clique em "Acessar Developer Hub".

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

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

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

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

1. Na seção "Quais eventos você deseja receber?", expanda o grupo MyEduzz e selecione os eventos conforme a tabela da seção 2.

1. Clique em "Criar configuração" para salvar.

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.

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.