Integración de Celoxis n8n: Nodos, disparadores y configuración

Ejecuta el trabajo de Celoxis desde n8n e inicia un flujo de trabajo cuando cambie un registro

Conecta Celoxis con n8n, una herramienta de automatización de flujos de trabajo, mediante el nodo de la comunidad de Celoxis n8n-nodes-celoxis. Con él podrás:

Ejecuta acciones de Celoxis desde un flujo de trabajo : crea, actualiza, busca o elimina proyectos, tareas, registros de tiempo, gastos y registros de aplicaciones personalizadas.
Inicie un flujo de trabajo desde Celoxis cuando se cree o actualice un registro.

¿n8n, Webhooks o Zapier?

Si quieres…	Usar
Solo notificar a otro sistema, sin crear un flujo de trabajo	Webhooks
Conecta una aplicación que ya esté en Zapier con un solo toque	Zapier
Crea un flujo de trabajo de varios pasos, o ya utilizas n8n	n8n (esta página)

n8n escucha crea y actualiza únicamente, no elimina. No necesitas configurar nada en Menú principalAdministraciónIntegracionesWebhooks — al activar el flujo de trabajo n8n, este se registra con Celoxis.

Antes de empezar

Integración de n8n en tu plan Celoxis.
Un usuario de Celoxis con privilegios de administrador que puede crear tokens de API. Todas las acciones de n8n se ejecutan como este usuario, con los permisos de este usuario.
Una instancia n8n que permite nodos de la comunidady permiso para instalarlos.
Solo para activadores: una https:// para n8n. n8n Cloud ya tiene una. Consulte Los activadores necesitan una dirección pública.

Paso 1: Instalar el nodo Celoxis

En n8n, ve a Configuración → Nodos de la comunidad y selecciona Instalar. Si la página no aparece, tu plan de n8n no permite nodos de la comunidad.
Ingresar n8n-nodos-celoxis, acepte el aviso de riesgo y seleccione Instalar.
El nombre del paquete es n8n-nodes-celoxis.
Agregue un nodo y busque Celoxis. Aparecerán dos nodos: Celoxis (ejecuta acciones) y Celoxis Trigger (inicia flujos de trabajo).

En una instalación autohospedada de n8n, puede ejecutar npm install n8n-nodes-celoxis y reiniciar n8n.

Paso 2: Conecte su cuenta de Celoxis

En Celoxis, haz clic en tu nombre → API, crea un token y cópialo. El token completo se muestra solo una vez.
El token de la API se encuentra en tu perfil, en la sección API.
En n8n, abre Credenciales y crea una de API de Celoxis .
Rellene el formulario:
- Token de acceso : pegue el token.
- URL del servidor : solo su dirección de Celoxis, como https://app.celoxis.com. No agregue /psa ni una barra diagonal al final.
Seleccionar Ahorrar. n8n prueba la conexión.
La prueba de credenciales fue exitosa. El servidor es solo el host.

Tu sitio Celoxis	URL del servidor
Software como servicio (SaaS) de EE. UU	`https://app.celoxis.com`
Software como servicio (SaaS) de la UE	`https://eu.celoxis.com`
En las instalaciones	La dirección en Menú principalAdministraciónConfiguración del sitio

Utilice esta misma credencial en ambos nodos de Celoxis. Trate el token como una contraseña.

Ejecutar acciones de Celoxis

Agregue un Celoxis , seleccione la credencial, elija una operacióny luego seleccione el tipo (Proyectos, Tareas, etc.). Espere a que se carguen los campos, complételos y seleccione el paso Ejecutar. El resultado incluye el ID.

Operación	Lo que hace
Crear registro	Agrega un nuevo registro.
Actualizar registro	Modifica los campos de un registro según su ID. Los campos vacíos permanecen sin cambios.
Obtener registro	Carga un registro mediante un único identificador, como un ID o una clave externa.
Buscar registros	Devuelve los registros que coinciden con tus filtros, una página a la vez.
Actualizar/insertar registro	Actualiza el registro con esa clave externa, o lo crea si la clave es nueva.
Registro clonado	Copia un proyecto o tarea. El original permanece sin cambios.
Eliminar registro	Elimina un registro por su ID. Esta acción es irreversible.
Tarea de mover	Mueve una tarea a un proyecto diferente, opcionalmente bajo una tarea principal.
Realizar transición de estado	Mueve un registro de aplicación personalizado a su siguiente estado, como Aprobar. Introduce primero el ID para que se carguen las transiciones.

Ejemplo: crear una tarea

Establezca la operación en Crear registro y el tipo en Tareas. Seleccione el proyecto de la lista, ingrese un nombrey seleccione el paso Ejecutar. Una tarea siempre necesita un proyecto.

Nodo Celoxis con Operación Crear Registro y Tipo Tareas, y la tarea creada en la salida — La operación es Crear registro, el tipo es Tareas, con un proyecto y un nombre.

Ejemplo: encontrar un proyecto

Establezca la operación en Buscar registros, seleccione Tipoy haga clic en Agregar filtro para cada condición. Todas las condiciones deben coincidir. Deje Límite en 0 y Ordenar vacío a menos que los necesite.

Nodo Celoxis con Operación Buscar Registros, Tipo Proyectos y un filtro Nombre Igual a — El filtro es Nombre igual al proyecto, y Ordenar está vacío.

Cada registro encontrado se convierte en un elemento n8n, y el siguiente nodo se ejecuta una vez por cada elemento. Una ejecución devuelve una página; para la siguiente, configure la página en 2

Consejos

