No puedo instalar FITsociety en n8n Cloud
El nodo de FITsociety está publicado para instalaciones propias de n8n, pero aún no tiene la aprobación de n8n Cloud. Publicarlo en npm no lo hace disponible automáticamente en Cloud. Por eso, esta guía se refiere a un entorno autoalojado.
Faltan Community nodes o el nodo de FITsociety
Pide al Owner o Admin de n8n que compruebe si se permiten nodos de la comunidad en tu entorno y si n8n-nodes-fitsociety está instalado. Utiliza n8n 2.44.6 o posterior. Si hay varios workers, todos deben tener la misma versión del paquete. No lo elimines como primer paso de recuperación: los flujos existentes pueden depender de él.
La prueba de conexión falla
Utiliza la URL HTTPS completa con
/public/v1como API Base URL.Comprueba que Company ID, Client ID y Client Secret pertenezcan a la misma empresa y a la conexión de n8n.
No utilices como sustitutos credenciales de Zapier, Make ni otras API.
Comprueba que el acceso siga activo. Si se ha revocado o sustituido, solicita nuevos datos al administrador de la empresa y a soporte de FITsociety.
Una prueba de conexión correcta confirma la conexión con el perfil de empresa. No demuestra que la credencial pueda realizar todas las acciones. Si solo falta una función, solicita una revisión de los permisos asignados.
Una acción devuelve un error de acceso, búsqueda o validación
401 o conexión no válida: comprueba la credencial y si el acceso de la empresa sigue activo.
403 o permisos insuficientes: solicita una revisión de los permisos necesarios para la acción o los datos. Una credencial de lectura no puede modificar un cliente.
404 o no encontrado: comprueba la empresa y el Client ID o Booking ID correcto.
409 o conflicto: comprueba si el registro ya existe o si se está utilizando una clave de repetición con datos modificados.
Datos no válidos: comprueba los campos obligatorios, las fechas, las zonas horarias y los valores permitidos de los campos personalizados.
429 o demasiadas solicitudes: reduce la concurrencia y respeta el tiempo de espera indicado antes de reintentar.
Si una búsqueda de clientes no devuelve resultados, utiliza el correo electrónico exacto y comprueba los filtros de estado. En las búsquedas de calendario y reservas, el intervalo máximo permitido es de 92 días.
El trigger no recibe nada
Comprueba que el flujo esté activo o publicado y que los Events seleccionados sean correctos.
Comprueba que la credencial tenga permisos de webhook y las confirmaciones de datos necesarias. Una búsqueda normal correcta no lo demuestra.
Pide al administrador de n8n que revise la URL pública HTTPS del webhook y los ajustes del proxy inverso. FITsociety debe poder acceder directamente a la URL; se rechazan localhost, direcciones privadas y redirecciones.
Después de cambiar la URL, los Events o la credencial, desactiva el flujo y vuelve a activarlo.
Crea un evento de prueba nuevo adecuado y consulta el historial de ejecuciones. Los eventos antiguos no se reenvían automáticamente.
Aparece un aviso sobre firma o marca de tiempo
El trigger comprueba si un mensaje procede realmente de FITsociety. Pide al administrador que revise el reloj del servidor y el proxy y compruebe que el contenido original del webhook se reenvíe sin cambios. No desactives esta comprobación. Después de sustituir Client Secret, debes reactivar los flujos con triggers.
Una acción se ejecuta dos veces
La entrega de webhooks puede repetirse. Utiliza el ID original del evento para eliminar duplicados y como Business Event Key en las acciones de escritura de FITsociety. No utilices un ID nuevo aleatorio en cada reintento. Comprueba también la protección contra duplicados de la app receptora.
Ayuda de soporte
Indica el nombre de la empresa, tu versión de n8n, la versión del paquete de FITsociety, el recurso y la acción o trigger, el mensaje de error y la hora con zona horaria. Añade el ID de ejecución si está disponible. Oculta claves, tokens, secretos de webhook y datos de clientes en capturas y exportaciones de flujos. No compartas Client Secret en tu mensaje de soporte.