Guide d\'intégration

Upload-Post + n8n Integration

Automate your social media publishing by connecting Upload-Post with n8n. Start by setting up your Upload-Post users and API key, then choose between our official n8n node or manual HTTP configuration.

Browse All n8n Templates

Besoin d\'aide pour construire votre flux de travail ? We work with trusted partners who can set up your n8n automation or build a custom project for you.

Contact us

Prerequisite: Setup in Upload-Post

Before configuring n8n, you must set up users and generate an API key within your Upload-Post account. These will be used to authenticate and direct your automated posts.

Gérer les utilisateurs et connecter les comptes sociaux

Each post is associated with a specific user in Upload-Post. This user must have the target social media platforms connected to their profile.

  • Naviguez vers la Gérer les utilisateurs page dans votre tableau de bord Upload-Post.
  • Ajoutez un nouvel utilisateur ou sélectionnez un existant.
  • Pour l\'utilisateur choisi, connectez tous les comptes de médias sociaux (par exemple, TikTok, Instagram, Facebook) auxquels vous souhaitez publier du contenu via n8n.
  • Notez le Identifiant de l\'utilisateur. (c\'est généralement le nom d\'utilisateur ou un identifiant unique associé à l\'utilisateur dans Upload-Post). Vous en aurez besoin pour votre n8n workflows.

Important : Les comptes sociaux doivent être connectés à l'*utilisateur spécifique* que vous prévoyez d\'utiliser dans votre automatisation, pas simplement de manière générale à your Upload-Post account.

Générez une clé API

The API key authenticates your requests to the Upload-Post API.

  • Allez dans la Clés API page in your Upload-Post API keys section.
  • Générez une nouvelle clé API si vous n\'en avez pas déjà une.
  • Copiez cette clé API en toute sécurité. Vous l\'utiliserez dans votre configuration de credentials n8n.

Remarque de sécurité : Traitez votre clé API comme un mot de passe. Ne la partagez pas publiquement et ne l\'intégrez pas directement dans les workflows partagés. Utilisez la gestion des identifiants de n8nial management system.

Once you have your Identifiant de l\'utilisateur. and Clé API from Upload-Post, you are ready to configure n8n.

Recommended: Using the Official Upload-Post n8n Node

Disponibilité du nœud :

The n8n-nodes-upload-post le nœud est maintenant inclus par défaut dans les versions mises à jour de n8n pour self-hosted (on-premise) n8n instances and n8n cloud instances. No manual installation is required - just ensure you have the latest version of n8n.

The easiest way to integrate is using our official node: n8n-nodes-upload-post. This node is included by default in updated versions of n8n and streamlines setup with dedicated operations for both cloud and self-hosted n8n instances.

1. Accédez au Nœud Upload-Post

Le nœud Upload-Post est inclus par défaut dans les versions mises à jour de n8n :

  1. Assurez-vous d\'avoir la dernière version de n8n installée.
  2. Ouvrez votre éditeur de flux de travail n8n.
  3. Recherchez "Upload Post" dans la bibliothèque de nœuds.
  4. Le nœud devrait être disponible sans installation supplémentaire.

If you don\'t see the node, please update your n8n instance to the latest version.

2. Configure Upload-Post API Credentials in n8n

You\'ll use the API Key generated from your Section de l\'API de Téléchargement de Publication (as described in the "Prerequisite" section above).

  1. Dans n8n, allez dans Identifiants > Nouveau.
  2. Search for API de Téléchargement de Publication et sélectionnez-le.
  3. Assign a memorable Nom d\'identifiant (e.g., "My Upload-Post API Key").
  4. Collez votre Upload Post Clé API dans le champ désigné.
  5. Click Enregistrer.

Cela stocke en toute sécurité votre clé API pour une utilisation par le nœud Upload-Post.

3. Utilize Node Operations in Your Flux de Travail

The node provides dedicated operations. For each, you will need to provide the Identifiant de l\'utilisateur. (de l\'utilisateur que vous avez configuré dans Gérer les utilisateurs Upload-Post) to specify which user\'s social accounts to use.

Téléchargez Photo(s)

Téléchargez une ou plusieurs photos. Accepte les fichiers ou les URL.

Requis : User Identifier, Platform(s), Photos. Optionnel : Title, Caption. Platform-specific fields available.

Téléchargez Vidéo

Téléchargez une seule vidéo. Accepte les fichiers ou les URL.

Requis : User Identifier, Platform(s), Video. Optionnel : Title. Platform-specific fields available.

Téléchargez Texte

Téléchargez un post basé sur du texte.

Requis : User Identifier, Platform(s), Title/Content. Platform-specific fields available.

Consultez la node\'s help documentation within n8n or the npm package page pour les listes détaillées des paramètres. Le Documentation de l\'API de Téléchargement de Publication provides full details on underlying API capabilities.

Using this dedicated n8n node is the recommended approach for both cloud and self-hosted n8n users.

Manual Configuration (Alternative using HTTP Request Node)