Utilice identificadores, no nombres. Campos como proyecto, usuario o tarea principal necesitan el identificador del registro o uno seleccionado de la lista. Para usar un nombre, primero busque el registro y asigne {{ $json.id }}.
Las fechas en los filtros utilizan el formato aaaa-MM-dd.
Los operadores dependen del campo. " Contiene" y "Comienza con" funcionan con texto. "Mayor que" funciona con números y fechas.
Ordenación: la mayoría de los tipos se ordenan por id o nombre/asc. Los gastos se ordenan por fecha de creacióny las actualizaciones de estado de tareas por fecha.
Los errores detienen el flujo de trabajo. Active la opción "Continuar en caso de error" en la configuración del nodo para que los elementos restantes se ejecuten.
Solo verás lo que el usuario del token puede ver. Los tipos de registro, registros y campos ocultos no aparecen.

Iniciar un flujo de trabajo cuando cambie un registro

Agregue un Celoxis Trigger como primer nodo y elija la credencial.
Elegir Evento (Registro creado o registro actualizado) y Tipo.
El evento es Registro creado y el tipo es Proyectos.
Active el flujo de trabajo. Celoxis comenzará a enviar registros solo después de esto.
Crea o actualiza un registro en Celoxis. Se alcanza el tiempo de procesamiento n8n en aproximadamente 2 minutos para una creación, o en aproximadamente 10 minutos para una actualización.

Tipo	Creado	Actualizado
Proyectos, Tareas, Registros de tiempo, registros de aplicaciones personalizadas	Sí	Sí
Actualizaciones del estado de las tareas, actualizaciones de la aplicación, como actualizaciones de aprobación	Sí	No
Gastos	No	No

Los registros que existían antes de su activación, los registros eliminados y los eventos perdidos no se envían.
Una actualización del progreso de una tarea es una actualización del estado de la tarea, no una actualización de la tarea.
Para cambiar el evento o el tipo, desactive el flujo de trabajo, modifíquelo y luego vuelva a activarlo.
Esta prueba solo carga una muestra. No demuestra que Celoxis pueda alcanzar n8n.

Los desencadenantes necesitan una dirección pública

Celoxis debe poder acceder a n8n. La URL de producción debe ser una dirección pública https:// , no localhost.

n8n Cloud: nada que hacer.
Su propio servidor: configure WEBHOOK_URL con su dirección pública (sin /webhook, sin barra diagonal final), reinicie n8n y luego desactive y active el flujo de trabajo.

exportar WEBHOOK_URL=https://n8n.yourcompany.com n8n iniciar

Para Docker, agregue la misma variable en el entorno y vuelva a crear el contenedor.

Solución de problemas

Problema	Arreglar
`Tu plan no incluye la función: Integración n8n`	Tu plan no incluye n8n. Ponte en contacto con Celoxis. Cambiar el token no solucionará el problema.
La prueba de credenciales falla	Verifica que la URL del servidor no contenga `/psa` y que coincida con el sitio donde se creó el token. Crea un nuevo token si se eliminó.
de tipos está vacía.	Primero, corrige la prueba de credenciales. Luego, verifica que el usuario pueda usar ese tipo de registro en Celoxis.
La tarea falla después de escribir el nombre del proyecto	Utilice el ID del proyecto. Primero encuentre el proyecto y mapee `{{ $json.id }}`.
La función Buscar registros no devuelve nada	Elimine los filtros uno por uno. Utilice los ID para los valores seleccionados. Deje el campo Ordenar vacío.
`Ordenación no válida:id`	Los gastos se ordenan por `fecha de creación`, y las actualizaciones del estado de las tareas por `fecha`. O bien, deje el campo Ordenar vacío.
El disparador nunca se ejecuta	Active el flujo de trabajo, asegúrese de que la URL de producción sea pública `https://`, luego cree un nuevo registro y espere unos minutos.
La configuración de activación anterior sigue vigente	Desactívalo, cambia la configuración y vuelve a activarlo.
La lista de transiciones está vacía	Primero, introduzca el ID del registro de la aplicación personalizada. Las aplicaciones sin flujo de trabajo no tienen transiciones.
La tarea de mover falla	Elige un proyecto diferente. En ese proyecto ya debe existir una tarea principal.

Preguntas frecuentes

¿También necesito crear un webhook en Celoxis?

No. La activación del flujo de trabajo n8n registra el disparador. Menú principalAdministraciónIntegracionesWebhooks es una función independiente.

¿Puede iniciarse un flujo de trabajo cuando se elimina un registro?

No. Solo las creaciones y las actualizaciones inician un flujo de trabajo. Utilice webhooks para las eliminaciones.

¿Por qué se activó el disparador varios minutos después?

Es lo esperado: unos 2 minutos para crear un registro y unos 10 minutos para actualizar uno.

¿Qué sucede cuando desactivo el flujo de trabajo?

Celoxis deja de enviarle registros. Las acciones que usted ejecute y otros flujos de trabajo activos no se verán afectados.

¿Pueden dos flujos de trabajo escuchar el mismo evento?

Sí. Cada flujo de trabajo activo se registra por separado y ambos se ejecutan.

¿Qué ocurre si elimino el token de la API?

Las acciones fallarán hasta que cree un nuevo token, lo pegue en las credenciales y guarde. Luego, desactive y vuelva a activar los flujos de trabajo que se activan.

¿La opción Eliminar registro puede eliminar cualquier registro?

No. Sigue las mismas reglas que la eliminación en Celoxis, y solo se muestran los tipos que el usuario del token puede eliminar.