Fonctionnalité expérimentale. L'intégration n8n n'est pas encore entièrement testée. L'administrateur l'active en connaissance de cause dans Paramètres → Avancé → Autre ; tant qu'elle est désactivée, l'onglet n8n et ce chapitre de l'aide restent masqués, et les points d'accès /api/n8n/* sont inactifs.

Qu'est-ce que n8n ?

n8n est une plateforme d'automatisation de processus. L'intégration avec Task Manager fonctionne dans les deux sens :

  1. Webhooks sortants (Task Manager → n8n) - l'application envoie elle-même des notifications à votre workflow dans n8n lorsque quelque chose se produit (tâche créée, statut modifié, message ajouté, échéance qui approche, etc.).
  2. API entrante (n8n → Task Manager) - n8n peut appeler l'application pour créer des tâches, ajouter des messages ou récupérer des données.

Activation de l'intégration

Cliquez sur l'icône de roue dentée (⚙) → onglet n8n. L'onglet se divise en deux parties : « Automatisations personnelles » - configuration vous concernant exclusivement, et « Automatisations globales » - réglages système communs à tous les utilisateurs, visibles uniquement par l'administrateur. Pour que les événements soient envoyés, l'administrateur doit activer l'interrupteur « Activer l'intégration n8n » dans la partie globale.

A. Webhooks sortants - notifications de l'application vers n8n

Configuration

  1. Dans l'onglet n8n, cliquez sur « Nouveau webhook ».
  2. Indiquez le nom du webhook ainsi que l'URL du webhook copiée depuis n8n (nœud Webhook comme déclencheur, méthode POST).
  3. Cochez les événements à envoyer.
  4. (Facultatif) définissez un secret - l'application signera les requêtes avec (HMAC), afin que n8n puisse vérifier leur authenticité.
  5. Enregistrez. Vous pouvez envoyer un ping de test pour vérifier la connexion.

Événements disponibles (sélection)

  • Tâches : task.created, task.updated, task.status_changed, task.completed, task.deleted, task.deadline_approaching, task.overdue
  • Discussions / messages : chat.message_sent, chat.mention, chat.file_uploaded
  • Utilisateurs / espace de travail : user.created, user.login, user.logout, workspace.created
  • Système : system.daily_summary, system.weekly_summary

Chaque requête vers n8n contient le nom de l'événement ainsi que des données (data) avec le contexte (par ex. id de la tâche, espace de travail, auteur).

B. API entrante - n8n pilote l'application

Configuration

  1. Dans l'onglet n8n, cliquez sur « Nouvelle clé API ».
  2. Copiez le jeton généré (affiché une seule fois).
  3. Dans n8n, utilisez le node HTTP Request avec l'en-tête d'autorisation :
    Authorization: Bearer TWÓJ_TOKEN
    Les actions sont exécutées dans le contexte de l'utilisateur qui a créé la clé (ses droits et son accès aux espaces de travail).

Points d'accès disponibles

  • GET /api/n8n/ping.php - test du jeton et bilan de santé (renvoie des infos sur la clé et l'utilisateur).
  • GET /api/n8n/workspaces.php - liste des espaces de travail disponibles.
  • GET /api/n8n/users.php - liste des utilisateurs (uniquement pour les clés créées par l'administrateur global).
  • GET /api/n8n/tasks.php?workspace_id=&status=&limit= - liste des tâches.
  • POST /api/n8n/tasks.php - création d'une tâche. Corps 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 — mise à jour d'une tâche existante, entre autres un changement de statut. Corps JSON (task_id obligatoire, les autres champs sont facultatifs - indiquez seulement ce que vous voulez modifier) :
    {
"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. Le changement de statut fonctionne exactement comme depuis l'application : une entrée « a changé le statut en… » apparaît dans le fil de la tâche, les personnes assignées reçoivent une notification par e-mail, et un webhook task.status_changed est envoyé à n8n (ainsi que task.completed pour done).
    • deadline_date: null efface l'échéance. Changer l'échéance déplace les rappels qui y sont attachés.
    • Les autres champs déclenchent le webhook task.updated.
    • Redéfinir le même statut n'envoie rien (sans risque en cas de nouvelles tentatives dans n8n).
    • Si votre node HTTP ne prend pas en charge la méthode PATCH - envoyez le même corps via POST : la présence de task_id fait passer le endpoint en mode mise à jour.
    • Codes d'erreur : 400 task_id manquant ou aucun champ à modifier, 422 valeur invalide (statut/priorité/format de date), 404 la tâche n'existe pas ou est hors d'accès de la clé, 403 droits insuffisants pour modifier le statut/éditer.
  • POST /api/n8n/messages.php - ajout d'un message à une tâche ou à une discussion. Corps JSON :
    {
"entity_type": "task",
"entity_id": 42,
"content": "Treść wiadomości"
}

Exemples de scénarios d'automatisation

  • Formulaire Google → n8n → POST /api/n8n/tasks.php (nouvelle tâche dans Task Manager)
  • E-mail Gmail avec un objet donné → n8n → tâche avec une description tirée du contenu de l'e-mail
  • Changement de statut dans Jira → n8n → message/mise à jour de la tâche liée
  • Webhook sortant task.created → n8n → entrée dans une feuille Google / notification sur Slack
  • task.deadline_approaching → n8n → rappel e-mail/SMS d'une échéance qui approche

Résolution des problèmes

  • Aucune notification dans n8n - vérifiez que l'intégration est activée, que le webhook est actif et que l'URL est correcte. Utilisez le « ping de test ».
  • Absence d'autorisation (401) dans l'API entrante - le jeton est invalide ou a été supprimé. Créez une nouvelle clé API et mettez à jour l'en-tête Authorization dans n8n.
  • La tâche n'est pas créée - assurez-vous que workspace_id existe et que l'utilisateur de la clé y a accès ainsi que le droit d'ajouter des tâches.