Función experimental. La integración con n8n aún no está totalmente probada. El administrador la activa de forma consciente en Ajustes → Avanzado → Otros; mientras esté desactivada, la pestaña n8n y este capítulo del manual quedan ocultos, y los endpoints /api/n8n/* están inactivos.

¿Qué es n8n?

n8n es una plataforma de automatización de procesos. La integración con Task Manager funciona en ambos sentidos:

  1. Webhooks salientes (Task Manager → n8n) - la aplicación envía notificaciones a tu flujo de trabajo en n8n cuando ocurre algo (se crea una tarea, cambia un estado, se añade un mensaje, se acerca un plazo, etc.).
  2. API entrante (n8n → Task Manager) - n8n puede invocar la aplicación para crear tareas, añadir mensajes o recuperar datos.

Activación de la integración

Haz clic en el icono de la rueda dentada (⚙) → pestaña n8n. La pestaña se divide en dos partes: „Automatizaciones personales" - configuración que te afecta solo a ti, y „Automatizaciones globales" - ajustes del sistema comunes a todos los usuarios, visibles solo para el administrador. Para que se envíen los eventos, el administrador debe activar el interruptor „Activar integración con n8n" en la parte global.

A. Webhooks salientes - notificaciones de la aplicación a n8n

Configuración

  1. En la pestaña n8n haz clic en „Nuevo webhook".
  2. Indica el nombre del webhook y la URL del webhook copiada de n8n (nodo Webhook como disparador, método POST).
  3. Marca los eventos que deben enviarse.
  4. (Opcional) configura un secreto - la aplicación firmará con él las solicitudes (HMAC), para que n8n pueda verificar su autenticidad.
  5. Guarda. Puedes enviar un ping de prueba para comprobar la conexión.

Eventos disponibles (selección)

  • Tareas: task.created, task.updated, task.status_changed, task.completed, task.deleted, task.deadline_approaching, task.overdue
  • Chats / mensajes: chat.message_sent, chat.mention, chat.file_uploaded
  • Usuarios / espacio de trabajo: user.created, user.login, user.logout, workspace.created
  • Del sistema: system.daily_summary, system.weekly_summary

Cada solicitud a n8n incluye el nombre del evento y los datos (data) con el contexto (p. ej. id de la tarea, espacio de trabajo, autor).

B. API entrante - n8n controla la aplicación

Configuración

  1. En la pestaña n8n haz clic en „Nueva clave API".
  2. Copia el token generado (se muestra solo una vez).
  3. En n8n usa el nodo HTTP Request con la cabecera de autorización:
    Authorization: Bearer TWÓJ_TOKEN
    Las acciones se ejecutan en el contexto del usuario que creó la clave (sus permisos y su acceso a los espacios de trabajo).

Endpoints disponibles

  • GET /api/n8n/ping.php - prueba del token y comprobación de estado (devuelve información de la clave y del usuario).
  • GET /api/n8n/workspaces.php - lista de los espacios de trabajo disponibles.
  • GET /api/n8n/users.php - lista de usuarios (solo con claves creadas por el administrador global).
  • GET /api/n8n/tasks.php?workspace_id=&status=&limit= - lista de tareas.
  • POST /api/n8n/tasks.php - creación de una tarea. Cuerpo JSON:
    {
"workspace_id": 1,
"subject": "Nowe zadanie z n8n",
"description": "Opcjonalny opis",
"priority": "high",
"deadline_date": "2025-12-31",
"status": "none",
"assignees": [2, 5]
}
  • PATCH /api/n8n/tasks.php — actualización de una tarea existente, entre otros el cambio de estado. Cuerpo JSON (task_id obligatorio, el resto de los campos son opcionales - indicas solo lo que quieres cambiar):
    {
"task_id": 42,
"status": "in_progress",
"priority": "high",
"deadline_date": "2026-08-01",
"subject": "Nowy temat",
"description": "Nowy opis"
}
    • status: none | in_progress | done | cancelled. El cambio de estado funciona exactamente igual que desde la aplicación: en el hilo de la tarea aparece un mensaje «cambió el estado a…», las personas asignadas reciben una notificación por correo y a n8n se envía el webhook task.status_changed (y task.completed cuando el estado es done).
    • deadline_date: null borra el plazo. El cambio de plazo desplaza los recordatorios vinculados a él.
    • El resto de campos envían el webhook task.updated.
    • Establecer el mismo estado de nuevo no envía nada (seguro ante reintentos en n8n).
    • Si tu nodo HTTP no admite el método PATCH, envía el mismo cuerpo mediante POST: la presencia de task_id pone el endpoint en modo actualización.
    • Códigos de error: 400 falta task_id o no hay campos que cambiar, 422 valor no válido (estado/prioridad/formato de fecha), 404 la tarea no existe o está fuera del alcance de la clave, 403 sin permisos para cambiar el estado o editar.
  • POST /api/n8n/messages.php - añadir un mensaje a una tarea o a un chat. Cuerpo JSON:
    {
"entity_type": "task",
"entity_id": 42,
"content": "Treść wiadomości"
}

Ejemplos de escenarios de automatización

  • Formulario de Google → n8n → POST /api/n8n/tasks.php (nueva tarea en Task Manager)
  • Correo de Gmail con un asunto determinado → n8n → tarea con la descripción tomada del cuerpo del correo
  • Cambio de estado en Jira → n8n → mensaje/actualización de la tarea vinculada
  • Webhook saliente task.created → n8n → entrada en una hoja de Google / notificación en Slack
  • task.deadline_approaching → n8n → recordatorio por correo/SMS de un plazo próximo

Resolución de problemas

  • Sin notificaciones en n8n - comprueba que la integración está activada, el webhook activo y la URL correcta. Usa el „ping de prueba".
  • Sin autorización (401) en la API entrante - el token es incorrecto o se ha eliminado. Crea una nueva clave API y actualiza la cabecera Authorization en n8n.
  • La tarea no se crea - asegúrate de que workspace_id existe y de que el usuario de la clave tiene acceso a él y permiso para añadir tareas.