Para garantir o máximo de autonomia, rastreabilidade e performance nas suas integrações, recomendamos fortemente que toda configuração de webhooks seja realizada diretamente pela Developer Hub, nosso ambiente oficial de gerenciamento de integrações.
Se você utiliza o Webhook do MyEduzz, sugerimos a migração para a Developer Hub assim que possível. Essa atualização oferece recursos avançados, mais controle sobre os eventos monitorados e melhorias estruturais.
Durante a transição, ambos os webhooks podem ser mantidos ativos para testes, mas orientamos desativar a configuração antiga após confirmar o correto funcionamento do novo endpoint.
O sistema antigo de Webhooks e API Pública do MyEduzz será descontinuado em 30 de abril de 2026.
Até essa data, todas as integrações devem ser migradas para a **Developer Hub:** o novo ambiente de integrações da Eduzz, que oferece melhor performance, segurança, rastreabilidade e autonomia para desenvolvedores e parceiros.
Como migrar webhooks e APIs
Migrar é simples e pode ser feito rapidamente. Siga o passo a passo:
- Acesse o Developer Hub da Eduzz:
- Clique em “Nova Configuração”;
- Informe o endpoint da sua aplicação (URL onde deseja receber os eventos);
- Escolha os eventos que deseja acompanhar;
- Clique em salvar.
Após esses passos, seu novo webhook já estará pronto para enviar notificações no novo formato.
Recomendamos testar seu endpoint em ambiente de homologação antes de ativar em produção, garantindo que as notificações estejam sendo recebidas e processadas corretamente.
Eventos Developer Hub
A nova plataforma amplia o monitoramento e oferece mais categorias de eventos, cobrindo faturas, assinaturas, comissões e o comportamento dos alunos no Nutror.
Além disso, eventos e categorias foram adicionados, ampliando o monitoramento de ações em áreas como faturas, assinaturas, comissões e comportamento de alunos no Nutror.
| Categoria | Evento | Descrição |
| MyEduzz: Fatura | Chargeback | Notifica quando o status de uma fatura muda. |
| MyEduzz: Comissão | Comissão processada | Informa quando as comissões são calculadas. |
| Assinaturas | Tentativas de cobrança (pix, boleto e cartão) | Acompanha o status de cobranças automáticas. |
| Nutror: Aulas e Alunos | Aula iniciada, avaliação criada, certificado visualizado | Monitora ações dos alunos da plataforma. |
Com esses eventos, é possível criar automações precisas e acompanhar todo o ciclo da venda e utilização da plataforma.
Também é possível identificar em qual etapa do checkout o cliente interrompeu a compra por meio do campo lastStep, possibilitando estratégias de recuperação de vendas mais eficientes.
Valor do campo lastStep |
Etapa |
|---|---|
mounted |
Carrinho aberto |
user_data |
Dados pessoais preenchidos |
cart_items |
Produtos carregados |
payment_sent |
Dados de pagamento enviados |
payment_failed |
Pagamento falhou |
Perguntas frequentes
- O que muda migrando o webhook do MyEduzz para o Developer Hub?
Você ganha acesso a mais eventos, relatórios detalhados, maior controle sobre falhas e melhorias em autonomia, performance e transparência. - Preciso desativar meu webhook antigo antes de configurar o novo?
Não, durante a transição, ambos podem funcionar simultaneamente. Após testar e validar o novo endpoint, recomenda-se remover o antigo. - É possível utilizar ambos (MyEduzz e Developer Hub) ao mesmo tempo para testes?
Sim, isso facilita a validação do novo fluxo e evita interrupções durante a migração. - Como posso testar meu endpoint antes de colocá-lo em produção? Existe um ambiente de homologação (sandbox)?
Sim, recomendamos testar endpoints em ambiente de homologação antes de colocar em produção. Consulte a documentação técnica para exemplos e boas práticas. - Quais eventos novos estão disponíveis e o que posso automatizar de diferente a partir deles?
Novos eventos contemplam faturas, assinaturas, comissões e diversos comportamentos de usuários na plataforma. Você pode automatizar ações e monitorar processos críticos da jornada do cliente. - Como identifico falhas de processamento nos eventos enviados?
Pelo painel do Developer Hub, você visualiza rapidamente o que foi ou não processado. Utilize logs e relatórios para identificar falhas e ajustar integrações quando necessário. - O que significa cada estágio do campo “lastStep” e como usar isso em estratégias de recuperação de vendas?
Cada valor corresponde a uma etapa do checkout, permitindo identificar onde o cliente abandonou a compra e criar automações para recuperação personalizada. - Onde recebo as notificações? São imediatas? Há algum tipo de fila ou atraso?
As notificações são enviadas automaticamente para os endpoints configurados. Eventuais atrasos dependem do tráfego e disponibilidade do canal, mas a plataforma possui mecanismos para nova tentativa em caso de falha. - Quem pode acessar/configurar integrações na Developer Hub? (Permissões)
Apenas usuários com permissões técnicas adequadas têm acesso à configuração e gestão de webhooks no Developer Hub. - Existe um limite de webhooks/endpoints configuráveis por conta?
Apenas usuários com permissões técnicas adequadas têm acesso à configuração e gestão de webhooks no Developer Hub.