Comment utiliser l’intégration n8n de Postoria

L’intégration n8n de Postoria vous permet de créer des workflows de publication automatisée sur les réseaux sociaux dans n8n, sans appeler manuellement l’API publique de Postoria.

Le nœud communautaire officiel et vérifié de Postoria vous permet de lister les espaces de travail et les comptes sociaux, d’importer ou de téléverser des médias, de publier immédiatement, de programmer des publications, de les ajouter aux files d’attente, de lister les publications existantes, de vérifier leur statut et de les supprimer dans Postoria.

L’intégration est disponible avec les offres Pro et Agency.

Disponibilité actuelle

Le nœud officiel Postoria est disponible en tant que nœud communautaire vérifié dans n8n Cloud et n8n auto-hébergé.

Le nom du package est :

@postoria/n8n-nodes-postoria

  • n8n Cloud : recherchez Postoria directement dans le canevas du workflow et ajoutez le nœud à votre workflow.
  • n8n auto-hébergé : installez le package via Settings → Community Nodes, ou sélectionnez-le directement si votre version de n8n propose les nœuds communautaires vérifiés.

Sur certaines installations, vous devrez peut-être redémarrer l’instance n8n et activer Verified Community Nodes dans le panneau d’administration pour que le nœud apparaisse.

Avant de commencer

Vous devez disposer des éléments suivants :

  • Une offre Postoria Pro ou Agency active.
  • Une clé d’API publique Postoria.
  • Un accès à n8n Cloud ou à une instance n8n auto-hébergée.
  • Un compte n8n Owner ou Admin si vous devez installer ou activer des nœuds communautaires.

Le nœud Postoria se connecte directement à l’API publique de Postoria. Votre clé API est stockée dans le système de gestion des identifiants de n8n.

Ajouter le nœud Postoria à n8n

n8n Cloud

  1. Ouvrez un workflow.
  2. Cliquez pour ajouter un nœud.
  3. Recherchez Postoria.
  4. Sélectionnez le nœud Postoria vérifié et ajoutez-le au workflow.

Aucune installation manuelle de package npm n’est nécessaire.

n8n auto-hébergé

  1. Ouvrez votre instance n8n auto-hébergée.
  2. Accédez à Settings.
  3. Ouvrez Community Nodes.
  4. Cliquez sur Install.
  5. Saisissez le nom du package :

@postoria/n8n-nodes-postoria

  1. Confirmez que vous comprenez les risques liés à l’installation d’un package communautaire.
  2. Cliquez sur Install.

Après l’installation, recherchez Postoria dans le panneau des nœuds et ajoutez-le à un workflow comme tout autre nœud n8n.

Certains déploiements auto-hébergés peuvent nécessiter un redémarrage de n8n après l’installation. Si votre déploiement n8n utilise le mode file d’attente, assurez-vous que la même version du package est installée sur chaque worker susceptible d’exécuter le workflow.

Créer une clé d’API publique Postoria

  1. Ouvrez les paramètres de Postoria.
  2. Recherchez la section API publique.
  3. Cliquez sur Créer une clé API.
  4. Copiez la clé et conservez-la en lieu sûr.

Postoria n’affiche la clé complète qu’une seule fois. Après la fermeture de la boîte de dialogue, seul son préfixe reste visible.

Si vous perdez la clé, révoquez-la et créez-en une nouvelle.

Pour en savoir plus sur les clés API et le fonctionnement de l’API, consultez l’article d’aide sur l’API publique de Postoria.

Ajouter les identifiants Postoria dans n8n

  1. Créez un workflow dans n8n.
  2. Ajoutez le nœud Postoria.
  3. Dans le champ des identifiants, choisissez Create new credential.
  4. Sélectionnez Postoria API.
  5. Collez votre clé d’API publique Postoria.
  6. Lancez le test des identifiants.
  7. Enregistrez les identifiants.

Les mêmes identifiants peuvent être réutilisés par plusieurs nœuds Postoria dans vos workflows n8n.

Créer votre premier workflow Postoria

Pour un premier workflow simple, vous pouvez lister les espaces de travail Postoria accessibles à votre compte.

  1. Ajoutez un nœud Manual Trigger.
  2. Ajoutez un nœud Postoria et connectez-le au déclencheur.
  3. Sélectionnez :
    • Resource : Workspace
    • Operation : Get Many
  4. Sélectionnez vos identifiants Postoria.
  5. Cliquez sur Execute workflow.

