Le nœud n8n
n8n-nodes-nadia est le
nœud communautaire de UseNadia pour n8n. Le paquet contient
deux nœuds :
| Nœud | Ce qu’il fait |
|---|---|
| Nadia | Des actions : créer des publications, téléverser des médias, lister les canaux et les workspaces, lire les analyses, gérer le tableau de contenus. Un AI Agent peut aussi s’en servir comme outil. |
| Nadia Trigger | Lance un workflow sur post.published, comment.received, dm.received, automation.triggered ou automation.email_captured. Il enregistre lui-même son webhook : rien à régler dans l’app. |
Les deux s’appuient sur l’API publique. Tout ce que fait le nœud, un simple nœud HTTP Request le fait aussi ; le nœud vous épargne les en-têtes, les ID de canaux et les réglages propres à chaque plateforme.
Installation
Section intitulée « Installation »Dans n8n, Settings → Community Nodes → Install, puis saisissez
n8n-nodes-nadia et confirmez. Les nœuds Nadia et Nadia Trigger
apparaissent alors dans le panneau des nœuds.
Prérequis :
- Un n8n auto-hébergé où les nœuds communautaires sont activés (c’est le réglage par défaut). Sur n8n Cloud, seuls les nœuds communautaires vérifiés par n8n s’installent ; la vérification de celui-ci n’est pas encore faite.
- Pour qu’un AI Agent utilise le nœud Nadia comme outil, lancez n8n avec
N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true. Sans cette variable, les nœuds communautaires ne sont pas proposés comme outils.
Le paquet n’a aucune dépendance à l’exécution.
L’identifiant
Section intitulée « L’identifiant »Créez un identifiant (credential) Nadia API :
| Champ | Valeur |
|---|---|
| API Key | Votre clé, dans Paramètres → API & MCP sur UseNadia. Un jeton OAuth (pos_…) marche aussi. |
| Host | https://app.usenadia.com/api |
L’enregistrement de l’identifiant le teste : n8n appelle
GET /public/v1/is-connected avec la clé. Un échec à cette étape veut dire
une mauvaise clé, ou un hôte sans /api.
La clé part telle quelle dans l’en-tête Authorization, pas comme jeton
Bearer. Cela ne compte que si vous appelez l’API vous-même à côté du nœud.
Régénérer la clé dans Paramètres → API & MCP invalide l’ancienne
immédiatement : mettez l’identifiant à jour dans la foulée.
Le nœud Nadia
Section intitulée « Le nœud Nadia »Un seul nœud, une seule liste Operation :
| Domaine | Opération | Ce qu’elle fait | Endpoint |
|---|---|---|---|
| Publications | Create Post | Planifie une publication, la publie tout de suite ou l’enregistre en brouillon | POST /posts |
| Get Posts | Les publications d’une période (par défaut : les 30 derniers jours), éventuellement d’un seul canal ou d’un seul workspace | GET /posts |
|
| Delete Post | Supprime une publication par son ID | DELETE /posts/:id |
|
| Find Free Slot | Le prochain créneau libre d’un canal | GET /find-slot/:id |
|
| Médias | Upload File | Téléverse un binaire venu d’un nœud précédent (champ data par défaut) |
POST /upload |
| Upload File From URL | Fait récupérer et stocker une URL publique par UseNadia | POST /upload-from-url |
|
| Canaux | Get Channels | Vos canaux connectés | GET /integrations |
| Get Workspaces | Vos workspaces, chacun avec les ID de ses canaux | GET /workspaces |
|
| Get Channel Settings | Les réglages qu’attend la plateforme d’un canal | GET /integration-settings/:id |
|
| Analyses | Get Analytics | Les chiffres d’un canal sur les N derniers jours (30 par défaut) | GET /analytics/:id |
| Tableau de contenus | Create Card | Ajoute une carte dans une colonne (Idea par défaut) | POST /contents |
| Get Cards | Les cartes, éventuellement d’une seule colonne | GET /contents |
|
| Move Card | Déplace une carte vers une autre colonne | PUT /contents/:id/move |
|
| Update Card | Modifie le titre, le hook, le script, les notes, la date prévue ou les canaux visés d’une carte | PUT /contents/:id |
Les endpoints sont relatifs à <Host>/public/v1. Dans le nœud, les colonnes
du tableau s’appellent Idea, Script, Approved, To Shoot,
To Edit, To Schedule et Published (dans l’app : Idée, Script,
Validé, À tourner, À monter, À programmer, Publié) : voir
Contenus.
Canaux et workspaces sont des listes
Section intitulée « Canaux et workspaces sont des listes »Vous ne collez jamais un ID. Channel se charge depuis votre compte ; choisir d’abord un Workspace le restreint aux canaux de ce workspace (un canal appartient à un seul workspace), et Get Posts filtre par workspace de la même façon. Une expression marche toujours là où le workflow calcule l’ID.
Opération Get Workspaces et champ Workspace à partir de la version 0.2.0 du nœud ; les versions 0.1.x disaient Get Brands et Brand : un workflow créé avec elles doit choisir son workspace à nouveau.
Créer une publication
Section intitulée « Créer une publication »- Type : Schedule (à la Date), Now ou Draft. Avec Schedule, Use Next Free Slot remplace la date par le prochain créneau libre du canal.
- Content : le texte brut est mis en paragraphes ; le HTML passe tel quel et le serveur le nettoie.
- Media : la sortie d’un nœud Upload File ou Upload File From URL.
Chaque entrée doit avoir un
idet unpath; le nœud refuse des id seuls plutôt que de planifier une publication sans son image. - Channel Settings : ce qu’exige la plateforme (TikTok, à lui seul, a huit réglages obligatoires). Le nœud les lit dans l’API pour le canal choisi et les affiche comme des champs : ils suivent l’app sans nouvelle version du nœud. Détail par plateforme : Instagram, TikTok.
- Additional Fields : Group (le même contenu sur plusieurs canaux), Shorten Links, Tags (séparés par des virgules).
Comme outil d’un AI Agent
Section intitulée « Comme outil d’un AI Agent »Le nœud est déclaré utilisable comme outil : branchez-le sur l’entrée Tools d’un nœud AI Agent, et l’agent choisit lui-même l’opération. Il faut pour cela la variable d’environnement de l’installation.
Le nœud Nadia Trigger
Section intitulée « Le nœud Nadia Trigger »Choisissez les Events et, si besoin, les Channels (vide veut dire tous) :
| Événement | Quand |
|---|---|
post.published |
Une publication est sortie sur un canal |
comment.received |
Un commentaire est arrivé sous une publication d’un canal connecté |
dm.received |
Un message direct est arrivé sur un canal connecté |
automation.triggered |
Un commentaire a déclenché une automatisation et la réponse est partie |
automation.email_captured |
Une automatisation a enregistré l’adresse e-mail de la personne avec qui elle échange |
L’enregistrement est automatique
Section intitulée « L’enregistrement est automatique »À l’activation du workflow, le trigger enregistre un webhook sur votre
compte (POST /public/v1/webhooks, nommé n8n — <workflow name>) et garde
le secret de signature que renvoie UseNadia. À la désactivation, il supprime
le webhook. Un webhook supprimé à la main dans Paramètres → Webhooks est
réenregistré à la prochaine activation du workflow.
La signature
Section intitulée « La signature »Chaque livraison porte quatre en-têtes :
| En-tête | Contenu |
|---|---|
X-Nadia-Event |
Le nom de l’événement |
X-Nadia-Delivery |
L’ID de la livraison, pour dédoublonner |
X-Nadia-Timestamp |
Les secondes Unix au moment de l’envoi |
X-Nadia-Signature |
sha256= suivi du HMAC-SHA256 hexadécimal de <timestamp>.<raw body>, avec le secret pour clé |
Le trigger la vérifie par défaut et rejette une livraison qui ne correspond pas. Ne désactivez Verify Signature que si un intermédiaire devant n8n réécrit le corps. C’est la signature de l’horodatage avec le corps qui empêche de rejouer une livraison interceptée.
Le contenu
Section intitulée « Le contenu »Chaque livraison a la même enveloppe ; le contenu de l’événement est sous
data :
{ "id": "0f5b2c1e-7d3a-4c2b-9e8f-123456789abc", "event": "automation.email_captured", "occurredAt": "2026-10-13T09:30:00.000Z", "organizationId": "…", "data": { "email": "marie@gmail.com", "keyword": "LIEN", "username": "marie", "commenterId": "17841400000000000", "personId": "1234567890123456", "automation": { "id": "…", "name": "AWS kit" }, "pose": { "id": "…" }, "runId": "…", "postId": "…", "mediaId": "18000000000000000", "integrationId": "…", "capturedAt": "2026-10-13T09:30:00.000Z" }}Dans une expression, lisez {{ $json.data.email }}, pas {{ $json.email }}.
Pour post.published, data porte la publication : son id, content,
publishDate, releaseURL (le lien sur la plateforme), link (le lien
court de la publication, celui donné à la programmation), state et son
integration (id, name, providerIdentifier, picture).
Une livraison est retentée jusqu’à trois fois, sauf quand le destinataire
répond un 4xx autre que 429.
Tester un webhook
Section intitulée « Tester un webhook »Paramètres → Webhooks a un bouton Envoyer un test. À partir de la
prochaine version, l’API devrait offrir la même chose avec
POST /public/v1/webhooks/:id/test, qui envoie une livraison de test à un
webhook enregistré. Avec n8n, le test le plus simple reste un vrai événement
pendant que le nœud trigger attend un événement de test.
Modèles de workflows
Section intitulée « Modèles de workflows »Quatre workflows prêts à importer sont gardés avec les sources du nœud :
| Workflow | Ce qu’il fait |
|---|---|
| RSS to scheduled post | Lit un flux toutes les heures, rédige une légende avec un modèle d’IA, planifie la publication au prochain créneau libre du canal |
| Published post to Slack | Nadia Trigger sur post.published → un message Slack par publication |
| DM to Google Sheets | Nadia Trigger sur dm.received → une ligne par DM reçu |
| TemplateFox image to post | Une ligne de tableur → un rendu d’image TemplateFox → téléversement → publication planifiée |
Pour en utiliser un, dans n8n : Workflows → Import from File, choisissez
le .json, puis :
-
Ajoutez l’identifiant Nadia
La clé API, et l’hôte
https://app.usenadia.com/api. -
Choisissez votre canal
Ouvrez le nœud Nadia et choisissez le canal dans la liste ; ses réglages se chargent juste après.
-
Ajoutez les autres identifiants
Slack, Google, le modèle d’IA : ce que le workflow utilise.
-
Activez-le en dernier
Un workflow construit sur Nadia Trigger enregistre son webhook à l’activation.
Auto-héberger UseNadia
Section intitulée « Auto-héberger UseNadia »Host est un champ de l’identifiant, pas une constante : pointez-le vers
votre propre serveur, en gardant le suffixe /api :
https://social.example.com/api, pas https://social.example.com. Le
trigger fonctionne de la même façon, à condition que votre serveur UseNadia
puisse joindre votre n8n.
Voir aussi
Section intitulée « Voir aussi »- Webhooks : les mêmes livraisons, créées à la main dans les Paramètres.
- API des webhooks : les routes qu’appelle le trigger.
- MCP : l’autre façon de laisser un agent piloter UseNadia.