Funzionalità sperimentale. L'integrazione n8n non è ancora completamente testata. L'amministratore la attiva consapevolmente in Impostazioni → Avanzate → Altro; finché è disattivata, la scheda n8n e questo capitolo della guida restano nascosti, e gli endpoint /api/n8n/* sono inattivi.

Cos'è n8n?

n8n è una piattaforma per l'automazione dei processi. L'integrazione con Task Manager funziona in entrambe le direzioni:

  1. Webhook in uscita (Task Manager → n8n) - l'applicazione invia da sola le notifiche al tuo workflow in n8n quando succede qualcosa (creazione di un'attività, cambio di stato, aggiunta di un messaggio, avvicinarsi di una scadenza, ecc.).
  2. API in entrata (n8n → Task Manager) - n8n può chiamare l'applicazione per creare attività, aggiungere messaggi o recuperare dati.

Attivazione dell'integrazione

Clicca sull'icona dell'ingranaggio (⚙) → scheda n8n. La scheda è divisa in due parti: "Automazioni personali" - configurazione che riguarda solo te, e "Automazioni globali" - impostazioni di sistema comuni a tutti gli utenti, visibili solo all'amministratore. Perché gli eventi vengano inviati, l'amministratore deve attivare l'interruttore "Attiva integrazione n8n" nella parte globale.

A. Webhook in uscita - notifiche dall'applicazione a n8n

Configurazione

  1. Nella scheda n8n clicca su "Nuovo webhook".
  2. Inserisci il nome del webhook e l'URL del webhook copiato da n8n (nodo Webhook come trigger, metodo POST).
  3. Seleziona gli eventi da inviare.
  4. (Facoltativo) imposta un segreto - l'applicazione lo userà per firmare le richieste (HMAC), così n8n potrà verificarne l'autenticità.
  5. Salva. Puoi inviare un ping di prova per verificare la connessione.

Eventi disponibili (selezione)

  • Attività: task.created, task.updated, task.status_changed, task.completed, task.deleted, task.deadline_approaching, task.overdue
  • Chat / messaggi: chat.message_sent, chat.mention, chat.file_uploaded
  • Utenti / spazio di lavoro: user.created, user.login, user.logout, workspace.created
  • Di sistema: system.daily_summary, system.weekly_summary

Ogni richiesta a n8n contiene il nome dell'evento e i dati (data) con il contesto (ad es. id dell'attività, spazio di lavoro, autore).

B. API in entrata - n8n controlla l'applicazione

Configurazione

  1. Nella scheda n8n clicca su "Nuova chiave API".
  2. Copia il token generato (mostrato una sola volta).
  3. In n8n usa il nodo HTTP Request con l'header di autorizzazione:
    Authorization: Bearer TWÓJ_TOKEN
    Le azioni vengono eseguite nel contesto dell'utente che ha creato la chiave (con i suoi permessi e il suo accesso agli spazi di lavoro).

Endpoint disponibili

  • GET /api/n8n/ping.php - test del token e controllo di stato (restituisce le informazioni sulla chiave e sull'utente).
  • GET /api/n8n/workspaces.php - elenco degli spazi di lavoro disponibili.
  • GET /api/n8n/users.php - elenco degli utenti (solo per le chiavi create dall'amministratore globale).
  • GET /api/n8n/tasks.php?workspace_id=&status=&limit= - elenco delle attività.
  • POST /api/n8n/tasks.php - creazione di un'attività. Corpo 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 — aggiornamento di un'attività esistente, tra cui il cambio di stato. Corpo JSON (task_id obbligatorio, gli altri campi sono opzionali - indichi solo ciò che vuoi modificare):
    {
"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. Il cambio di stato funziona esattamente come dall'app: nella discussione dell'attività compare la voce “ha cambiato lo stato in…”, le persone assegnate ricevono una notifica via e-mail e verso n8n parte il webhook task.status_changed (e task.completed con done).
    • deadline_date: null cancella la scadenza. Cambiare la scadenza sposta i promemoria a essa collegati.
    • Gli altri campi inviano il webhook task.updated.
    • Impostare di nuovo lo stesso stato non invia nulla (sicuro in caso di ripetizioni in n8n).
    • Se il tuo nodo HTTP non supporta il metodo PATCH - invia lo stesso corpo tramite POST: la presenza di task_id fa passare l'endpoint alla modalità di aggiornamento.
    • Codici di errore: 400 task_id mancante o nessun campo da modificare, 422 valore non valido (stato/priorità/formato data), 404 l'attività non esiste o è al di fuori dell'accesso della chiave, 403 permessi insufficienti per modificare lo stato/i dati.
  • POST /api/n8n/messages.php - aggiunta di un messaggio a un'attività o a una chat. Corpo JSON:
    {
"entity_type": "task",
"entity_id": 42,
"content": "Treść wiadomości"
}

Esempi di scenari di automazione

  • Modulo Google → n8n → POST /api/n8n/tasks.php (nuova attività in Task Manager)
  • Email da Gmail con un oggetto specifico → n8n → attività con descrizione tratta dal testo dell'email
  • Cambio di stato in Jira → n8n → messaggio/aggiornamento dell'attività collegata
  • Webhook in uscita task.created → n8n → riga in un foglio Google / notifica su Slack
  • task.deadline_approaching → n8n → promemoria email/SMS per la scadenza imminente

Risoluzione dei problemi

  • Nessuna notifica in n8n - verifica che l'integrazione sia attiva, il webhook abilitato e l'URL corretto. Usa il "ping di prova".
  • Autorizzazione mancante (401) nell'API in entrata - il token non è valido o è stato eliminato. Crea una nuova chiave API e aggiorna l'header Authorization in n8n.
  • L'attività non viene creata - assicurati che workspace_id esista e che l'utente della chiave vi abbia accesso e il permesso di aggiungere attività.