Aller au contenu

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.

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.

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.

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.

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.

  • 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 id et un path ; 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).

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.

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’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.

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.

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.

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.

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 :

  1. Ajoutez l’identifiant Nadia

    La clé API, et l’hôte https://app.usenadia.com/api.

  2. Choisissez votre canal

    Ouvrez le nœud Nadia et choisissez le canal dans la liste ; ses réglages se chargent juste après.

  3. Ajoutez les autres identifiants

    Slack, Google, le modèle d’IA : ce que le workflow utilise.

  4. Activez-le en dernier

    Un workflow construit sur Nadia Trigger enregistre son webhook à l’activation.

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.

  • 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.