Pacto Soluções
Pacto Soluções es el NicoApp de integración con el sistema de gestión para gimnasios Pacto (competidor de EVO/W12). Con él, tu flujo consulta y registra clientes y guarda observaciones.
Nota
Disponible en la pestaña de NicoApps. Base de la integración: API oficial de Pacto, mediante el gateway apigw.pactosolucoes.com.br.
Cómo obtener la credencial (token)
A diferencia de EVO (usuario + contraseña vía Basic Auth), Pacto usa un único token, indicado en el campo Credencial API durante la instalación de la app. Según el propio registro de la app, la ruta para generar esa credencial es:
- En el sistema Pacto, accede al módulo ADM.
- Ve a Configurações → Integrações → ADM → API Sistema Pacto.
- Haz clic en Gerar Credencial para crear el token de integración.
- Copia el valor generado y pégalo en el campo Credencial API durante la instalación del NicoApp Pacto Soluções.
Esta credencial es enviada automáticamente por NicoChat en cada acción de la app (todas las acciones tienen la autenticación por token habilitada); no es necesario configurar un encabezado de autenticación en cada acción individualmente.
Atención
Pacto no publica documentación pública que detalle este proceso paso a paso. La ruta anterior refleja la configuración ya registrada en esta app; si el menú ha cambiado, confírmalo con el soporte de Pacto (fale@pactosolucoes.com.br / (62) 3414-0314) o con el gerente de cuenta del gimnasio.
Limitaciones y requisitos de plan
Atención
Pacto no divulga públicamente la exigencia de plan/módulo comercial ni el límite de solicitudes (rate limit) de la API. Confírmalo con el soporte o el gerente de cuenta de Pacto antes de dimensionar un canal de atención en producción.
- Al instalar y probar: empieza con pocas acciones y observa el campo
metadevuelto por la API (mapeado internamente y usado en el manejo de errores): los mensajes de límite o bloqueo de uso suelen aparecer allí, así como los errores HTTP 429 (too many requests) o 401/403 (credencial inválida o sin permiso). - Módulos comerciales: como el sistema Pacto es modular, es posible que la habilitación de la API dependa de un módulo/complemento contratado aparte, así como EVO exige el plan Black. Valida esto con Pacto antes de prometer la integración a un cliente.
Qué hace el NicoApp
Las acciones a continuación son las publicadas en el catálogo de la app (organizadas en las mismas carpetas usadas en el editor: Leads & Dados de Contato y Dados de Alunos).
Leads & Dados de Contato
Acción
Qué hace
Punto final
Entradas principales
Salidas
Consultar Informações de Clientes (Filtros)
Devuelve clientes con base en el e-mail o el CPF
GET /psec/clientes/consultarClienteJson
Id de negocio (requerido, selección dinámica); E-mail, CPF (opcionales, al menos uno recomendado)
ID do Cliente, N° Matrícula, Data de Nascimento, Situação Atual, E-mail, Telefone, CPF (1º de la lista) + Todos os Clientes Listados (JSON)
Consultar Cliente por ID
Devuelve los datos del cliente por el ID
GET /v1/cliente/{codigo}
ID do Cliente (requerido)
Nome, N° Matrícula, Situação Atual, CPF, Telefones (array), Data de Nascimento, E-mails (array), Todas as Informações (JSON)
Incluir Cliente
Registra un cliente como Visitante en la empresa
POST /v2/cliente
Id de negocio, Nome Completo, CPF, Celular (requeridos); N° Matrícula, Gênero, Data de Nascimento (opcionales)
ID do Cliente, Situação Atual, Todas as Informações (JSON)
Inserir Observações no Cliente
Guarda una observación en el registro del cliente
POST /cliente/gravarobservacao
Id de negocio, N° Matrícula, Observação (requeridos)
ID da Observação
Buscar Histórico de Presença
Obtiene clases realizadas, clases en el mes y semanas consecutivas de asistencia
GET /cliente/historico-presenca
Id de negocio, N° de Matrícula (requeridos)
Histórico (JSON)
Obter Informações do Plano do Cliente
Devuelve el plan actual del cliente
GET /clientes/{matricula}/dados-plano
N° de Matrícula (requerido)
Todas as Informações (JSON), Nome do Plano, Situação Atual, Vínculos, Possui GymPass, Possui TotalPass
Dados de Alunos
Acción
Qué hace
Punto final
Entradas principales
Salidas
Obter Objetivos do Aluno
Lista los objetivos registrados del alumno
GET /alunoTurma/objetivos/{matricula}
Id de negocio, N° de Matrícula (requeridos)
Objetivos (JSON)
Obter Parcelas em Aberto
Lista las cuotas pendientes del alumno (situación "EA", ignora remesa y multa/intereses)
GET /parcelas/by-matricula/{matricula}
N° da Matrícula (requerido)
Parcelas em Aberto (JSON)
Obter Saldo do Aluno
Devuelve el saldo actual de la cuenta corriente del alumno
GET /clientes/{matricula}/saldo-conta-corrente
N° Matrícula (requerido)
Saldo Atual
Nota
En desarrollo: el editor de la app tiene un décimo Flujo secundario, "Atualizar Situação de um Aluno" (endpoint previsto
/psec/alunos/situacao/{id}), que todavía no se ha publicado como acción en el catálogo de la app: hoy no aparece en la lista de acciones instalables. Antes de divulgar esta acción a los clientes, finaliza la llamada al endpoint correcto en el editor del flujo secundario.Consejos y observaciones
- Manejo de errores: cuando Pacto rechaza la llamada o esta falla, la acción cae en el bloque
action_failed, alimentado por el contenido de$.metade la respuesta: usa el camino de error del bloque para tratarlo en el flujo (p. ej., credencial inválida, matrícula no encontrada, límite de uso alcanzado). - Limpieza del payload: en acciones de escritura (p. ej., Incluir Cliente), un paso de JavaScript elimina del payload los campos
undefined,nullo cadena vacía antes de montar el cuerpo de la solicitud: evita enviar claves en blanco que la API podría rechazar o interpretar incorrectamente. - El N° de Matrícula es la clave principal: la mayoría de las acciones de consulta del alumno (Parcelas, Saldo, Plano, Objetivos, Histórico, Observação) usa la Matrícula como identificador: sale de Incluir Cliente/Consultar Cliente y debe guardarse en una variable del bot o del CRM en cuanto se obtiene.
- ID do Cliente encadenado: el ID do Cliente devuelto por Incluir Cliente o Consultar (Filtros) alimenta la acción Consultar Cliente por ID.
- Selección dinámica de Empresa: el campo Id de negocio carga las opciones directamente de la cuenta Pacto conectada (fuente dinámica "empresas"), elegidas una vez en el diseño del flujo.
- Ahorra solicitudes: como no hay confirmación pública de límites, trata la API de Pacto con la misma cautela recomendada para EVO: evita repetir consultas de catálogo/situación en cada mensaje y monitorea las respuestas de error que indiquen límite de uso.