Integraciones/NicoApps (MiniApps) Nativos/Sistemas de Negócios Locais/ABC Evo (EVO / W12 - Gimnasios)
ABC Evo (EVO / W12 - Gimnasios)
ABC Evo es el NicoApp de integración con el sistema EVO (W12), usado por gimnasios. Con él, tu flujo consulta y registra alumnos y oportunidades y agenda clases de prueba.
Nota
Disponible en la pestaña de NicoApps. Base de la integración: API oficial de EVO (evo-integracao.w12app.com.br).
Requisitos y límites (planes EVO API)
Atención
La API de EVO está disponible solo para clientes del plan EVO Black. Sin EVO Black, no hay forma de usar este NicoApp. Dentro de EVO Black existen dos planes de API, con límites muy diferentes:
Plan
Costo
Límites
Observaciones
API Plus
Incluido en la mensualidad de EVO Black
1.000 solicitudes/mes y hasta 100 solicitudes/día. Cuando se alcanza el límite, las nuevas solicitudes se bloquean hasta la renovación del período.
Sirve para pruebas y volúmenes muy bajos.
API Pro
R$ 39,90/mes + R$ 2,72 por cada 100 solicitudes diurnas (6h–23h59) o R$ 1,36 por cada 100 solicitudes nocturnas (0h–5h59)
Consultas diarias ilimitadas (cobro por uso real); límite mayor de solicitudes por minuto.
Incluye Webhook, talleres exclusivos y acceso prioritario a nuevas características. El cobro vence el día 15.
Nota
Atención al dimensionar: un flujo de atención consume varias solicitudes por conversación (buscar la oportunidad, listar actividades, consultar horarios, agendar...). Con el límite de 100/día del API Plus, pocas conversaciones al día ya agotan la cuota — para una automatización de verdad, lo indicado es el API Pro.
Autenticación
EVO usa Basic Auth con dos credenciales, que informas en la instalación de la app:
- DNS del Gimnasio — el identificador de tu gimnasio en EVO (usuario de la API).
- Clave Secreta (Token) — la contraseña generada junto con el token.
Para generar las credenciales en el panel de EVO:
- Accede a Configuração → Integrações → card EVO API.
- Haz clic en NOVO TOKEN y confirma tu usuario y contraseña de EVO.
- Completa las tres secciones: Geral (nombre del token, solicitante y WhatsApp), Utilização (propósito de la integración) y Permissões — marca los accesos a los endpoints que usa la app: miembros, prospects (oportunidades), actividades/agenda, ventas, servicios y configuraciones.
- Acepta los términos de uso. El panel mostrará el DNS (usuario) y el Token (contraseña) — cópialos y pégalos en los campos del NicoApp.
- Validez: los tokens creados valen por 2 años (EVO avisa 30 días antes de expirar). Los tokens generados por el soporte expiran en 3 días.
- Clave de unidad única vs. multiunidad: la clave de unidad única accede a los datos de una unidad; la multiunidad accede a varias (informando la sucursal). Si tu gimnasio tiene varias unidades, genera la clave multiunidad y usa el campo ID de la Sucursal en las acciones de la app.
- Gestión: en la pestaña Tokens del panel de EVO puedes activar/inactivar, editar permisos y eliminar claves; en la pestaña Consumo, seguir las solicitudes por mes y por token.
Atención
La credencial se valida en la primera acción ejecutada. Si una acción falla con error de autorización, revisa el DNS y el Token en la configuración de la app — y si las Permissões del token cubren el endpoint usado por la acción.
Acciones disponibles
01 Miembros
Acción
Qué hace
Entradas principales
Salidas
Buscar por Miembros
Busca alumnos por nombre, e-mail o teléfono
Nombre, E-mail, Teléfono (al menos uno)
Miembros Encontrados (JSON), Total Encontrado
Crear Alumno (Miembro)
Registra un nuevo alumno en EVO
Sucursal, Nombre (obligatorios); Apellido, E-mail, Celular, CPF, Nacimiento, Género
ID del Alumno (idMember)
02 Oportunidades
Acción
Qué hace
Entradas principales
Salidas
Buscar por Oportunidad
Busca prospects por nombre, e-mail, teléfono o CPF
Nombre, E-mail, Teléfono, CPF (al menos uno)
Oportunidades Encontradas (JSON), Total Encontrado
Crear Oportunidad
Crea un prospect en EVO
Nombre (obligatorio); Apellido, E-mail, Celular, Género, Etapa del Embudo, CPF
Id de oportunidad (idProspect)
Actualizar Oportunidad
Actualiza los datos de un prospect existente
Id de oportunidad (obligatorio) + campos a actualizar (incluye Nacimiento y Observaciones)
Id de oportunidad
03 Venta y Agendamiento
Acción
Qué hace
Entradas principales
Salidas
Consultar Horarios Disponibles
Lista horarios de actividades con cupo en una fecha (ocupación < capacidad)
Fecha (AAAA-MM-DD); IDs de las Actividades (opcional)
Horarios Disponibles (JSON), Total Encontrado
Agendar Servicios
Inscribe la oportunidad en un horario de actividad
ID de Configuración, Fecha de la Actividad, Id de oportunidad
—
Crear Venta
Crea una venta para la oportunidad (pago pendiente; sin tarjeta)
Sucursal, Servicio, Id de oportunidad
ID de la Venta (idVenda)
Crear Venta y Agendar
Crea la venta y ya inscribe en el horario elegido
Sucursal, Servicio, Id de oportunidad, ID de Configuración, Fecha de la Actividad
ID de la Venta
Agendar Clase de Prueba
Agenda una clase de prueba para la oportunidad (endpoint dedicado de EVO)
Id de oportunidad, Fecha/Hora, Nombre de la Actividad, Nombre del Servicio; idActivity/idService/Sucursal (opcionales)
—
Consultar Agendamientos del Contacto
Lista las sesiones agendadas de una oportunidad o alumno (confirmaciones y recordatorios)
Id de oportunidad o ID del Alumno; período opcional
Agendamientos Encontrados (JSON), Total Encontrado
Cambiar Estado del Agendamiento
Marca Presente, Falta o Falta Justificada en la sesión
Estado, ID de Configuración, Fecha de la Actividad, Id de oportunidad o del Alumno
—
04 Catálogo y Configuración
Acción
Qué hace
Entradas principales
Salidas
Consultar Servicios
Lista los servicios registrados (filtro por nombre)
Nombre (opcional)
Servicios Encontrados (JSON), Total Encontrado
Consultar Unidades
Lista las unidades/sucursales del gimnasio
ID de la Sucursal (opcional, filtra una unidad)
Unidades Encontradas (JSON), Total Encontrado
Consultar Actividades
Lista las actividades (clases) del gimnasio
Nombre (opcional), Sucursal (opcional)
Actividades Encontradas (JSON), Total Encontrado
Consultar Horarios Disponibles (IA)
Versión para Agente de IA: devuelve los horarios únicos con cupo ya en formato de función (role/name/content)
Fecha; IDs de las Actividades (opcional)
Respuesta para IA
Flujo recomendado: clase de prueba automatizada
- El lead llega por WhatsApp → Buscar por Oportunidad (por el teléfono) → si no existe, Crear Oportunidad.
- Consultar Actividades → el flujo presenta las clases disponibles.
- Consultar Horarios Disponibles (en el Agente de IA, usa la versión IA como función).
- Agendar Clase de Prueba con el horario elegido.
- Recordatorio previo a la clase (secuencia) usando Consultar Agendamientos del Contacto.
- Después de la clase: Cambiar Estado del Agendamiento → Presente dispara la oferta; Falta dispara la secuencia de reagendamiento.
- Cerró plan: Crear Venta (o Crear Venta y Agendar) — la venta convierte la oportunidad en alumno en EVO. Para registro directo, usa Crear Alumno (Miembro).
Consejos y observaciones
- Ahorra solicitudes: recuerda los límites de tu plan de API. Evita consultar el catálogo (actividades/servicios/unidades) en cada mensaje — esos datos cambian poco; guarda los IDs en variables del flujo o usa los selects dinámicos de la app (elegidos una vez, en el diseño del flujo).
- Formatos de fecha: fechas simples en
AAAA-MM-DD(ej.: 2026-08-01); fecha/hora de actividad enAAAA-MM-DDTHH:MM:SS(ej.: 2026-08-01T10:00:00). - Tratamiento de errores: cuando EVO rechaza una operación (ej.: horario lleno, límite de solicitudes alcanzado), la acción falla y devuelve el mensaje de error real de EVO — usa el camino de error del bloque para tratarlo en el flujo.
- IDs encadenados: el Id de oportunidad sale de Crear/Buscar Oportunidad y entra en Actualizar, Agendar, Clase de Prueba y Ventas. El ID de Configuración + Fecha de la Actividad identifican el horario y salen de Consultar Horarios.
- Selects dinámicos: los campos de Sucursal, Servicio y Actividad cargan las opciones directamente de tu cuenta EVO (después de instalar con las credenciales). Los campos que varían por contacto (nombre, CPF, id de oportunidad…) aceptan variables del flujo.
- Pago: Crear Venta registra la venta con pago pendiente (payment 2); el cobro con tarjeta no lo hace la app en esta versión.