Integração via API – EVO + Leavo
1. Visão Geral
O EVO, da W12, é um sistema de gestão para academias e estúdios, com cadastro de alunos, contratos, agenda de aulas e financeiro. A integração com a Leavo, feita pela EVO API, permite que os agentes de IA atendam interessados e alunos no WhatsApp com as informações da academia.
Casos de uso principais:
- Atender quem chega pelos anúncios e pelo Instagram
- Agendar aulas experimentais e visitas
- Cadastrar interessados como prospects
- Reativar alunos inativos e ex-alunos com campanhas
Fluxos disponíveis:
- ✅ Leavo → EVO: o agente registra o interessado e o agendamento da aula experimental
- ✅ EVO → Leavo: os dados de alunos e prospects ficam disponíveis para o agente e para o CRM
2. Documentação Oficial
EVO:
Leavo:
3. Credenciais necessárias
| Credencial | Onde encontrar |
|---|---|
Chave da EVO API | EVO → Integrações → EVO API → aba Tokens → Novo token |
⚠️ Importante: na aba Tokens você pode ativar, desativar, editar e excluir as chaves. Crie uma chave só para a Leavo.
4. Como configurar
Passo 1: Gerar a chave no EVO
- Entre no EVO com um usuário administrador
- Abra Integrações e depois EVO API
- Na aba Tokens, clique em Novo token
- Dê um nome, como
Leavo - Atendimento, e copie a chave
Passo 2: Conectar na Leavo
A conexão é feita junto com o time da Leavo na reunião de implementação, incluída no teste grátis:
- Informe a chave da EVO API
- Defina quais unidades e atividades o agente pode usar
- Defina como a aula experimental é agendada
Passo 3: Preparar o agente
- Na Base de conhecimento, adicione planos, modalidades, horários e endereço
- No Treinamento, diga quando oferecer a aula experimental e quando passar para o consultor
- Teste o agente pelo chat de teste antes de ativar no número da academia
5. Observações e Limitações
| Aspecto | Observação |
|---|---|
| Acesso à EVO API | Depende da liberação no seu contrato com a W12 |
| Chave desativada | Se a chave for desativada no EVO, a conexão para de funcionar |
| Valores | O agente só fala de planos e preços que você colocar na base de conhecimento |
6. Troubleshooting
6.1 Erro de autenticação
| Causa | Solução |
|---|---|
| Chave desativada ou excluída | ✅ Reative ou crie uma nova chave na aba Tokens |
| EVO API não liberada | ✅ Fale com o suporte da W12 |
6.2 Aula experimental não aparece
| Causa | Solução |
|---|---|
| Atividade não liberada para o agente | ✅ Revise as atividades configuradas na implementação |
| Sem vagas no horário | ✅ Confira a agenda da atividade no EVO |
7. Casos de Uso Práticos
7.1 Aula experimental pelo WhatsApp
Objetivo: transformar o interessado em aluno
Fluxo:
- Interessado chama a academia no WhatsApp
- O agente apresenta modalidades e planos
- O agente agenda a aula experimental
- O contato vai para o CRM da Leavo e recebe lembrete antes da aula
7.2 Reativação de ex-alunos
Objetivo: trazer de volta quem cancelou
Fluxo:
- Você seleciona os ex-alunos no CRM da Leavo
- Uma campanha convida para voltar a treinar
- Quem responde é atendido pelo agente e direcionado ao consultor

