Utiliza el nodo FITsociety para consultar o modificar datos. Utiliza FITsociety Trigger cuando un evento de FITsociety deba iniciar el flujo. Las acciones realmente permitidas dependen de los permisos de la credencial de tu empresa.
Acciones disponibles
Client: buscar, obtener, crear, actualizar datos de contacto e invitar.
Tag: obtener etiquetas y añadirlas a un cliente o eliminarlas.
Coach: obtener coaches y asignar un coach a un cliente.
Booking: buscar, obtener, crear, cancelar y actualizar la asistencia.
Calendar Event: obtener eventos de agenda.
Form: obtener formularios, asignar una evaluación inicial y programar una revisión.
Custom Field: obtener definiciones de campos y valores de clientes, y modificar valores editables.
Recibir un evento no concede permisos adicionales de escritura. Por ejemplo, un evento de factura está disponible como trigger, pero el nodo no incluye una acción general para crear facturas. En las reservas siguen aplicándose las reglas habituales de la empresa, los productos disponibles y los saldos.
Ejemplo: buscar y obtener un cliente
Crea un flujo con un Manual Trigger.
Añade FITsociety con Client → Search y filtra por el correo electrónico exacto de un cliente de prueba.
Añade un segundo nodo de FITsociety con Client → Get.
Vincula el Client ID de los resultados de búsqueda con el campo Client ID del segundo nodo.
Ejecuta el flujo y comprueba los resultados. Añade una condición si la búsqueda puede no devolver resultados.
Iniciar un flujo desde FITsociety
FITsociety Trigger ofrece un catálogo de 56 eventos relacionados, entre otros, con clientes, reservas, facturación, formularios, mediciones, objetivos, hábitos, documentos y conversaciones. Un evento no es una exportación completa del expediente subyacente. Comprueba los campos recibidos antes de seguir utilizándolos.
Añade FITsociety Trigger como nodo inicial.
Selecciona la credencial de empresa correcta.
En Events elige uno o varios eventos adecuados.
Añade el siguiente paso deseado y los filtros necesarios.
Guarda el flujo y actívalo o publícalo, según el nombre utilizado en tu versión de n8n.
Después, realiza una acción de prueba adecuada en FITsociety y comprueba la ejecución en n8n.
La activación registra automáticamente la suscripción. No necesitas crear manualmente un webhook genérico en FITsociety. Sin embargo, tu credencial debe tener permisos de webhook y los consentimientos separados necesarios para datos de salud y comunicaciones privadas. Los permisos de lectura de clientes por sí solos no bastan.
Para los triggers, n8n debe ser accesible mediante una URL pública HTTPS de webhook. Una dirección localhost o solo interna no funciona. Después de cambiar Events, la URL del webhook o la credencial, desactiva y reactiva el flujo del trigger para actualizar la suscripción. Los eventos históricos no se recuperan automáticamente.
Procesar eventos repetidos de forma segura
Un evento puede entregarse de nuevo, por ejemplo, tras un fallo temporal de conexión. Utiliza el id del evento para detectar duplicados en los pasos siguientes. En las acciones de escritura de FITsociety puedes vincular este ID a Business Event Key para que una ejecución repetida reconozca la misma acción prevista durante el período de retención. Utiliza claves o nodos distintos para cambios independientes. Esto no garantiza una protección ilimitada contra duplicados en todas las apps conectadas.
Introducir los datos con cuidado
Para las búsquedas de calendario y reservas, elige un intervalo máximo de 92 días. Utiliza YYYY-MM-DD para fechas y una zona horaria para horas. En campos personalizados, modifica solo los campos seleccionados; cero y false siguen siendo valores válidos. Para borrar un valor deliberadamente, utiliza null. La validación de la empresa sigue aplicándose.
Prueba acciones de escritura solo con datos destinados a ello. Client Create puede vincular una cuenta existente y enviar un correo al respecto. Client Send Invitation envía una invitación real. El nodo de FITsociety también puede utilizarse como herramienta de un agente de IA preparado para ello; limita las acciones y los datos disponibles a lo que ese agente necesite.