Como conectar o EVO (W12) ao Radar: o que você precisa e o que sincroniza

Se a sua academia usa o EVO (W12 / ABC Fitness), o Radar pode ler a operação direto do ERP — alunos ativos, contratos, cancelamentos, inadimplência e frequência — sem planilha e sem digitação. Este guia mostra o que você precisa providenciar (leva ~2 minutos no seu painel), exatamente quais dados sincronizamos e como os dados dos seus alunos são protegidos.

O que você vai precisar

1. Plano EVO Black.A API do EVO (chamada “API Plus”) vem inclusa sem custo adicional no plano Black. Se a sua academia não é Black, a opção de gerar a chave não aparece no painel — nesse caso, a conexão pode ser feita por CSV (veja o guia de importação por planilha).
2. O DNS da academia — o subdomínio dela no EVO, aquele que aparece na URL quando você acessa o painel (ex. minhaacademia.w12app.com.br).
3. Uma Secret Key. No painel do EVO: Configurações → Configurar integração direta → Gerar token de acesso. A chave vale por 2 anos e pode ser desativada por você a qualquer momento na aba Tokens — que também mostra o consumo de cada integração.

Se a academia tem mais de uma filial, informe também qual unidade vamos monitorar — a API do EVO separa os dados por filial e o Radar sempre consulta apenas a unidade combinada.

Com esses dados em mãos, a conexão é feita junto com a nossa equipe no onboarding — você fornece o DNS e a Secret Key por canal seguro e o restante acontece do nosso lado, sem instalação de nada na academia.

Como a conexão funciona

• Somente leitura, por construção. Nosso conector é incapaz de escrever no seu EVO: ele só executa operações de consulta. Nada de criar, alterar ou cancelar contratos, alunos ou acessos.
• Chave guardada cifrada. A Secret Key é armazenada com criptografia forte (AES-256-GCM) e nunca aparece em tela, log ou relatório.
• Sincronização programada, não contínua. O Radar consulta o EVO em janelas semanais — as telas e relatórios usam o dado já sincronizado, sem tocar na API a cada acesso.
• Sua cota é respeitada. O plano Black inclui 1.000 requisições por mês (100/dia), e essa cota é da SUA conta. Nossa sincronização semanal usa uma fração disso (tipicamente 40–100 requisições por semana, com a carga inicial diluída ao longo de dias) e tem freio automático antes de qualquer limite — sua cota nunca é esgotada por nós. Cada requisição fica registrada em auditoria interna.
• Revogar = desconectar. Desativou o token na aba Tokens do EVO, o acesso morre na hora. Sem etapa nossa, sem pedido de suporte.

Quais dados sincronizamos

• Alunos ativos e evolução mensal — o total vigente e a tendência mês a mês, que alimentam ocupação e alertas de queda.
• Novos contratos e cancelamentos — entradas e saídas do período, base do indicador de churn.
• Inadimplência — recebíveis em atraso (30 dias) como percentual agregado da unidade.
• Planos e valores — o portfólio de planos da unidade, pra leitura de ticket e posicionamento de preço.
• Check-ins — a frequência de uso que vira mapa de horários, ocupação e sinais de risco de evasão.
• Mix direto × Wellhub × TotalPass — a API do EVO tem um relatório dedicado de check-ins de agregador; é dele que saem a composição da sua base e a economia por agregador (repasse × frequência real de uso).

O mapa de origem geográfica dos alunos (contagem por setor censitário do IBGE) depende da qualidade do cadastro de endereço/CEP na sua base EVO — validamos isso juntos no onboarding. Já indicadores que o EVO não expõe pela API — como NPS — simplesmente não aparecem no painel: nada é estimado no lugar de dado real.

Pra sua equipe técnica: os endpoints que consultamos (e por quê)

Se a TI ou o analista da academia quiser auditar a integração antes de liberar a chave, este é o contrato completo. Host oficial da API: evo-integracao-api.w12app.com.br · autenticação HTTP Basic (DNS + Secret Key) · referência pública no Swagger oficial da EVO. Todas as chamadas são GET (consulta):

Conforme a necessidade — e sempre em leitura: GET /api/v2/sales (conferência de vendas), GET /api/v2/management/activeclients e …/not-renewed (conferência cruzada), GET /api/v1/prospects (funil de captação, se contratado) e GET /api/v2/webhook (só listar; assinatura de eventos apenas se a cota pedir).

O que nunca chamamos: qualquer operação de escrita — criar venda, liberar catraca (accessControl), alterar aluno, disparar cobrança. A Secret Key do EVO não é escopada por permissão, então a restrição é estrutural no nosso conector: ele só sabe executar as consultas acima, e cada requisição fica registrada em auditoria interna.

LGPD: como os dados dos seus alunos são tratados

• Papéis claros. A academia é a controladora dos dados dos seus alunos; a EyeOnFit atua como operadora, tratando apenas o necessário pra finalidade contratada: análise de gestão da SUA unidade.
• Cadastros nunca são armazenados. Nome, CPF e dados de contrato são processados em memória durante a sincronização e descartados — o que fica gravado são os agregados por unidade (totais, percentuais, medianas).
• Check-ins pseudonimizados. Pra montar o histórico de frequência, cada check-in é guardado com um código irreversível no lugar da identidade do aluno — sem nome, sem CPF — e descartado após cerca de 13 meses (o suficiente pra comparação ano contra ano).
• Sem venda ou compartilhamento. O dado da sua operação alimenta o seu painel. Comparações de mercado usam sempre estatísticas agregadas, nunca dados individuais de alunos.
• Os detalhes completos estão na nossa Política de Privacidade.

O que o Radar entrega com o EVO conectado

Com a operação sincronizada, o Radar cruza os seus números com o território e a concorrência: ocupação e tendência com contexto de mercado, alertas quando a base cai ou um concorrente se mexe, leitura de ticket contra a renda do entorno e a Prontidão que destrava campanhas de captação com dado real. Pra conhecer o produto completo, veja a página do Radar.

Pra conectar, fale com a gente em contato@eyeonfit.com — o onboarding com EVO é acompanhado pela equipe do início ao fim.