Integração Eduzz
Conecte sua conta Eduzz ao Synchro Hub para receber vendas em tempo real e consolidar métricas no dashboard.
Conecte sua conta Eduzz ao Synchro Hub para receber vendas em tempo real e consolidar métricas no dashboard.
Visão geral
Ao integrar a Eduzz, o Synchro Hub passa a:
- Receber webhooks de vendas, reembolsos, chargebacks, assinaturas e carrinhos abandonados em tempo real.
- Consultar a API da Eduzz para importar histórico e enriquecer dados.
Tempo estimado: 3 minutos. O que você vai precisar:
- Conta Eduzz com perfil de Produtor (ou Co-produtor com permissão).
- Workspace já criado no Synchro Hub.
Boa notícia: a Eduzz usa OAuth 2.0. Você não precisa gerar credenciais ou copiar tokens — basta autorizar o aplicativo Synchro Hub diretamente dentro da Eduzz, e o webhook é registrado automaticamente via API.
Pré-requisitos
- Estar logado no Synchro Hub com um workspace selecionado.
- Estar logado no painel da Eduzz em eduzz.com (em outra aba facilita).
Passo 1 — Conectar a plataforma no Synchro Hub
- No menu lateral, acesse Integrações.
- Clique em + Adicionar Plataforma.
- Selecione Eduzz e clique em Confirmar.
Ao confirmar, o Synchro Hub abre a tela de autorização da Eduzz em uma nova aba/janela.
Passo 2 — Autorizar o aplicativo na Eduzz
Na tela da Eduzz, você verá as permissões que o Synchro Hub precisa:
- Ler dados da conta e dados pessoais
- Ler dados de afiliados e compradores
- Ler dados financeiros
- Ler dados de produtos, vendas, assinaturas, cursos e estudantes
- Ler e Gerenciar dados de webhook (necessário para registro automático)
Clique em Autorizar Aplicativo.
Importante: se você tiver mais de uma conta na Eduzz, use o link Trocar de Conta antes de autorizar para garantir que está conectando a conta certa.
Após autorizar, a Eduzz redireciona de volta para o Synchro Hub e o card da integração passa a exibir Ativa / Conectado.
Sobre o token: o token OAuth é gerenciado e renovado automaticamente pelo Synchro Hub. Se em algum momento ele expirar ou for revogado na Eduzz, o card mostrará o botão Atualizar token — basta clicar e autorizar novamente.
Passo 3 — Registrar o webhook (Passo 1 de 2)
- No card da Eduzz, clique em Configurar Webhook.
- Na janela Webhook Eduzz, clique em Registrar Webhook.
O Synchro Hub usa a API da Eduzz para criar automaticamente o endpoint de webhook com todos os eventos necessários. Nenhuma configuração manual no painel da Eduzz é necessária.
Passo 4 — Ativar o webhook (Passo 2 de 2)
Após o registro, clique em Ativar Webhook.
A Eduzz vai verificar a acessibilidade da URL enviando uma requisição de confirmação. Ao passar, o webhook é marcado como ativo e o card passa a exibir Webhook ativo.
Importante: se a verificação falhar, clique novamente em Ativar Webhook. A Eduzz pode levar alguns segundos para concluir o handshake.
Verificação
Para confirmar que tudo está funcionando:
- Gere uma venda de teste na Eduzz (use um cupom de 100% em um produto seu ou uma compra real de valor baixo).
- Abra Vendas no menu lateral do Synchro Hub.
- A venda deve aparecer em até 1 minuto após a aprovação na Eduzz.
Solução de problemas
| Sintoma | O que fazer |
|---|---|
| Redirecionamento do OAuth falhou | Verifique se o popup não foi bloqueado pelo navegador e tente novamente em + Adicionar Plataforma → Eduzz. |
| Card mostra “Atualizar token” | O token OAuth expirou ou foi revogado. Clique em Atualizar token e refaça a autorização. |
| ”Falha ao registrar webhook” | Confirme que você autorizou a permissão Gerenciar dados de webhook no Passo 2. Se recusou, remova a integração e refaça a autorização marcando todas as permissões. |
| ”Falha ao ativar webhook” | A Eduzz não conseguiu verificar a URL. Aguarde alguns segundos e clique em Ativar Webhook novamente. |
| Vendas antigas não aparecem | Webhooks só enviam eventos novos. Use a funcionalidade de Importação de Histórico (em breve) para backfill. |
Perguntas frequentes
Preciso criar algum “App” ou credencial no painel da Eduzz? Não. O aplicativo Synchro Hub já está registrado na Eduzz. Você apenas autoriza o acesso à sua conta.
Tenho vários produtos na mesma conta Eduzz. Preciso integrar cada um? Não. A integração é feita pela conta que você autorizou. Todos os produtos daquela conta enviam eventos para o mesmo webhook.
Posso reprocessar vendas antigas? A Eduzz permite reenvio manual de webhooks pela tela de Histórico de Webhooks. Alternativamente, aguarde a funcionalidade de importação de histórico no Synchro Hub (desde que seu plano contemple importação retroativa).
Como desconecto a integração? No card da Eduzz, clique em Remover. O Synchro Hub remove o webhook da Eduzz automaticamente e revoga o acesso OAuth. Os dados serão apagados da Synchro Hub.