Clínica Experts
Clínica Experts es la NicoApp de integración con el sistema de gestión de clínicas Clínica Experts (app.clinicaexperts.com.br). Con ella, el flujo de NicoChat crea, edita y busca pacientes.
Nota
App de autoría propia de NicoChat, en Beta (v1.0.0), ya instalada en canales de clientes. Disponible en la pestaña de NicoApps.
Cómo obtener las credenciales (token) de la API
Atención
Clínica Experts no publica una guía de integraciones/API para desarrolladores. Solicite al soporte o al gerente de cuenta de Clínica Experts la habilitación del token de integración.
Lo que confirmamos por la configuración técnica de la NicoApp:
- La autenticación es por token único (Bearer) — no usa usuario + contraseña (Basic Auth). En la instalación de la app, solo se solicita un campo de Token.
- El endpoint base consumido es
https://app.clinicaexperts.com.br/api/v1/patients.
Recomendación: contacte al soporte o al gerente de cuenta de Clínica Experts para solicitar la habilitación de una clave de API para integraciones externas. Vale la pena preguntar también si existe una pantalla de "Integraciones" en el panel de la clínica, ya que el acceso puede estar vinculado a un plan específico.
Limitaciones
Atención
El límite de solicitudes y la exigencia de un plan específico para la API no son divulgados públicamente por Clínica Experts. Confirme con el soporte o el gerente de cuenta antes de dimensionar flujos de alto volumen.
- Sin información pública sobre el rate limit o la cuota mensual de la API.
- Sin información pública sobre si la API exige un plan específico de Clínica Experts.
- Trate siempre la ruta de error de las acciones (mapeo
$.errors) — es la única forma de saber si Clínica Experts rechazó una llamada (ej.: paciente duplicado, campo inválido, token expirado o sin permiso).
Qué hace la NicoApp
La app está estructurada en 5 flujos secundarios. De estos, 3 ya están listos y publicados como acciones — es lo que documenta la tabla a continuación:
Acción
Qué hace
Entradas principales
Salidas
Crear Paciente
Registra un nuevo paciente en Clínica Experts
Nombre, E-mail, Teléfono, Anotación, Fecha de Nacimiento, Sexo, Estado Civil, Profesión, Notificaciones (SMS/WhatsApp/E-mail), Documento (tipo + número), Origen, Contactos (Facebook/Instagram); Dirección (Código Postal, Calle, Número, Complemento, Barrio, Ciudad, Estado, País) — enviado solo si el Código Postal está completado
ID del Paciente (uuid), Errores
Editar Paciente
Actualiza los datos de un paciente existente (actualización parcial: solo envía los campos completados)
ID del Paciente (requerido) + cualquier campo de Crear Paciente que necesite cambiar
ID del Paciente, Errores
Buscar Paciente
Busca un paciente registrado por el e-mail
E-mail
ID del Paciente (uuid), Errores
Nota
Nota técnica (hallazgo de esta revisión): en la configuración actualmente guardada de Buscar Paciente, el parámetro de e-mail usado en la llamada aparece fijo en un valor de prueba, en vez de vinculado a la variable de entrada del flujo. Antes de divulgar esta acción ampliamente, valide con una prueba real — buscando por un e-mail diferente del usado en las pruebas — si el resultado corresponde al e-mail informado.
Atención
Horarios disponibles y Webhook existen en el builder de esta app, pero están en borrador (no publicados) e inconsistentes: "Horarios disponibles" todavía llama al endpoint de pacientes (
/api/v1/patients) en vez de un endpoint de agenda/horarios, y "Webhook" está vacío, sin ninguna lógica implementada. No use estas dos acciones en producción hasta que sean revisadas y corregidas.Consejos y observaciones
- Tratamiento de errores: todas las acciones mapean la respuesta de error de la API (
$.errors) en una variable — use la ruta de error del bloque de acción para tratar fallas en el flujo (ej.: paciente duplicado, campo obligatorio faltante, token inválido). - Dirección opcional: en Crear Paciente, el bloque de dirección solo se envía si el campo Código Postal está completado.
- Actualización parcial: en Editar Paciente, solo es necesario informar los campos que realmente cambiaron — los campos vacíos no sobrescriben lo que ya está registrado.
- ID del Paciente (uuid): guárdelo en una variable del bot en cuanto cree o busque un paciente, para reutilizarlo en las próximas acciones (ej.: Editar Paciente).
- Token: trátelo como secreto — configúrelo solo en el campo de autenticación de la app en la instalación, nunca en texto libre dentro del flujo.