Ressources · Intégration n8n

Intégration awork n8nAutomatiser awork avec n8n.

Tout ce que ton équipe range dans awork devient pilotable depuis un workflow. Le nœud couvre 37 opérations réparties sur 5 ressources. Le awork Trigger écoute 35 événements et les transmet en quelques secondes. L'intégration awork n8n vise les structures qui vivent au rythme des projets clients.

Nœud communautaire Ce nœud n'est pas livré avec n8n : c'est un paquet communautaire (n8n-nodes-awork) à installer depuis Settings › Community nodes sur une instance auto-hébergée. npm

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

Pourquoi monter une intégration awork n8n ?

Le nœud awork donne à un workflow la main sur les objets que l'équipe manipule au quotidien : entreprises, projets, tâches de projet, documents et utilisateurs. Combiné au awork Trigger et à ses 35 événements, n8n devient la couche qui réagit à ce qui bouge dans awork et qui y réécrit sans ressaisie.

Le suivi de charge arrête de dépendre d'un fichier partagé. Le workflow appelle project.getall pour la liste des projets, puis project.getprojectstatusesofproject pour savoir où chacun en est. Les lignes partent en récapitulatif avec Gmail tous les lundis matin, sans que personne ouvre l'outil.

Un devis signé ouvre le projet en entier. company.create crée le compte client et renvoie son identifiant, project.post l'utilise dans Company ID avec un Project Template ID, et project.posttasklist pose la première liste de tâches. Le squelette de la mission existe avant la réunion de lancement.

Les tickets techniques restent lisibles des deux côtés. Quand une équipe produit travaille dans Jira Software ou dans ClickUp pendant que la gestion de projet vit dans awork, projecttask.gettasksofproject et les opérations de statut permettent de garder les deux vues alignées sans double saisie.

Si l'endpoint dont tu as besoin manque au nœud, le nœud HTTP Request appelle directement l'API awork et réutilise le même credential via l'authentification prédéfinie. C'est la porte de sortie pour tout ce qui sort des 37 opérations listées plus bas.

Deux limites à connaître avant de commencer. Le nœud est en version 1, et le paquet communautaire ne s'installe que sur une instance auto-hébergée, puisque n8n Cloud n'accepte que les nœuds communautaires vérifiés. Le trigger n'a pas non plus d'option pour tout écouter d'un coup : chaque événement utile se coche à la main. Pour arbitrer l'hébergement, Avis n8n détaille le sujet, et la Formation n8n reprend la logique des credentials depuis le début.

Connexion

Comment connecter awork à n8n ?

  1. 01

    Installer le paquet communautaire

    Ouvre Settings, va dans Community nodes et installe n8n-nodes-awork (version 0.1.62). Le nœud awork et le awork Trigger apparaissent dans le panneau des nœuds au redémarrage de l'instance. Cette étape ne fonctionne que sur un n8n auto-hébergé, installé via Docker ou npm, parce que n8n Cloud n'accepte que les nœuds communautaires vérifiés. Le paquet ne coûte rien côté n8n.

  2. 02

    Créer le credential awork

    Direction le menu Credentials pour créer le credential awork une seule fois. Un credential, c'est le jeu de clés que n8n conserve pour appeler l'API à ta place ; il se réutilise dans tous les workflows de l'instance, donc aucune clé ne se colle dans un nœud. Donne-lui un nom qui dit à quel espace de travail awork il pointe, sinon une équipe qui garde un bac à sable et une production s'y perd vite.

  3. 03

    Sélectionner le credential dans le nœud

    Pose un nœud awork sur le canevas et choisis le credential dans sa liste déroulante. Sélectionne une ressource, puis une opération, et lance le nœud une fois sur une lecture comme project.getall. Une lecture ne modifie rien et prouve que la connexion tient avant qu'une écriture touche de vraies données. Le même credential se branche sur le awork Trigger quand le workflow doit démarrer sur un événement plutôt que sur un horaire.

Déclencheurs

Qu'est-ce qui déclenche un workflow awork ?