Le résultat contient les identifiants, les noms et les fuseaux horaires des espaces de travail disponibles. Les autres opérations Postoria utilisent l’espace de travail que vous sélectionnez dans le nœud.

Ressources et opérations disponibles

Le nœud Postoria prend actuellement en charge les ressources suivantes :

Workspace

  • Get Many — liste les espaces de travail accessibles à votre compte Postoria.

Social Account

  • Get Many — liste les comptes sociaux connectés à l’espace de travail sélectionné.

Utilisez les identifiants de compte renvoyés pour créer des publications.

Queue

  • Get Many — liste les files d’attente de publication de l’espace de travail sélectionné.

Utilisez l’identifiant de file d’attente renvoyé pour y ajouter une publication.

Media

  • Upload Binary — téléverse les données binaires reçues d’un autre nœud n8n.
  • Import From URL — importe des médias depuis une URL HTTPS publique.
  • Get — récupère un média et vérifie son statut actuel.

Post

  • Create — publie immédiatement, programme une publication ou l’ajoute à une file d’attente.
  • Get — récupère une publication à partir de son identifiant.
  • Get Many — liste les publications avec des filtres facultatifs et une pagination.
  • Delete — supprime une publication de Postoria.

La suppression d’une publication Postoria ne supprime pas le contenu déjà publié sur un réseau social.

Publier immédiatement

  1. Ajoutez un nœud Postoria.
  2. Sélectionnez :
    • Resource : Post
    • Operation : Create
  3. Sélectionnez l’espace de travail.
  4. Réglez Publish Mode sur Publish Now.
  5. Sélectionnez un ou plusieurs comptes sociaux.
  6. Ajoutez la légende et les paramètres facultatifs de la publication.
  7. Ajoutez les identifiants des médias si la publication contient des médias téléversés ou importés.
  8. Exécutez le nœud.

Le nœud renvoie la publication Postoria créée et son statut initial.

Programmer une publication

  1. Sélectionnez :
    • Resource : Post
    • Operation : Create
  2. Sélectionnez l’espace de travail et les comptes sociaux.
  3. Réglez Publish Mode sur Schedule.
  4. Saisissez la date et l’heure de publication prévues.
  5. Ajoutez la légende, les médias, le lien et les paramètres propres à chaque réseau.
  6. Exécutez le nœud.

Vous pouvez utiliser une expression n8n pour définir un horaire relatif. Par exemple, cette expression programme la publication deux heures après l’exécution du workflow :

{{ $now.plus({ hours: 2 }).toISO() }}

Ajouter une publication à une file d’attente

  1. Sélectionnez :
    • Resource : Post
    • Operation : Create
  2. Sélectionnez l’espace de travail.
  3. Réglez Publish Mode sur Add to Queue.
  4. Sélectionnez la file d’attente.
  5. Sélectionnez les comptes sociaux.
  6. Ajoutez le contenu de la publication.
  7. Exécutez le nœud.

La file d’attente doit déjà exister dans l’espace de travail Postoria sélectionné. Vous pouvez créer et gérer les files d’attente dans l’application web Postoria.

Importer des médias depuis une URL publique

Utilisez Media → Import From URL lorsqu’une image, une vidéo ou un document est déjà accessible via une URL HTTPS publique.

  1. Ajoutez un nœud Postoria avant le nœud de création de publication.
  2. Sélectionnez :
    • Resource : Media
    • Operation : Import From URL
  3. Sélectionnez l’espace de travail.
  4. Saisissez l’URL HTTPS publique.
  5. Exécutez le nœud.

Le nœud lance l’importation du média et vérifie automatiquement l’état du traitement. Il ne renvoie un résultat que lorsque le média est prêt à être utilisé ou que le délai maximal de traitement est atteint.

Associez le file_id renvoyé au champ Media IDs du nœud Postoria qui crée la publication.

Téléverser des médias binaires

Utilisez Media → Upload Binary lorsqu’un nœud n8n précédent fournit le fichier sous forme de données binaires.

Ces données binaires peuvent, par exemple, provenir d’un nœud HTTP Request, d’un nœud de stockage cloud, d’un webhook, d’un formulaire envoyé ou d’une autre étape de traitement de fichiers.

  1. Connectez le nœud qui fournit le fichier binaire à un nœud Postoria.
  2. Sélectionnez :
    • Resource : Media
    • Operation : Upload Binary
  3. Sélectionnez l’espace de travail.
  4. Saisissez le nom de la propriété binaire. La valeur par défaut est data.
  5. Exécutez le nœud.

