• Inizio
  • Guida all\'integrazione
Guida all\'integrazione

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

Hai bisogno di aiuto per costruire il tuo flusso di lavoro? 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.

Gestisci utenti e collega account social

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

  • Naviga alla Gestisci utenti pagina nel tuo pannello Upload-Post.
  • Aggiungi un nuovo utente o seleziona uno esistente.
  • Per l\'utente scelto, collega tutti gli account social media (ad es., TikTok, Instagram, Facebook) ai quali intendi pubblicare contenuti tramite n8n.
  • Prendi nota del User Identifier (questo è tipicamente il nome utente o un ID univoco associato all\'utente in Upload-Post). Ne avrai bisogno per il tuo n8n workflows.

Importante: Gli account social devono essere collegati allo *specifico utente* che intendi utilizzare nella tua automazione, non solo in generale a your Upload-Post account.

Genera Chiave API

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

  • Vai alla API Keys page in your Upload-Post API keys section.
  • Genera una nuova chiave API se non ne hai già una.
  • Copia questa chiave API in modo sicuro. La utilizzerai nella configurazione delle credenziali di n8n.

Nota di sicurezza: Tratta la tua chiave API come una password. Non condividerla pubblicamente né incorporarla direttamente nei workflow condivisi. Usa la gestione delle credenziali di n8nial management system.

Once you have your User Identifier and API Key from Upload-Post, you are ready to configure n8n.

Recommended: Using the Official Upload-Post n8n Node

Disponibilità del nodo:

The n8n-nodes-upload-post il nodo è ora incluso di default nelle versioni aggiornate di n8n sia per 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. Accedi al Nodo Upload-Post

Il nodo Upload-Post è incluso per impostazione predefinita nelle versioni aggiornate di n8n:

  1. Assicurati di avere installata l\'ultima versione di n8n.
  2. Apri il tuo editor di flusso di lavoro n8n.
  3. Cerca "Upload Post" nella libreria dei nodi.
  4. Il nodo dovrebbe essere disponibile senza alcuna installazione aggiuntiva.

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 Sezione API per Caricamento Post (as described in the "Prerequisite" section above).

  1. In n8n, vai a Credenziali > Nuovo.
  2. Search for API per Caricamento Post e selezionalo.
  3. Assign a memorable Nome Credenziale (e.g., "My Upload-Post API Key").
  4. Incolla il tuo Upload Post API Key nel campo designato.
  5. Click Salva.

Questo memorizza in modo sicuro la tua chiave API per l\'uso da parte del nodo Upload-Post.

3. Utilize Node Operations in Your Flussi di Lavoro

The node provides dedicated operations. For each, you will need to provide the User Identifier (dall\'utente che hai configurato in Gestisci utenti di Upload-Post) to specify which user\'s social accounts to use.

Carica Foto(e)

Carica una o più foto. Accetta file o URL.

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

Carica Video

Carica un singolo video. Accetta file o URL.

Richiesto: User Identifier, Platform(s), Video. Opzionale: Title. Platform-specific fields available.

Carica Testo

Carica un post basato su testo.

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

Consulta la node\'s help documentation within n8n or the npm package page per elenchi dettagliati dei parametri. Il Documentazione API per Caricamento Post 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.

Prerequisito: Utente Upload-Post e chiave API

Assicurati di aver completato i passaggi "Prerequisito: Configurazione in Upload-Post" descritti all\'inizio di questa guida. Avrai bisogno di:

Open Upload-Post App

Comprendere gli endpoint API di Upload-Post e fare richieste

Upload-Post offers distinct API endpoints for uploading different types of content. All requests must include an Autorizzazione con la tua chiave API e generalmente richiedono un user campo (il tuo Identificatore Utente di Upload-Post) e platform[] to specify the target social media.

1. Video Upload Endpoint

Endpoint URL: https://api.upload-post.com/api/upload

Usa questo endpoint per caricare singoli file video. I parametri chiave includono video (file), title, user, and platform[].

curl \
  -H 'Autorizzazione: Apikey YOUR_API_KEY_HERE' \
  -F 'video=@/path/to/your/video.mp4' \
  -F 'title="Il titolo del tuo video"' \
  -F 'user="IL_TUO_IDENTIFICATORE_UTENTE"' \
  -F 'platform[]=tiktok' \
  -X POST https://api.upload-post.com/api/upload

2. Photo Upload Endpoint

Endpoint URL: https://api.upload-post.com/api/upload_photos

Per caricare una o più foto (es. per caroselli/slideshow). Usa photos[] per ogni file immagine. Includi anche user, platform[], title, and optionally Programma i post su TikTok in modo automatico usando l.

curl \
  -H 'Autorizzazione: Apikey YOUR_API_KEY_HERE' \
  -F 'photos[]=@/path/to/your/image1.jpg' \
  -F 'photos[]=@/path/to/your/image2.webp' \
  -F 'user="IL_TUO_IDENTIFICATORE_UTENTE"' \
  -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

Endpoint URL: https://api.upload-post.com/api/upload_text

For publishing text-based posts. Requires user, platform[], and title (come contenuto principale). caption può essere usato per il tracking interno o esigenze specifiche della piattaforma.

curl \
  -H 'Autorizzazione: Apikey YOUR_API_KEY_HERE' \
  -F 'user="IL_TUO_IDENTIFICATORE_UTENTE"' \
  -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

Note Importanti per la Configurazione Manuale:

  • Replace LA_TUA_CHIAVE_API_QUI con la tua chiave API reale dalla sezione API di Upload-Post.
  • Replace IL_TUO_IDENTIFICATORE_UTENTE con l\'Identificatore Utente specifico (es. nome utente) di Upload-Post che ha gli account social media target collegati.
  • Si consiglia vivamente di memorizzare la tua chiave API nel gestore di credenziali di n8n e di farvi riferimento nel tuo nodo di richiesta HTTP invece di codificarla in modo statico.
  • The @/path/to/your/file la sintassi in cURL indica un upload di file. In n8n, useresti espressioni per referenziare dati binari da nodi precedenti (e.g., ={{ $binary.data }}).

Suggerimento professionale: Testa e genera cURL dal dashboard di Upload-Post

Before configuring n8n, test your uploads directly from the Dashboard di 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.

Flusso di Lavoro:

  1. Vai a Dashboard di Upload-Post
  2. Carica i tuoi contenuti (video, foto o testo) sulle piattaforme desiderate
  3. Dopo un caricamento riuscito, copia il comando cURL generato
  4. Importa questo cURL direttamente nel tuo nodo HTTP Request di n8n utilizzando la funzione "Importa da cURL"

Configura il nodo di richiesta HTTP n8n (Corpo)

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

Campo Value / Description Richiesto
user Your User Identifier da Upload-Post (es. nome utente). Richiesto
platform[] Platform identifier (e.g., tiktok, instagram). Repeat for multiple platforms. Richiesto
title Pubblica titolo o contenuto (varia in base alla piattaforma e al tipo di post). Opzionale/Variabile
video Dati del file binario per il caricamento di video. Se carichi video
image[] Dati del file binario per il caricamento di immagini. Ripeti per più immagini in un carosello/slideshow. Se carichi immagine(i)
n8n Configuration Tips:
  • Set HTTP Request node Metodo to POST.
  • Set URL to https://api.upload-post.com/api/upload.
  • Add the Autorizzazione con la tua chiave API.
  • For Tipo di contenuto del corpo, select multipart/form-data.
  • Aggiungi campi al body come 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 Documentazione API per Caricamento Post.

Esempio: Nodo HTTP JSON (Video per 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": "Autorizzazione",
          "value": "Apikey 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 : 'Il mio fantastico video'"
        },
        {
          "name": "platform[]",
          "value": "tiktok"
        }
      ]
    },
    "formBinaryData": {
      "video": "={{ $binary.data }}"
    },
    "options": {}
  },
  "name": "Carica Video su TikTok (Manuale)",
  "type": "n8n-nodes-base.httpRequest"
}

