ABC Evo (EVO / W12 - Academias)
O ABC Evo é o NicoApp de integração com o sistema EVO (W12), usado por academias. Com ele, seu bot consulta e cadastra alunos e oportunidades, agenda aulas experimentais, registra
Nota
Disponível na aba de NicoApps. Base da integração: API oficial EVO (evo-integracao.w12app.com.br).
Requisitos e limites (planos EVO API)
Atenção
A API da EVO está disponível apenas para clientes do plano EVO Black. Sem EVO Black, não há como usar este NicoApp. Dentro do EVO Black existem dois planos de API, com limites bem diferentes:
Plano
Custo
Limites
Observações
API Plus
Incluído na mensalidade do EVO Black
1.000 requisições/mês e até 100 requisições/dia. Ao atingir o limite, novas solicitações são bloqueadas até a renovação do período.
Serve para testes e volumes muito baixos.
API Pro
R$ 39,90/mês + R$ 2,72 a cada 100 requisições diurnas (6h–23h59) ou R$ 1,36 noturnas (0h–5h59)
Consultas diárias ilimitadas (cobrança pelo uso real); limite maior de requisições por minuto.
Inclui Webhook, workshops exclusivos e acesso prioritário a novos recursos. Cobrança vence dia 15.
Nota
Atenção ao dimensionar: um bot de atendimento consome várias requisições por conversa (buscar oportunidade, listar atividades, consultar horários, agendar...). Com o limite de 100/dia do API Plus, poucas conversas por dia já esgotam a cota — para automação de verdade, o indicado é o API Pro.
Autenticação
A EVO usa Basic Auth com duas credenciais, que você informa na instalação do app:
- DNS da Academia — o identificador da sua academia na EVO (usuário da API).
- Chave Secreta (Token) — a senha gerada junto com o token.
Para gerar as credenciais no painel EVO:
- Acesse Configuração → Integrações → card EVO API.
- Clique em NOVO TOKEN e confirme seu login e senha do EVO.
- Preencha as três seções: Geral (nome do token, solicitante e WhatsApp), Utilização (propósito da integração) e Permissões — marque os acessos aos endpoints que o app usa: membros, prospects (oportunidades), atividades/agenda, vendas, serviços e configurações.
- Aceite os termos de uso. O painel exibirá o DNS (usuário) e o Token (senha) — copie e cole nos campos do NicoApp.
- Validade: tokens criados valem por 2 anos (a EVO notifica 30 dias antes de expirar). Tokens gerados pelo suporte expiram em 3 dias.
- Chave de unidade única vs. multiunidade: a chave de unidade única acessa os dados de uma unidade; a multiunidade acessa várias (informando a filial). Se sua academia tem várias unidades, gere a chave multiunidade e use o campo ID da Filial nas ações do app.
- Gerenciamento: na aba Tokens do painel EVO dá para ativar/inativar, editar permissões e excluir chaves; na aba Consumo, acompanhar as requisições por mês e por token.
Atenção
A credencial é validada na primeira ação executada. Se uma ação falhar com erro de autorização, confira o DNS e o Token na configuração do app — e se as Permissões do token cobrem o endpoint usado pela ação.
Ações disponíveis
01 Membros
Ação
O que faz
Entradas principais
Saídas
Buscar por Membros
Busca alunos por nome, e-mail ou telefone
Nome, E-mail, Telefone (ao menos um)
Membros Encontrados (JSON), Total Encontrado
Criar Aluno (Membro)
Cadastra um novo aluno na EVO
Filial, Nome (obrigatórios); Sobrenome, E-mail, Celular, CPF, Nascimento, Gênero
ID do Aluno (idMember)
02 Oportunidades
Ação
O que faz
Entradas principais
Saídas
Buscar por Oportunidade
Busca prospects por nome, e-mail, telefone ou CPF
Nome, E-mail, Telefone, CPF (ao menos um)
Oportunidades Encontradas (JSON), Total Encontrado
Criar Oportunidade
Cria um prospect na EVO
Nome (obrigatório); Sobrenome, E-mail, Celular, Gênero, Etapa do Funil, CPF
ID da Oportunidade (idProspect)
Atualizar Oportunidade
Atualiza os dados de um prospect existente
ID da Oportunidade (obrigatório) + campos a atualizar (inclui Nascimento e Observações)
ID da Oportunidade
03 Venda e Agendamento
Ação
O que faz
Entradas principais
Saídas
Consultar Horários Disponíveis
Lista horários de atividades com vaga em uma data (ocupação < capacidade)
Data (AAAA-MM-DD); IDs das Atividades (opcional)
Horários Disponíveis (JSON), Total Encontrado
Agendar Serviços
Inscreve a oportunidade em um horário de atividade
ID de Configuração, Data da Atividade, ID da Oportunidade
—
Criar Venda
Cria uma venda para a oportunidade (pagamento pendente; sem cartão)
Filial, Serviço, ID da Oportunidade
ID da Venda (idVenda)
Criar Venda e Marcar
Cria a venda e já inscreve no horário escolhido
Filial, Serviço, ID da Oportunidade, ID de Configuração, Data da Atividade
ID da Venda
Agendar Aula Experimental
Agenda uma aula experimental para a oportunidade (endpoint dedicado da EVO)
ID da Oportunidade, Data/Hora, Nome da Atividade, Nome do Serviço; idActivity/idService/Filial (opcionais)
—
Consultar Agendamentos do Contato
Lista as sessões agendadas de uma oportunidade ou aluno (confirmações e lembretes)
ID da Oportunidade ou ID do Aluno; período opcional
Agendamentos Encontrados (JSON), Total Encontrado
Alterar Status do Agendamento
Marca Presente, Falta ou Falta Justificada na sessão
Status, ID de Configuração, Data da Atividade, ID da Oportunidade ou do Aluno
—
04 Catálogo e Configuração
Ação
O que faz
Entradas principais
Saídas
Consultar Serviços
Lista os serviços cadastrados (filtro por nome)
Nome (opcional)
Serviços Encontrados (JSON), Total Encontrado
Consultar Unidades
Lista as unidades/filiais da academia
ID da Filial (opcional, filtra uma unidade)
Unidades Encontradas (JSON), Total Encontrado
Consultar Atividades
Lista as atividades (aulas) da academia
Nome (opcional), Filial (opcional)
Atividades Encontradas (JSON), Total Encontrado
Consultar Horários Disponíveis (IA)
Versão para Agente de IA: devolve os horários únicos com vaga já no formato de função (role/name/content)
Data; IDs das Atividades (opcional)
Resposta para IA
Fluxo recomendado: aula experimental automatizada
- Lead chega no WhatsApp → Buscar por Oportunidade (pelo telefone) → se não existir, Criar Oportunidade.
- Consultar Atividades → o bot apresenta as aulas disponíveis.
- Consultar Horários Disponíveis (no Agente de IA, use a versão IA como função).
- Agendar Aula Experimental com o horário escolhido.
- Lembrete pré-aula (sequência) usando Consultar Agendamentos do Contato.
- Pós-aula: Alterar Status do Agendamento → Presente dispara a oferta; Falta dispara a régua de reagendamento.
- Fechou plano: Criar Venda (ou Criar Venda e Marcar) — a venda converte a oportunidade em aluno na EVO. Para cadastro direto, use Criar Aluno (Membro).
Dicas e observações
- Economize requisições: lembre dos limites do seu plano de API. Evite consultar o catálogo (atividades/serviços/unidades) a cada mensagem — esses dados mudam pouco; guarde os IDs em variáveis do bot ou use os selects dinâmicos do app (escolhidos uma vez, no desenho do fluxo).
- Formatos de data: datas simples em
AAAA-MM-DD(ex.: 2026-08-01); data/hora de atividade emAAAA-MM-DDTHH:MM:SS(ex.: 2026-08-01T10:00:00). - Tratamento de erros: quando a EVO recusa uma operação (ex.: horário lotado, limite de requisições atingido), a ação falha e devolve a mensagem de erro real da EVO — use o caminho de erro do bloco para tratar no fluxo.
- IDs encadeados: o ID da Oportunidade sai de Criar/Buscar Oportunidade e entra em Atualizar, Agendar, Aula Experimental e Vendas. O ID de Configuração + Data da Atividade identificam o horário e saem de Consultar Horários.
- Selects dinâmicos: os campos de Filial, Serviço e Atividade carregam as opções direto da sua conta EVO (após instalar com as credenciais). Campos que variam por contato (nome, CPF, ID da oportunidade…) aceitam variáveis do fluxo.
- Pagamento: Criar Venda registra a venda com pagamento pendente (payment 2); cobrança com cartão não é feita pelo app nesta versão.