If the official node is not suitable for your specific needs, you can configure the integration manually using n8n\'s generic HTTP Request node. This requires careful setup of API parameters.

Prérequis : Utilisateur Upload-Post & Clé API

Assurez-vous d\'avoir complété les étapes "Prérequis : Configuration dans Upload-Post" décrites au début de ce guide. Vous aurez besoin de :

Open Upload-Post App

Comprendre les points de terminaison de l\'API Upload-Post et faire des requêtes

Upload-Post offers distinct API endpoints for uploading different types of content. All requests must include an Autorisation avec votre clé API et nécessitent généralement un user champ (votre Identifiant Utilisateur d\'Upload-Post) et platform[] to specify the target social media.

1. Video Upload Endpoint

Point de terminaison URL: https://api.upload-post.com/api/upload

Utilisez ce endpoint pour télécharger des fichiers vidéo individuels. Les paramètres clés incluent video (file), title, user, and platform[].

curl \
  -H 'Autorisation : Apikey VOTRE_CLÉ_API_ICI' \
  -F 'video=@/path/to/your/video.mp4' \
  -F 'title="Le titre de votre vidéo"' \
  -F 'user="VOTRE_IDENTIFIANT_UTILISATEUR"' \
  -F 'platform[]=tiktok' \
  -X POST https://api.upload-post.com/api/upload

2. Photo Upload Endpoint

Point de terminaison URL: https://api.upload-post.com/api/upload_photos

Pour télécharger une ou plusieurs photos (par exemple, pour les carrousels/diaporamas). Utilisez photos[] pour chaque fichier image. Incluez également user, platform[], title, and optionally description.

curl \
  -H 'Autorisation : Apikey VOTRE_CLÉ_API_ICI' \
  -F 'photos[]=@/path/to/your/image1.jpg' \
  -F 'photos[]=@/path/to/your/image2.webp' \
  -F 'user="VOTRE_IDENTIFIANT_UTILISATEUR"' \
  -F 'platform[]=instagram' \
  -F 'title="My Awesome Photo Album"' \
  -F 'description="Check out these cool photos!"' \
  -X POST https://api.upload-post.com/api/upload_photos

3. Text Upload Endpoint

Point de terminaison URL: https://api.upload-post.com/api/upload_text

For publishing text-based posts. Requires user, platform[], and title (comme contenu principal). caption peut être utilisé pour le suivi interne ou des besoins spécifiques à la plateforme.

curl \
  -H 'Autorisation : Apikey VOTRE_CLÉ_API_ICI' \
  -F 'user="VOTRE_IDENTIFIANT_UTILISATEUR"' \
  -F 'platform[]=x' \
  -F 'title="This is my amazing tweet content!"' \
  -F 'caption="Optional: A caption for stats & tracking."' \
  -X POST https://api.upload-post.com/api/upload_text

Notes importantes pour la configuration manuelle :

  • Replace VOTRE_CLÉ_API_ICI avec votre véritable clé API de la section API d\'Upload-Post.
  • Replace VOTRE_IDENTIFIANT_UTILISATEUR avec l\'Identifiant Utilisateur spécifique (par exemple, nom d\'utilisateur) d\'Upload-Post qui a les comptes de réseaux sociaux cibles connectés.
  • Il est fortement recommandé de stocker votre clé API dans le gestionnaire d\'identifiants de n8n et de la référencer dans votre nœud de requête HTTP au lieu de la coder en dur.
  • The @/path/to/your/file la syntaxe en cURL indique un téléchargement de fichier. Dans n8n, vous utiliseriez des expressions pour référencer les données binaires des nœuds précédents (e.g., ={{ $binary.data }}).

Astuce Pro : Testez et générez cURL depuis le tableau de bord Upload-Post

Before configuring n8n, test your uploads directly from the Tableau de bord Upload-Post. Once you\'ve successfully uploaded content, the dashboard generates a perfect cURL command that you can copy and import directly into your n8n HTTP Request node.

Flux de travail :

  1. Allez dans Tableau de bord Upload-Post
  2. Téléchargez votre contenu (vidéo, photos ou texte) sur les plateformes de votre choix
  3. Après un téléchargement réussi, copiez la commande cURL générée
  4. Importez ce cURL directement dans votre n8n HTTP Request node en utilisant la fonctionnalité "Importer depuis cURL"

Configurer le nœud de requête HTTP n8n (Corps)

Key fields for the HTTP Request node\'s body (typically multipart/form-data):

Champ Valeur / Description Requis
user Your Identifiant de l\'utilisateur. d\'Upload-Post (par exemple, nom d\'utilisateur). Requis
platform[] Platform identifier (e.g., tiktok, instagram). Repeat for multiple platforms. Requis
title Titre ou contenu de la publication (varie selon la plateforme et le type de publication). Optionnel/Varie
video Données de fichier binaire pour les téléchargements de vidéos. Si vous téléchargez une vidéo
image[] Données de fichier binaire pour les téléchargements d\'images. Répétez pour plusieurs images dans un carrousel/diaporama. Si vous téléchargez une ou plusieurs image(s)
n8n Configuration Tips:
  • Set HTTP Request node Méthode to POST.
  • Set URL to https://api.upload-post.com/api/upload.
  • Add the Autorisation avec votre clé API.
  • For Type de contenu du corps, select multipart/form-data.
  • Ajoutez des champs au corps comme user, platform[], title, and either video or image[] with appropriate values (e.g., using n8n expressions like ={{ $binary.data }} for file data).

For detailed examples and platform-specific parameters, refer to the Documentation de l\'API de Téléchargement de Publication.

Exemple : Node HTTP JSON (Vidéo vers TikTok)

This is a conceptual JSON representation for an n8n HTTP Request node configured to upload a video to TikTok. You would build this using the n8n interface. 

{
  "parameters": {
    "method": "POST",
    "url": "https://api.upload-post.com/api/upload",
    "authentication": "headerAuth",
    "sendHeaders": true,
    "headerParameters": {
      "parameters": [
        {
          "name": "Autorisation",
          "value": "Clé API YOUR_API_KEY_HERE"
        }
      ]
    },
    "sendBody": true,
    "bodyContentType": "multipart-form-data",
    "bodyParameters": {
      "parameters": [
        {
          "name": "user",
          "value": "YOUR_UPLOAD_POST_USER_IDENTIFIER"
        },
        {
          "name": "title",
          "value": "= $input.item.title ? $input.item.title : 'Ma vidéo géniale'"
        },
        {
          "name": "platform[]",
          "value": "tiktok"
        }
      ]
    },
    "formBinaryData": {
      "video": "={{ $binary.data }}"
    },
    "options": {}
  },
  "name": "Téléchargez Vidéo sur TikTok (Manuel)",
  "type": "n8n-nodes-base.httpRequest"
}

Crucial: API Keys & User Identifiers

  • Sécurité de la clé API : Utilisez toujours la gestion des identifiants de n8n pour votre clé API Upload-Post. Évitez de la coder en dur.
  • Identifiant de l\'utilisateur : Ensure the user le champ dans le corps de votre requête référence correctement l\'Identifiant Utilisateur d\'Upload-Post dont les comptes sociaux connectés vous intend to use.
  • Lors du partage de flux de travail, exportez sans données d\'identification sensibles.

Exemple de flux de travail : Éditeur de médias sociaux alimenté par l\'IA

This workflow is available as a template: Voir sur n8n.io ou voir tous nos modèles n8n

What It Does

  • Surveille un dossier Google Drive pour de nouvelles vidéos
  • Transcrit la vidéo en utilisant OpenAI
  • Génère des descriptions engageantes pour les réseaux sociaux
  • Téléchargements vers Instagram, TikTok et YouTube.
  • Envoie des notifications à l\'achèvement ou en cas d\'erreurs

Workflow Architecture

n8n Workflow Architecture

Implementation Steps

  1. Déclencheur Google Drive : Configurez pour surveiller un dossier spécifique pour les nouvelles vidéos
  2. Transcription OpenAI : Configurez pour extraire l\'audio et convertir en texte
  3. Générateur de descriptions OpenAI : Use a custom prompt to create engaging descriptions based on transcription
  4. Requête HTTP Upload-Post : Configure as described in previous steps with multi-platform selection
  5. Gestion des erreurs : Add Telegram notification for success/failure alerts
Get This Template on n8n.io

Exemple de flux de travail : Éditeur de carrousel d\'images pour Instagram et TikTok

This workflow is available as a template: Voir sur n8n.io ou voir tous nos modèles n8n

What It Does

  • Automatise le téléchargement de plusieurs images sous forme de carrousels sur Instagram
  • Automatise le téléchargement de plusieurs images sous forme de diaporamas sur TikTok
  • Rationalise la gestion du contenu visuel sur plusieurs plateformes
  • Gère les téléchargements multi-images avec un seul déclencheur

Workflow Steps

  1. Déclencheur : Démarrez le workflow avec vos images sélectionnées (par exemple, depuis un planning, un webhook ou une exécution manuelle).
  2. Traitement d\'images : Le workflow prépare les images pour les formats spécifiques à chaque plateforme (envisagez des nœuds pour le redimensionnement ou le formatage si nécessaire).
  3. Requête HTTP Upload-Post : Configure an HTTP Request node (similar to the video upload) but adjust for image uploads.
    • Utilisez le champ `image[]` au lieu de `video`.
    • Passez les données binaires pour chaque image au champ `image[]`.
    • Définissez `platform[]` sur `instagram` et/ou `tiktok`.
  4. Optimisation de la plateforme : Upload-Post handles formatting according to each platform\'s requirements (carousel for Instagram, slideshow for TikTok).
  5. (Optional) Notifications: Ajoutez des nœuds pour notifier en cas de succès ou d\'échec.

Consultez la n8n template for specific node configurations, especially for handling multiple image inputs.

Get This Template on n8n.io

Besoin d\'assistance ?

Nos experts en intégration sont là pour vous aider

Contact Support