Crucial: API Keys & User Identifiers

  • API Key Security: Usa sempre la gestione delle credenziali di n8n per la tua chiave API di Upload-Post. Evita di inserirla direttamente nel codice.
  • User Identifier: Ensure the user il campo nel corpo della tua richiesta riferisce correttamente l\'Identificatore Utente di Upload-Post i cui account social collegati tu intend to use.
  • Quando condividi flussi di lavoro, esporta senza dati di credenziali sensibili.

Esempio di flusso di lavoro: Editore di social media alimentato da AI

This workflow is available as a template: Visualizza su n8n.io o vedi tutti i nostri modelli n8n

What It Does

  • Monitora una cartella Google Drive per nuovi video
  • Trascrive il video utilizzando OpenAI
  • Genera descrizioni coinvolgenti per i social media
  • Caricamenti su Instagram, TikTok e YouTube
  • Invia notifiche al completamento o in caso di errori

Workflow Architecture

n8n Workflow Architecture

Implementation Steps

  1. Google Drive Trigger: Configura per monitorare una cartella specifica per nuovi video
  2. Trascrizione di OpenAI: Configura per estrarre l\'audio e convertirlo in testo
  3. Generatore di descrizioni OpenAI: Use a custom prompt to create engaging descriptions based on transcription
  4. Richiesta HTTP di Upload-Post: Configure as described in previous steps with multi-platform selection
  5. Gestione degli errori: Add Telegram notification for success/failure alerts
Get This Template on n8n.io

Esempio di flusso di lavoro: Editore di carosello di immagini per Instagram e TikTok

This workflow is available as a template: Visualizza su n8n.io o vedi tutti i nostri modelli n8n

What It Does

  • Automatizza il caricamento di più immagini come caroselli su Instagram
  • Automatizza il caricamento di più immagini come diaporami su TikTok
  • Semplifica la gestione dei contenuti visivi su più piattaforme
  • Gestisce il caricamento di più immagini con un singolo trigger

Workflow Steps

  1. Trigger: Avvia il workflow con le tue immagini selezionate (es. da una programmazione, webhook o esecuzione manuale).
  2. Elaborazione Immagini: Il workflow prepara le immagini per i formati specifici di ogni piattaforma (considera nodi per il ridimensionamento o la formattazione se necessario).
  3. Richiesta HTTP di Upload-Post: Configure an HTTP Request node (similar to the video upload) but adjust for image uploads.
    • Use `image[]` field instead of `video`.
    • Passa dati binari per ogni immagine al campo `image[]`.
    • Imposta `platform[]` su `instagram` e/o `tiktok`.
  4. Ottimizzazione della piattaforma: Upload-Post handles formatting according to each platform\'s requirements (carousel for Instagram, slideshow for TikTok).
  5. (Optional) Notifications: Aggiungi nodi per notificare in caso di successo o fallimento.

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

Get This Template on n8n.io

Hai bisogno di assistenza?

I nostri esperti di integrazione sono qui per aiutarti

Contact Support