Le nœud Postoria effectue l’intégralité du téléversement :

  1. Il crée une opération de téléversement de média dans Postoria.
  2. Il téléverse le fichier binaire.
  3. Il finalise le téléversement.
  4. Il vérifie l’état du traitement toutes les cinq secondes.
  5. Il renvoie le média une fois le statut ready atteint.

Le délai maximal de traitement par défaut est de 600 secondes. Vous pouvez le modifier dans les paramètres du nœud lorsqu’un fichier volumineux nécessite davantage de temps.

Les formats de téléversement pris en charge comprennent JPEG, PNG, WebP, GIF, MP4, MOV et PDF.

Une fois le téléversement terminé, associez le file_id renvoyé au champ Media IDs du nœud de création de publication.

Gestion des dates et des fuseaux horaires

Postoria interprète les dates programmées selon le fuseau horaire du workflow n8n.

Avant de programmer des publications, ouvrez les paramètres du workflow dans n8n et vérifiez que son fuseau horaire est correct.

Le nœud traite les dates comme suit :

  • Une date contenant Z est interprétée en UTC.
  • Une date contenant un décalage horaire explicite conserve cet instant précis.
  • Une date locale sans décalage est interprétée dans le fuseau horaire du workflow n8n, puis convertie en UTC avant d’être envoyée à Postoria.

Par exemple :

2026-08-01T12:00:00+03:00 → 2026-08-01T09:00:00.000Z

L’utilisation du fuseau horaire du workflow évite que les publications programmées soient décalées lorsque le serveur n8n fonctionne dans une autre région.

Utiliser Postoria comme outil d’un agent IA

Le nœud Postoria peut également être connecté à l’entrée Tool d’un agent IA n8n.

  1. Ajoutez un nœud AI Agent.
  2. Connectez un modèle de conversation pris en charge.
  3. Cliquez sur le connecteur Tool de l’agent IA.
  4. Ajoutez le nœud Postoria.
  5. Sélectionnez la ressource et l’opération Postoria que l’agent est autorisé à utiliser.

Voici un exemple simple et sans risque :

  • Resource : Workspace
  • Operation : Get Many

L’agent peut alors répondre à une demande telle que :

Listez mes espaces de travail Postoria.

Pour les actions qui publient, programment, ajoutent à une file d’attente ou suppriment des publications, vérifiez l’espace de travail, les comptes sociaux, le contenu, les médias et l’horaire sélectionnés avant d’exécuter le workflow.

Exemples de workflows

Vous pouvez combiner le nœud Postoria avec d’autres nœuds n8n pour créer des workflows tels que :

  • Importer un nouvel article depuis un CMS et programmer une publication sur les réseaux sociaux.
  • Lire les publications validées dans Google Sheets et les ajouter à une file d’attente Postoria.
  • Recevoir un webhook, importer une image et publier immédiatement.
  • Télécharger des médias depuis un stockage cloud et les téléverser vers Postoria.
  • Générer une légende avec un nœud IA et l’envoyer à Postoria pour relecture ou publication.
  • Lister les publications programmées et envoyer un récapitulatif quotidien par e-mail ou sur Slack.

Exemple concret de workflow : Car OS Media

Car OS Media est un workflow n8n gratuit créé par bilsimaging. Il transforme une photo de voiture en campagne automobile relue et validée grâce à la réception via Telegram, à cinq rôles créatifs confiés à l’IA, à des visuels principaux produits avec GPT Image 2, à la génération vidéo facultative avec LTX 2.3 et à deux étapes de validation humaine.

Lors de la diffusion, le nœud Postoria vérifié trouve l’espace de travail disponible et les comptes connectés, importe l’image ou la vidéo finalisée, attend que le média soit prêt, puis publie immédiatement ou programme la publication. Le workflow enregistre également le résultat renvoyé par Postoria pour son rapport d’activité quotidien.

Car OS Media s’appuie sur plusieurs services tiers de création et d’hébergement. Sa configuration par défaut téléverse temporairement la photographie source sur le service public ImgBB avec une expiration après sept jours. Examinez le workflow, les exigences de transparence des réseaux de destination, la politique relative aux données des clients et la configuration des services externes avant de l’utiliser en production. Remplacez l’étape d’hébergement d’image par un stockage temporaire contrôlé lorsqu’un hébergeur tiers public ne convient pas.

Package et code source

Le package npm est disponible ici :

https://www.npmjs.com/package/@postoria/n8n-nodes-postoria

Le code de l’intégration est disponible en open source sur GitHub :

https://github.com/postoria-app/n8n-nodes-postoria