Integraciones/NicoApps (MiniApps) Nativos/Sistemas de Negocios Locales/Feegow (Gestión de Clínicas y Consultorios)
Feegow (Gestión de Clínicas y Consultorios)
Feegow es el NicoApp de integración con Feegow Clinic, sistema de gestión usado por clínicas y consultorios médicos (agenda, pacientes, exámenes, convenios, profesionales).
Nota
Disponible en la pestaña de NicoApps. Base de la integración: API oficial de Feegow Clinic (docs.feegow.com), autenticada mediante el encabezado
x-access-token.Feegow usa un token único (x-access-token) por licencia, liberado dentro del propio panel — no es necesario abrir un ticket de soporte para generar el token inicial:
- En el panel de Feegow Clinic, accede a Configuraciones → Otras Configuraciones → API Pública.
- Haz clic en Generar nuevo Token.
- Opcionalmente, edita el nombre/descripción del token (ícono de lápiz) y ajusta los permisos de acceso (ícono de candado) para los endpoints que la app va a usar (agenda, pacientes, exámenes, convenios, catálogo).
- Copia el token generado y pégalo en el campo de credencial en la instalación del NicoApp.
Atención
Solo los usuarios con perfil administrador pueden generar tokens de API en Feegow.
Fuentes: ¿Cómo integrar Feegow vía API con otros sistemas? (Centro de Ayuda de Feegow) y Feegow REST API v1.0 — Autorización (documentación de referencia para desarrolladores, con todos los parámetros de cada endpoint).
Nota
El Centro de Ayuda de Feegow refuerza que las integraciones vía API son responsabilidad del cliente, que debe contar con una empresa o un profesional técnico para configurarlas — Feegow no implementa la integración ni indica socios.
Atención
El límite de solicitudes (rate limit) y la exigencia de un plan/módulo específico para la API no son divulgados públicamente por Feegow. Confirma con el soporte de Feegow (sucesso@feegow.com.br) antes de dimensionar flujos de alto volumen.
- Si tu flujo pasa a depender de un alto volumen de llamadas (canal de atención con muchas conversaciones simultáneas), confirma directamente con el soporte de Feegow (sucesso@feegow.com.br) si existe throttling, cuota mensual o requisito de plan/módulo para la API Pública antes de escalar el uso.
- El token es único por licencia/permisos — no hay OAuth por usuario; trátalo como una credencial sensible (queda guardado en la instalación del NicoApp).
- Como no hay confirmación pública sobre el rate limit, adopta como buena práctica las mismas recomendaciones de otras integraciones: evita reconsultar el catálogo (profesionales/ubicaciones/convenios/especialidades/procedimientos/paquetes) en cada mensaje y prefiere cachear esos datos en variables del canal.
Acción
Endpoint
Qué hace
Entradas principales
Salidas
Crear nueva cita
POST /appoints/new-appointCrea una cita en la agenda de la clínica
local_id, paciente_id, profissional_id, especialidade_id, procedimento_id, data, horario (requeridos); valor, plano, convenio_id, convenio_plano_id, canal_id, tabela_id, notas, celular, telefone, email (opcionales)
ID de la Cita (agendamento_id)
Reprogramar cita
POST /appoints/rescheduleCambia la fecha/hora de una cita existente
agendamento_id, motivo_id, data, horario (requeridos); obs (opcional)
Contenido de la respuesta de Feegow
Cancelar cita
POST /appoints/cancel-appointCancela una cita
agendamento_id, motivo_id (requeridos); obs (opcional)
—
Actualizar Estado de la Cita
POST /appoints/statusUpdateActualiza el estado de una sesión agendada (ej.: confirmado, presente, falta)
AgendamentoID, StatusID (requeridos); Obs (opcional)
Confirmación (success)
Disponibilidad de horarios
GET /appoints/available-scheduleLista los horarios libres en un período, filtrando por profesional/especialidad/procedimiento/unidad/convenio
tipo; especialidade_id, procedimento_id, data_start, data_end, unidade_id, profissional_id, convenio_id (todos opcionales, se recomienda al menos un filtro)
Horarios disponibles por fecha (ya reordenados de la fecha más próxima a la más distante)
Listar citas
GET /appoints/searchBusca citas por paciente y/o período
data_start, data_end, paciente_id (opcionales)
Lista de citas (agendamento_id, data, horario, paciente_id, procedimento_id, profissional_id, agendado_em)
Acción
Endpoint
Qué hace
Entradas principales
Salidas
Crear paciente
POST /patient/createRegistra un nuevo paciente en Feegow
nome_completo (requerido); cpf, data_nascimento, genero, celular(es), telefone(s), email(s), dirección completa, convenio_id, plano_id, matrícula, entre otros (opcionales)
ID del Paciente (paciente_id)
Actualizar paciente
POST /patient/editActualiza los datos de un paciente existente
paciente_id (requerido) + cualquiera de los campos de Crear paciente para actualizar
Contenido de la respuesta de Feegow
Recuperar información del paciente
GET /patient/search (con fallback a GET /patient/list por teléfono)Busca un paciente por ID, CPF o teléfono
paciente_id o cpf o telefone (al menos uno requerido)
Nombre, fecha de nacimiento, celulares, teléfonos, correos electrónicos, documentos (RG/CPF), convenios, observación y paciente_id
Acción
Endpoint
Qué hace
Entradas principales
Salidas
Listar pedidos de exámenes
GET /patient/exam-requestsLista los pedidos de examen de un paciente
paciente_id o cpf (requerido); data_inicio, data_fim, tipo_pedido (opcionales)
Lista de pedidos (PedidoExameID, PacienteID, DataPedido, PedidoExame)
Acción
Endpoint
Qué hace
Entradas principales
Salidas
Listar Profesionales
GET /professional/listLista los profesionales registrados
—
Profesionales encontrados (JSON), total
Listar Ubicaciones
GET /company/list-localLista las unidades/ubicaciones de atención
—
Ubicaciones encontradas (JSON), total
Listar Convenios
GET /insurance/listLista los convenios registrados
—
Convenios encontrados (JSON, sin datos de dirección), total
Listar Especialidades
GET /specialties/listLista las especialidades médicas registradas
—
Especialidades encontradas (JSON), total
Listar Canales
GET /appoints/list-channelLista los canales de agendamiento (origen de la cita)
—
Canales encontrados (JSON), total
Listar Procedimientos
GET /procedures/listLista los procedimientos/servicios de la clínica
tipo_procedimento, procedimento_id, unidade_id, paciente_id, especialidade_id, profissional_id, tabela_id, nome_procedimento (todos opcionales)
Procedimientos encontrados (JSON), total
Listar Paquetes
GET /procedures/bundlesLista los paquetes de procedimientos
procedimento_id, pacote_id (opcionales)
Paquetes encontrados (JSON), total
- Tratamiento de errores: cuando Feegow rechaza la operación, la acción falla y devuelve el mensaje de error real de Feegow a través del bloque
action_failed— usa el camino de error del bloque en el flujo para tratar esto (ej.: horario no disponible, campo requerido faltante, token sin permiso para el endpoint). - Relleno automático de notas/obs: si el campo de observación queda vacío, la app lo completa automáticamente con un texto estándar antes de enviar — "Agendamento da Automação" en Crear nueva cita, y "Desmarcado pela automação" en Cancelar cita. Esto facilita identificar después, en el panel de Feegow, qué registros vinieron de la automatización.
- Disponibilidad de horarios reordenada por fecha: la respuesta bruta de Feegow llega agrupada por profesional/ubicación; la app reprocesa el retorno y reordena los horarios por fecha (de la más próxima a la más distante), ya unificados en un único objeto por fecha — listo para presentar al contacto.
- Recuperar paciente por teléfono: cuando no hay paciente_id ni CPF, la acción recurre a
GET /patient/listfiltrando por teléfono y trata los tres escenarios: ninguno encontrado, uno encontrado (sigue normalmente) o múltiples encontrados (devuelve un aviso para desambiguar con el contacto). - IDs encadenados: paciente_id sale de Crear paciente o Recuperar información del paciente y alimenta Crear/Reprogramar/Cancelar cita, Actualizar paciente y Listar pedidos de exámenes. agendamento_id sale de Crear nueva cita y alimenta Reprogramar, Cancelar y Actualizar Estado.
- Ahorra solicitudes: aunque Feegow no publique límites de rate limit, es buena práctica no reconsultar el catálogo (profesionales/ubicaciones/convenios/especialidades/procedimientos/paquetes) en cada mensaje — esos datos cambian poco; guarda los IDs en variables del canal.
- Formato de fechas: la mayoría de los endpoints de agenda usa
DD-MM-AAAA(ej.: 16-12-2025) y horario separado enHH:MM:SS; verifica el formato esperado de cada campo al armar el flujo.