awork Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans awork. Il écoute 35 événements, listés ci-dessous par famille. Tu en choisis un ou plusieurs, tu actives le workflow : n8n enregistre le webhook (l'URL que awork appelle) sur ton compte.

Ce que tu vois dans n8n

Tous les événements, par famille

Une ligne par objet, une puce par action. L'événement à cocher dans le nœud s'écrit objet.action ; survole une puce pour lire quand il se déclenche.

absence_added.*1
  • absence_added.
    • absence_added
absence_deleted.*1
  • absence_deleted.
    • absence_deleted
absence_updated.*1
  • absence_updated.
    • absence_updated
company_added.*1
  • company_added.
    • company_added
company_deleted.*1
  • company_deleted.
    • company_deleted
company_type_changed.*1
  • company_type_changed.
    • company_type_changed
company_updated.*1
  • company_updated.
    • company_updated
project_added.*1
  • project_added.
    • project_added
project_comment_added.*1
  • project_comment_added.
    • project_comment_added
project_deleted.*1
  • project_deleted.
    • project_deleted
project_status_changed.*1
  • project_status_changed.
    • project_status_changed
project_type_changed.*1
  • project_type_changed.
    • project_type_changed
project_updated.*1
  • project_updated.
    • project_updated
projectmember_added.*1
  • projectmember_added.
    • projectmember_added
projectmember_deleted.*1
  • projectmember_deleted.
    • projectmember_deleted
task_added.*1
  • task_added.
    • task_added
task_comment_added.*1
  • task_comment_added.
    • task_comment_added
task_deleted.*1
  • task_deleted.
    • task_deleted
task_status_changed.*1
  • task_status_changed.
    • task_status_changed
task_type_changed.*1
  • task_type_changed.
    • task_type_changed
task_updated.*1
  • task_updated.
    • task_updated
taskassignment_added.*1
  • taskassignment_added.
    • taskassignment_added
taskassignment_deleted.*1
  • taskassignment_deleted.
    • taskassignment_deleted
tasklist_added.*1
  • tasklist_added.
    • tasklist_added
tasklist_deleted.*1
  • tasklist_deleted.
    • tasklist_deleted
tasklist_updated.*1
  • tasklist_updated.
    • tasklist_updated
timetracking_added.*1
  • timetracking_added.
    • timetracking_added
timetracking_deleted.*1
  • timetracking_deleted.
    • timetracking_deleted
timetracking_type_changed.*1
  • timetracking_type_changed.
    • timetracking_type_changed
timetracking_updated.*1
  • timetracking_updated.
    • timetracking_updated
user_activation_changed.*1
  • user_activation_changed.
    • user_activation_changed
user_added.*1
  • user_added.
    • user_added
user_deleted.*1
  • user_deleted.
    • user_deleted
user_status_changed.*1
  • user_status_changed.
    • user_status_changed
user_updated.*1
  • user_updated.
    • user_updated

Notes de configuration

01Set up the awork TriggerLe awork Trigger démarre un workflow quand quelque chose se passe dans awork. Il fonctionne par webhook, c'est-à-dire une URL que awork appelle, au lieu que n8n aille demander en boucle. Chaque événement arrive en quelques secondes. Il utilise le même credential que le nœud awork, donc rien de plus à configurer une fois le paquet communautaire installé.

Le awork Trigger démarre un workflow quand quelque chose se passe dans awork. Il fonctionne par webhook, c'est-à-dire une URL que awork appelle, au lieu que n8n aille demander en boucle. Chaque événement arrive en quelques secondes. Il utilise le même credential que le nœud awork, donc rien de plus à configurer une fois le paquet communautaire installé.

Paramètres clés

  • Events : la liste des événements écoutés, 35 au total en version 1 du trigger. Aucune option pour tout prendre d'un coup, donc coche un par un ceux qui t'intéressent. Les entreprises et les utilisateurs ont aussi les leurs, de company_added et company_type_changed jusqu'à user_added et user_activation_changed.
Quand l'utiliser
dès que le workflow doit réagir au travail réel plutôt que tourner à heure fixe. Le webhook s'enregistre auprès de awork à l'activation du workflow : laissé en brouillon, le trigger ne reçoit strictement rien.
02Project eventsCôté projet, six événements : project_added, project_updated, project_status_changed, project_type_changed, project_deleted et project_comment_added. Les membres ont leur paire, projectmember_added et projectmember_deleted. Les entreprises suivent le même schéma avec company_added, company_updated, company_type_changed et company_deleted.

Côté projet, six événements : project_added, project_updated, project_status_changed, project_type_changed, project_deleted et project_comment_added. Les membres ont leur paire, projectmember_added et projectmember_deleted. Les entreprises suivent le même schéma avec company_added, company_updated, company_type_changed et company_deleted.

Cas d'usage
project_added sert de point de départ propre à un workflow d'onboarding, le projet existant déjà quand n8n le reçoit, et le nœud suivant peut lui poser ses listes de tâches et ses statuts. project_status_changed convient au reporting de direction : un projet qui bascule en retard remonte tout de suite, pas au comité du jeudi. projectmember_added sert à la gestion des accès, pour donner à un nouvel arrivant ce dont il a besoin le jour même. Et project_comment_added attrape les échanges écrits au niveau du projet, pas sur une tâche.
03Time tracking eventsQuatre événements suivent les temps saisis : timetracking_added, timetracking_updated, timetracking_type_changed et timetracking_deleted. Les absences ont leur trio avec absence_added, absence_updated et absence_deleted. Les utilisateurs sont juste à côté, avec user_added, user_updated, user_status_changed, user_activation_changed et user_deleted.

Quatre événements suivent les temps saisis : timetracking_added, timetracking_updated, timetracking_type_changed et timetracking_deleted. Les absences ont leur trio avec absence_added, absence_updated et absence_deleted. Les utilisateurs sont juste à côté, avec user_added, user_updated, user_status_changed, user_activation_changed et user_deleted.

Cas d'usage
pour une agence qui facture à l'heure, timetracking_added alimente un cumul par projet au fil de la saisie, au lieu d'une course en fin de mois. timetracking_updated et timetracking_deleted comptent autant, parce qu'un cumul construit sur les seuls ajouts s'éloigne du réel dès la première correction. absence_added prévient un chef de projet qu'une personne engagée sur une échéance sera absente. Et user_activation_changed marque le départ d'un compte, moment idéal pour couper les accès ailleurs. Les mises à jour d'absence méritent la même attention dès que le planning en dépend, sinon un congé déplacé passe inaperçu jusqu'à la veille de la livraison.
04Task eventsLa vie d'une tâche tient en six événements : task_added, task_updated, task_status_changed, task_type_changed, task_deleted et task_comment_added. L'affectation est à part, avec taskassignment_added et taskassignment_deleted. Les listes de tâches suivent la même logique : tasklist_added, tasklist_updated et tasklist_deleted.

La vie d'une tâche tient en six événements : task_added, task_updated, task_status_changed, task_type_changed, task_deleted et task_comment_added. L'affectation est à part, avec taskassignment_added et taskassignment_deleted. Les listes de tâches suivent la même logique : tasklist_added, tasklist_updated et tasklist_deleted.

Cas d'usage
une tâche qui passe en terminé déclenche task_status_changed, et le workflow peut lire le projet concerné pour prévenir le demandeur. Un commentaire déclenche task_comment_added, pratique pour router un retour client vers une file de relecture avant que quiconque rouvre le tableau. taskassignment_added se coche quand chacun doit recevoir son travail dans sa propre boîte plutôt que le découvrir au point du matin. Reste sélectif : un workflow abonné à tous les événements de tâche s'exécute aussi sur des mises à jour qui ne l'intéressent pas.
Actions

Qu'est-ce que le nœud awork sait faire ?

Le nœud awork expose 37 opérations sur 5 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

Matrice ressources × opérations
RessourceCreate CompanyGet Company by IDDelete DocumentAdd TagChange Project StatusChange StatusAdd CommentGet All CompaniesGet CommentsGet Document ContentGet Documents of Document SpaceGet Documents of ProjectGet All Project StatusesGet Project Statuses of ProjectGet Task Lists of ProjectGet Task Lists of ProjectGet Tasks of ProjectGet Task Statuses of ProjectGet Types of WorkCreate ProjectAdd Task to Task ListCreate Project StatusCreate Task ListCreate Task StatusCreate Type of WorkSet Task AssigneeSet Custom Field
Company✓✓✓
Document✓✓✓✓✓✓✓
Project✓✓✓✓✓✓✓✓✓✓✓✓
Project Task✓✓✓✓✓✓✓✓✓✓✓✓✓
User✓✓

Company

3 opérations
01

Create a company

company.create

Ce que tu vois dans n8n

Notes & cas d'usage

Crée une entreprise dans awork et renvoie son identifiant, que les opérations de projet réutilisent ensuite.

Paramètres clés

  • Company Name : le nom de l'entreprise, souvent {{ $json.companyName }} repris du formulaire ou du CRM placé avant. Vide, le nœud s'arrête.
  • Company Description : du texte libre, l'endroit idéal pour le contexte noté par le commercial.
  • Company Industry : le secteur d'activité, utile quand le reporting ventile les clients par secteur.
Cas d'usage
une affaire se signe, le compte existe dans awork avant que quiconque ouvre l'outil.
02

Get companies

company.getall

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les entreprises de l'espace de travail, un item par entreprise, prêt pour une boucle ou une recherche.

Paramètres clés

  • Return All : activé, n8n enchaîne les pages de l'API et ramène la liste client complète ; désactivé, Limit plafonne le nombre d'entreprises.
  • Filter By : restreint le résultat selon des critères, dans la syntaxe de filtrage documentée par awork.
  • Order By : trie sur un champ et une direction, pratique pour sortir une liste déjà classée.
Cas d'usage
reconstruire un annuaire clients hors de awork, ou rattacher un domaine e-mail entrant à un compte existant.
03

Get company by id

company.get

Ce que tu vois dans n8n

Notes & cas d'usage

Va chercher une entreprise à partir de son identifiant et la renvoie en un seul item.

Paramètres clés

  • Company ID : l'identifiant de l'entreprise, pas son nom. Il vient en général d'un nœud précédent sous la forme {{ $json.id }}, ou du Company ID porté par un projet.
Cas d'usage
un projet arrive dans le workflow sans les coordonnées du client, cette opération les complète avant l'envoi du message. Elle enrichit aussi une demande de support avec le compte auquel elle se rattache.

Document

7 opérations
04

Get all documents

document.getall

Ce que tu vois dans n8n

Notes & cas d'usage

Liste les documents de l'espace de travail sans rien demander en entrée, un item par document.

Cas d'usage
un inventaire trimestriel de ce que l'équipe a écrit, déversé dans un tableur pour repérer les pages que personne n'a rouvertes depuis la dernière mission. La même liste sert de première étape à une migration, où elle alimente une boucle qui lit chaque document avant de l'écrire ailleurs.
05

Get document by id

document.get

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère un document précis à partir de son identifiant, avec ses propriétés et non son corps de texte.

Paramètres clés

  • Document ID : l'identifiant du document, typiquement {{ $json.id }} transmis par une opération de listing.
Cas d'usage
vérifier le nom et l'emplacement d'un document avant de décider si le workflow le copie, l'archive ou n'y touche pas. Bonne étape de garde devant une opération qui écrit.
06

Get document content

document.getcontent

Ce que tu vois dans n8n

Notes & cas d'usage

Sort le contenu HTML d'un document, ce qu'il faut quand c'est le texte lui-même qui doit voyager.

Paramètres clés

  • Document ID : l'identifiant du document dont tu veux le corps. Enchaîne-le après une opération de listing pour ne jamais coder un identifiant en dur.
Cas d'usage
un brief de projet écrit dans awork est republié dans une base de connaissance, ou passé à un modèle de langage qui rédige le résumé envoyé au client. Le corps arrive en HTML, donc convertis-le si la destination attend du texte brut.
07

Get documents of a document space

document.getdocumentsofdocumentspace

Ce que tu vois dans n8n

Notes & cas d'usage

Limite le listing des documents à un seul espace documentaire plutôt qu'à l'ensemble de l'espace de travail.

Paramètres clés

  • Document Space ID : l'identifiant de l'espace documentaire à lire. Un espace par service ou par client garde des volumes tenables.
Cas d'usage
une synchro nocturne qui ne recopie que l'espace des procédures internes et laisse le matériel client tranquille. C'est aussi le chemin le plus court pour retrouver un document quand tu sais déjà dans quel espace il vit.
08

Get documents of a project

document.getdocumentsofproject

Ce que tu vois dans n8n

Notes & cas d'usage

Énumère ce qu'un projet donné contient comme documents, un item par document.

Paramètres clés

  • Project ID : l'identifiant du projet, souvent {{ $json.projectId }} repris d'un événement du trigger sur ce projet.
Cas d'usage
clôturer une mission en expédiant tous les livrables d'un coup, ou contrôler qu'un projet ouvert la semaine dernière a bien son brief attaché avant la réunion de lancement. La liste sert aussi de base à une revue documentaire par mission.
09

Create a document

document.create

Ce que tu vois dans n8n

Notes & cas d'usage

Écrit un nouveau document dans awork, soit dans un espace documentaire, soit à l'intérieur d'un projet.

Paramètres clés

  • Document Name : le nom du document, requis.
  • Document Space ID ou Project ID : l'un des deux doit être fourni, et ce choix décide de l'endroit où la page atterrit.
  • Document Content : le corps du document, en HTML.
  • Emoji : l'icône affichée à côté du document.
  • Parent Document ID : un autre document du même projet ou espace, pour imbriquer celui-ci dessous.
Cas d'usage
générer le compte rendu juste après la réunion.
10

Delete a document

document.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime un document de awork, donc garde cette opération derrière une condition plutôt que sur une liste brute.

Paramètres clés

  • Document ID : l'identifiant du document à supprimer. Lis-le d'abord avec une opération de lecture si le workflow doit tracer ce qui disparaît.
Cas d'usage
nettoyer les brouillons qu'un générateur a créés pendant un test, ou vider les documents temporaires une fois leur contenu recopié à sa place définitive.

Project

12 opérations
11

Get projects

project.getall

Ce que tu vois dans n8n

Notes & cas d'usage

Ramène les projets de l'espace de travail, un item par projet, la colonne vertébrale de la plupart des workflows de reporting.

Paramètres clés

  • Return All : activé, toutes les pages de projets remontent ; désactivé, Limit fixe le nombre.
  • Filter By : ne garde que les projets qui répondent aux critères, dans la syntaxe de filtrage de awork.
  • Order By : trie sur un champ et une direction, utile pour faire remonter les projets les plus anciens.
Cas d'usage
le récapitulatif du lundi sur les missions en cours.
12

Get project by id

project.get

Ce que tu vois dans n8n

Notes & cas d'usage

Lit un projet à partir de son identifiant et le renvoie en un item unique.

Paramètres clés

  • Project ID : l'identifiant du projet, rarement saisi à la main. Un événement du trigger sur une tâche porte le projet auquel elle appartient, et cette valeur se branche ici directement.
Cas d'usage
une tâche change de statut et la notification a besoin du nom du projet, pas d'un identifiant illisible : l'opération se glisse entre le trigger et le nœud de message.
13

Get all project statuses

project.getprojectstatuses

Ce que tu vois dans n8n

Notes & cas d'usage

Énumère les statuts de projet définis dans l'espace de travail, la façon d'apprendre les identifiants qu'attendent les opérations d'écriture.

Paramètres clés

  • Return All : activé pour l'ensemble des statuts ; désactivé, Limit tronque la liste.
  • Filter By : restreint les statuts renvoyés selon des critères.
  • Order By : trie les statuts sur un champ et une direction.
Cas d'usage
la lancer une fois à la configuration pour associer noms et identifiants, puis stocker cette table pour que les workflows suivants résolvent l'un depuis l'autre.
14

Get project statuses of project by id

project.getprojectstatusesofproject

Ce que tu vois dans n8n

Notes & cas d'usage

Resserre le listing des statuts sur un seul projet au lieu de tout l'espace de travail.

Paramètres clés

  • Project ID : le projet dont tu veux les statuts.
  • Return All : activé pour enchaîner les pages, désactivé pour s'arrêter à Limit.
  • Filter By : filtre les statuts renvoyés selon des critères.
  • Order By : les trie sur un champ et une direction.
Cas d'usage
retrouver le bon identifiant de statut avant d'appeler une opération de changement sur ce même projet, pour que le workflow ne devine rien.
15

Create a project

project.post

Ce que tu vois dans n8n

Notes & cas d'usage

Crée un projet en envoyant ses détails, et renvoie l'objet auquel s'accrochera le reste du workflow.

Paramètres clés

  • Project Name : requis, le seul champ sur lequel l'opération insiste.
  • Company ID : rattache le projet à un compte client.
  • Start Date et Due Date : les dates qui encadrent la mission.
  • Project Template ID : réutilise un modèle existant au lieu de refaire la structure.
  • Project Type ID, Project Status ID, Project Description : typage, état de départ et contexte.
Cas d'usage
ouvrir la mission dès qu'un devis est accepté.
16

Get task statuses of project by id

project.gettaskstatuses

Ce que tu vois dans n8n

Notes & cas d'usage

Lit les statuts de tâche configurés sur un projet, chaque projet pouvant tenir son propre tableau.

Paramètres clés

  • Project ID : le projet dont tu lis les statuts de tâche.
  • Return All : activé pour tous les statuts, désactivé pour plafonner à Limit.
  • Filter By et Order By : filtrent selon des critères et trient sur un champ avec une direction.
Cas d'usage
trouver l'identifiant de la colonne terminé avant qu'un workflow y déplace les tâches finies tout seul.
17

Get task lists of project by id

project.gettasklists

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les listes de tâches qui structurent un projet, autrement dit les sections auxquelles une tâche peut appartenir.

Paramètres clés

  • Project ID : le projet à inspecter. Alimente-le depuis un événement du trigger ou depuis une opération de listing en amont.
Cas d'usage
vérifier qu'une phase n'existe pas déjà avant de la recréer, et choisir la liste dans laquelle ranger une nouvelle tâche quand plusieurs chantiers tournent en parallèle sur le même projet.
18

Create a project status

project.postprojectstatus

Ce que tu vois dans n8n

Notes & cas d'usage

Ajoute un statut de projet en envoyant ses détails, pour que le suivi colle à la façon de travailler de l'équipe.

Paramètres clés

  • Project ID : le projet qui reçoit le nouveau statut.
  • Status Name : requis, le nom du statut.
  • Status Type : requis, la catégorie à laquelle il appartient.
Cas d'usage
un workflow de provisionnement qui ajoute un statut en attente client sur chaque projet d'un type donné, au lieu de le recréer à la main sur chaque nouvelle mission.
19

Change the project status

project.changeprojectstatus

Ce que tu vois dans n8n

Notes & cas d'usage

Bascule un projet sur un autre statut, la contrepartie en écriture des opérations de listing des statuts.

Paramètres clés

  • Project ID : le projet à déplacer.
  • Project Status ID : requis, et c'est un identifiant, pas le libellé affiché dans l'interface. Résous-le d'abord avec le listing des statuts de projet.
Cas d'usage
la dernière tâche d'un projet passe en terminé, le workflow attrape l'événement et fait basculer le projet en livré sans attendre la revue hebdomadaire.
20

Create a task status

project.posttaskstatus

Ce que tu vois dans n8n

Notes & cas d'usage

Ajoute une colonne au tableau de tâches d'un projet en envoyant les détails du statut.

Paramètres clés

  • Project ID : le projet dont le tableau s'agrandit.
  • Status Name : requis, le libellé de la colonne.
  • Status Type : requis, la catégorie dont elle relève.
  • Task Status Icon : requis également, l'icône affichée sur le statut.
Cas d'usage
un workflow modèle qui reconstruit les mêmes colonnes sur chaque projet client, pour que deux équipes ne se retrouvent pas avec des tableaux qui ne se lisent pas pareil.
21

Create a task list

project.posttasklist

Ce que tu vois dans n8n

Notes & cas d'usage

Crée une liste de tâches dans un projet, le contenant qui regroupe les tâches.

Paramètres clés

  • Project ID : l'endroit où la liste est créée.
  • Name : requis, le nom de cette entité. Construis-le depuis les données en amont, par exemple un libellé de sprint ou un mois.
Cas d'usage
ouvrir une liste neuve au début de chaque sprint, puis y ranger les tâches entrantes pour que le projet garde un historique lisible au lieu d'un backlog sans fin.
22

Get comments of project

project.getcomments

Ce que tu vois dans n8n

Notes & cas d'usage

Collecte les commentaires laissés sur un projet, un item par commentaire, sans aucun paramètre à remplir.

Cas d'usage
archiver la discussion d'un projet à côté de ses documents à la clôture de la mission, pour que le fil survive hors de awork. La même lecture alimente un résumé de ce qui s'est dit dans la semaine, format qui convient à un client qui n'ouvre jamais l'outil mais veut suivre les échanges.

Project Task

13 opérations
23

Get tasks of a project

projecttask.gettasksofproject

Ce que tu vois dans n8n

Notes & cas d'usage

Liste les tâches rattachées à un projet, un item par tâche, la lecture par laquelle commencent la plupart des workflows de suivi.

Paramètres clés

  • Project ID : requis, l'identifiant du projet, souvent {{ $json.projectId }} repris d'un nœud précédent.
  • Return All : activé, n8n enchaîne toutes les pages de tâches ; désactivé, Limit fixe le nombre de tâches renvoyées.
  • Filter By : ne garde que les tâches qui répondent à un critère, dans la syntaxe de filtrage d'awork.
  • Order By : trie sur un champ et une direction, par date d'échéance par exemple.
Cas d'usage
un tableau de charge reconstruit chaque matin, qui montre à l'équipe ce qui reste ouvert sur une mission avant le point de dix heures.
24

Get task by id

projecttask.get

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère une seule tâche depuis son identifiant, avec la totalité des données que les nœuds suivants vont lire.

Paramètres clés

  • Task ID : requis, l'identifiant de la tâche à récupérer, en général {{ $json.id }} issu d'un événement de tâche.
Cas d'usage
un événement signale qu'une tâche a bougé, le workflow relit la tâche pour obtenir les champs que l'événement ne transporte pas, puis décide si quelqu'un doit être prévenu.
25

Create a project task

projecttask.post

Ce que tu vois dans n8n

Notes & cas d'usage

Envoie les détails d'une tâche et l'ouvre dans un projet.

Paramètres clés

  • Project ID : requis, le projet qui reçoit la tâche.
  • Task Name : requis, le nom de la tâche.
  • Task Description : le texte long, pratique quand la demande arrive d'un formulaire.
  • Type of Work ID et Task Status ID : des identifiants, pas des libellés, donc à lire d'abord avec les opérations de listing.
  • Due Date : une date et heure.
  • Planned Duration : un nombre, exprimé en secondes.
Cas d'usage
transformer une demande entrante en tâche déjà rangée dans le bon projet.
26

Set a custom field

projecttask.settaskcustomfield

Ce que tu vois dans n8n

Notes & cas d'usage

Écrit une valeur dans un champ personnalisé d'une tâche, pour les données qui n'ont pas de champ standard dans awork.

Paramètres clés

  • Task ID : requis, l'identifiant de la tâche à récupérer.
  • Text Value : la valeur texte du champ personnalisé.
  • Custom Field Definition ID : l'identifiant de la définition du champ, celui qui désigne quel champ est rempli.
Cas d'usage
reporter sur la tâche la référence d'une pièce comptable, pour rapprocher les deux outils plus tard sans que personne ne ressaisisse un numéro.
27

Add tag

projecttask.addtag

Ce que tu vois dans n8n

Notes & cas d'usage

Pose une étiquette sur une tâche, la façon la plus légère de classer du travail sans toucher à son statut.

Paramètres clés

  • Task ID : requis, l'identifiant de la tâche à récupérer.
  • Tag Name : le nom de l'étiquette, qui circule en texte ; fixe une orthographe avant que le workflow n'en écrive des centaines.
Cas d'usage
marquer chaque tâche née d'un client récurrent, pour qu'un tableau filtré isole ce compte du reste de l'activité.
28

Change status

projecttask.changestatus

Ce que tu vois dans n8n

Notes & cas d'usage

Fait passer une tâche sur un autre statut, la contrepartie en écriture des listings de statuts de tâche.

Paramètres clés

  • Task ID : requis, l'identifiant de la tâche à récupérer.
  • Status ID : l'identifiant du statut, pas le nom de la colonne, donc lis d'abord les statuts de tâche du projet.
Cas d'usage
une mise en production se termine dans un outil de build, le workflow clôt la tâche correspondante, et personne n'a plus à déplacer une carte en fin de journée.
29

Add comment

projecttask.comments

Ce que tu vois dans n8n

Notes & cas d'usage

Publie un commentaire sur une tâche, pour que la partie automatisée du processus laisse une trace là où l'équipe lit déjà.

Paramètres clés

  • Task ID : requis, l'identifiant de la tâche à récupérer.
  • Comment Message : le message du commentaire, qui se construit avec les données du nœud précédent.
Cas d'usage
écrire le résultat d'un contrôle externe sur la tâche elle-même plutôt que d'envoyer un message de plus, que personne ne relie ensuite au travail concerné.
30

Set a task assignee

projecttask.settaskassignee

Ce que tu vois dans n8n

Notes & cas d'usage

Confie une tâche à une personne, ce qui transforme un item sans propriétaire en travail attribué.

Paramètres clés

  • Task ID : requis, l'identifiant de la tâche à récupérer.
  • User ID : l'identifiant de l'utilisateur, résolu avant avec l'opération de listing des utilisateurs, car une adresse e-mail ne suffit pas.
Cas d'usage
une rotation tenue hors d'awork désigne qui prend les tâches entrantes cette semaine, et le workflow les attribue au fil de leur création.
31

Get types of work

projecttask.gettypesofwork

Ce que tu vois dans n8n

Notes & cas d'usage

Lit les types de travail configurés sur le compte, avec leurs identifiants.

Paramètres clés

  • Return All : activé, tous les types de travail remontent ; désactivé, Limit arrête la liste.
  • Filter By : restreint les types sur un critère, dans la syntaxe de filtrage d'awork.
  • Order By : les ordonne sur un champ et une direction.
Cas d'usage
résoudre le Type of Work ID une fois en début de workflow au lieu de figer un identifiant qui tombe le jour où quelqu'un réorganise le paramétrage.
32

Get task lists of a project

projecttask.gettasklistsofproject

Ce que tu vois dans n8n

Notes & cas d'usage

Côté ressource tâche, cette lecture rapporte les listes de tâches d'un projet avec les contrôles de pagination que la lecture côté projet n'offre pas.

Paramètres clés

  • Project ID : requis, l'identifiant du projet.
  • Return All : activé pour l'ensemble des listes, désactivé pour s'arrêter à Limit.
  • Filter By : réduit les listes sur un critère.
  • Order By : les trie sur un champ et une direction.
Cas d'usage
retrouver la liste du sprint en cours avant qu'un nœud suivant n'y range les nouvelles tâches.
33

Create a type of work

projecttask.posttypeofwork

Ce que tu vois dans n8n

Notes & cas d'usage

Ajoute un type de travail au compte, la catégorie qui qualifie les tâches.

Paramètres clés

  • Name : requis, le nom de cette entité.
  • Icon : requis également, l'icône de cette entité.
  • Description : la description de cette entité, à remplir quand plusieurs équipes partagent le même paramétrage.
Cas d'usage
un workflow qui prépare une nouvelle offre de service et crée son type de travail une fois, pour que les tâches suivantes soient comptées dessus.
34

Add a task to a task list

projecttask.postaddtasktotasklist

Ce que tu vois dans n8n

Notes & cas d'usage

Range une tâche existante dans une liste de tâches du projet, sans rien créer de neuf.

Paramètres clés

  • Project ID : requis, l'identifiant du projet.
  • Task ID : requis, l'identifiant de la tâche à récupérer.
  • Task List ID : la liste vers laquelle déplacer la tâche, que le listing des listes te donne.
Cas d'usage
trier le vendredi les tâches arrivées dans la semaine, pour que le tableau redevienne un plan de charge et pas un tas.
35

Get comments of task

projecttask.getcomments

Ce que tu vois dans n8n

Notes & cas d'usage

Collecte les commentaires d'une tâche depuis son identifiant, un item par commentaire, avec l'auteur et le texte de chaque message.

Paramètres clés

  • Task ID : requis, l'identifiant de la tâche à récupérer.
Cas d'usage
rassembler les échanges d'une tâche avant sa clôture, puis les stocker avec le livrable pour que le raisonnement derrière une décision ne parte pas avec le tableau. La même lecture sert à repérer les demandes arrivées en commentaire plutôt que dans le brief initial.

User

2 opérations
36

Get users

user.getall

Ce que tu vois dans n8n

Notes & cas d'usage

Lit les utilisateurs du compte awork, la lecture qui permet à un workflow de transformer une personne en identifiant.

Paramètres clés

  • Return All : activé, tous les utilisateurs remontent page après page ; désactivé, Limit borne la liste.
  • Filter By : garde les utilisateurs qui répondent à un critère.
  • Order By : les trie sur un champ et une direction, par prénom par exemple.
Cas d'usage
monter une table de correspondance en début d'exécution, pour que les attributions plus bas ne dépendent jamais d'un nom saisi à la main.
37

Get user by id

user.get

Ce que tu vois dans n8n

Notes & cas d'usage

Lit un utilisateur depuis un identifiant et renvoie le profil enregistré dans awork, nom, statut et le reste de la fiche.

Paramètres clés

  • User ID : requis, l'identifiant de l'utilisateur à récupérer, souvent la valeur portée par un événement d'affectation.
Cas d'usage
un événement utilisateur arrive, le workflow lit le profil derrière et oriente le message vers le bon canal d'équipe plutôt que vers tout le monde. Ça sert aussi à écrire le nom d'un responsable dans un récapitulatif envoyé au client.
Besoin d'aide

Besoin d'aide pour automatiser awork avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

awork et n8n, les questions qui reviennent

01L'intégration awork n8n est-elle gratuite ?
Oui côté n8n, avec une condition. awork est un nœud communautaire : il n'est pas livré avec n8n, c'est le paquet npm n8n-nodes-awork, à installer depuis Settings puis Community nodes. Cette installation ne fonctionne que sur une instance auto-hébergée, lancée via Docker ou npm, parce que n8n Cloud n'accepte que les nœuds communautaires vérifiés. n8n ne facture rien pour le paquet, ni pour les 37 opérations, ni pour les 35 événements du trigger. Ce que coûte ton abonnement awork est un sujet distinct, qui se règle du côté de awork.
02Quels credentials faut-il pour connecter awork ?
Un credential awork, créé une seule fois dans le menu Credentials de n8n, puis réutilisé par tous les workflows de l'instance. Le nœud le propose dans une liste déroulante, donc aucune clé ne se colle dans un nœud ni ne se recopie d'un workflow à l'autre. Crée le credential avant de construire quoi que ce soit, lance une opération de lecture comme le listing des projets, et tu sais en quelques secondes si la connexion tient. Ce même credential sert aussi au nœud HTTP Request via l'authentification prédéfinie, ce qui compte dès que tu sors des opérations couvertes par le nœud.
03Quelles sont les limites du nœud awork dans n8n ?
Trois, à anticiper. Le nœud est en version 1 et couvre 37 opérations sur 5 ressources : tout ce qui sort de cette liste passe par le nœud HTTP Request, qui appelle directement l'API awork en réutilisant le même credential. Les listings s'arrêtent tôt si Return All reste désactivé, puisque c'est alors Limit qui décide du nombre d'items renvoyés, et un rapport se retrouve tronqué sans prévenir. Enfin, comme il s'agit d'un paquet communautaire, l'installation reste réservée au n8n auto-hébergé : un espace Cloud ne peut pas l'ajouter tant que le nœud n'a pas été vérifié.
04Le awork Trigger réagit-il en temps réel ?
Oui. Le awork Trigger fonctionne par webhook, c'est-à-dire une URL que awork appelle dès qu'il se passe quelque chose. n8n enregistre cette URL auprès de awork à l'activation du workflow, et chaque événement arrive en quelques secondes, sans aucune interrogation répétée. Deux conséquences concrètes. Un workflow laissé inactif ne reçoit rien, puisque le webhook ne s'enregistre qu'à l'activation. Et le paramètre Events n'offre pas d'option pour tout écouter d'un coup : parmi les 35 événements disponibles, tu coches un par un ceux que tu veux.
05n8n ou Make pour awork ?
Ça dépend de l'endroit où doivent vivre les données et de la façon dont tu veux payer. Make est hébergé par Make, sans option d'auto-hébergement, et se facture à l'opération : un workflow qui boucle sur tous les projets a donc un coût qui grimpe avec le volume. n8n tourne soit sur n8n Cloud, soit sur ton propre serveur via Docker ou npm, et le workflow se comporte pareil dans les deux cas. Cette option d'auto-hébergement est justement ce qui rend awork accessible ici, puisque le paquet communautaire s'installe sur ton instance. Les deux construisent les workflows visuellement : la vraie question porte sur l'hébergement, la maîtrise des données et le modèle de coût.