Guia de Integração

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

Precisa de ajuda para construir seu fluxo de trabalho? 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.

Gerenciar Usuários e Conectar Contas Sociais

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

  • Navegue até a Gerenciar Usuários página no seu painel do Upload-Post.
  • Adicione um novo usuário ou selecione um existente.
  • Para o usuário escolhido, conecte todas as contas de mídia social (por exemplo, TikTok, Instagram, Facebook) às quais você pretende publicar conteúdo via n8n.
  • Anote o Identificador do Usuário (isso é tipicamente o nome de usuário ou um ID único associado ao usuário no Upload-Post). Você precisará disso para seu n8n workflows.

Importante: As contas sociais devem estar conectadas ao *usuário específico* que você pretende usar na sua automação, não apenas de forma geral a your Upload-Post account.

Gerar Chave de API

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

  • Vá para a Chaves da API page in your Upload-Post API keys section.
  • Gere uma nova chave de API se você ainda não tiver uma.
  • Copie esta chave API com segurança. Você a usará na configuração de credenciais do n8n.

Nota de segurança: Trate sua chave API como uma senha. Não a compartilhe publicamente nem a incorpore diretamente em workflows compartilhados. Use o gerenciamento de credenciais do n8nial management system.

Once you have your Identificador do Usuário and Chave da API from Upload-Post, you are ready to configure n8n.

Recommended: Using the Official Upload-Post n8n Node

Disponibilidade do nó:

The n8n-nodes-upload-post o nó está incluído por padrão nas versões atualizadas do n8n tanto para 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. Acesse o Nó Upload-Post

O nó Upload-Post está incluído por padrão nas versões atualizadas do n8n:

  1. Certifique-se de ter a versão mais recente do n8n instalada.
  2. Abra seu editor de workflow do n8n.
  3. Pesquise por "Upload Post" na biblioteca de nós.
  4. O nó deve estar disponível sem nenhuma instalação adicional.

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 Seção da API de Upload de Post (as described in the "Prerequisite" section above).

  1. No n8n, vá para Credenciais > Novo.
  2. Search for API de Upload de Post e selecione-o.
  3. Assign a memorable Nome da Credencial (e.g., "My Upload-Post API Key").
  4. Cole seu Upload Post Chave da API no campo designado.
  5. Click Salvar.

Isso armazena com segurança sua chave de API para uso pelo nó Upload-Post.

3. Utilize Node Operations in Your Fluxos de Trabalho

The node provides dedicated operations. For each, you will need to provide the Identificador do Usuário (do usuário que você configurou no Gerenciar Usuários do Upload-Post) to specify which user\'s social accounts to use.

Fazer Upload de Foto(s)

Envie uma ou mais fotos. Aceita arquivos ou URLs.

Obrigatório: User Identifier, Platform(s), Photos. Opcional: Title, Caption. Platform-specific fields available.

Fazer Upload de Vídeo

Faça upload de um único vídeo. Aceita arquivo ou URL.

Obrigatório: User Identifier, Platform(s), Video. Opcional: Title. Platform-specific fields available.

Fazer Upload de Texto

Faça upload de um post baseado em texto.

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

Consulte a node\'s help documentation within n8n or the npm package page para listas detalhadas de parâmetros. O Documentação da API de Upload de 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.

Pré-requisito: Usuário do Upload-Post e Chave da API

Certifique-se de ter concluído os passos "Pré-requisito: Configuração no Upload-Post" descritos no início deste guia. Você precisará de:

Open Upload-Post App

Entendendo os Endpoints da API Upload-Post e Fazendo Requisições

Upload-Post offers distinct API endpoints for uploading different types of content. All requests must include an Autorização com sua chave API e geralmente requerem um user campo (seu Identificador de Usuário do Upload-Post) e platform[] to specify the target social media.

1. Video Upload Endpoint

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

Use este endpoint para enviar arquivos de vídeo individuais. Os parâmetros principais incluem video (file), title, user, and platform[].

curl \
  -H 'Autorização: Apikey SUA_API_KEY_AQUI' \
  -F 'video=@/path/to/your/video.mp4' \
  -F 'title="Seu Título de Vídeo"' \
  -F 'user="SEU_IDENTIFICADOR_DE_USUÁRIO"' \
  -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

Para enviar uma ou mais fotos (por exemplo, para carrosséis/apresentações). Use photos[] para cada arquivo de imagem. Também inclua user, platform[], title, and optionally description.

curl \
  -H 'Autorização: Apikey SUA_API_KEY_AQUI' \
  -F 'photos[]=@/path/to/your/image1.jpg' \
  -F 'photos[]=@/path/to/your/image2.webp' \
  -F 'user="SEU_IDENTIFICADOR_DE_USUÁRIO"' \
  -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 (como conteúdo principal). caption pode ser usado para rastreamento interno ou necessidades específicas da plataforma.

curl \
  -H 'Autorização: Apikey SUA_API_KEY_AQUI' \
  -F 'user="SEU_IDENTIFICADOR_DE_USUÁRIO"' \
  -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

Notas Importantes para Configuração Manual:

  • Replace SUA_CHAVE_API_AQUI com sua chave API real da seção API do Upload-Post.
  • Replace SEU_IDENTIFICADOR_DE_USUÁRIO com o Identificador de Usuário específico (por exemplo, nome de usuário) do Upload-Post que tem as contas de redes sociais alvo conectadas.
  • É altamente recomendável armazenar sua chave de API no gerenciador de credenciais do n8n e referenciá-la em seu nó de Solicitação HTTP em vez de codificá-la diretamente.
  • The @/path/to/your/file a sintaxe no cURL indica um upload de arquivo. No n8n, você usaria expressões para referenciar dados binários de nós anteriores (e.g., ={{ $binary.data }}).

Dica Profissional: Teste e Gere cURL a partir do Painel do Upload-Post

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

Fluxo de Trabalho:

  1. Vá para Painel do Upload-Post
  2. Envie seu conteúdo (vídeo, fotos ou texto) para as plataformas desejadas
  3. Após o upload bem-sucedido, copie o comando cURL gerado
  4. Importe este cURL diretamente no seu nó de Requisição HTTP do n8n usando a funcionalidade "Importar de cURL"

Configure o Nó de Requisição HTTP do n8n (Corpo)

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

Campo Valor / Descrição Obrigatório
user Your Identificador do Usuário do Upload-Post (por exemplo, nome de usuário). Obrigatório
platform[] Platform identifier (e.g., tiktok, instagram). Repeat for multiple platforms. Obrigatório
title Publique título ou conteúdo (varia de acordo com a plataforma e o tipo de postagem). Opcional/Variável
video Dados de arquivo binário para uploads de vídeo. Se enviando vídeo
image[] Dados de arquivo binário para uploads de imagens. Repita para várias imagens em um carrossel/apresentação de slides. Se enviando imagem(ns)
n8n Configuration Tips:
  • Set HTTP Request node Método to POST.
  • Set URL to https://api.upload-post.com/api/upload.
  • Add the Autorização com sua chave API.
  • For Tipo de Conteúdo do Corpo, select multipart/form-data.
  • Adicione campos ao corpo como 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 Documentação da API de Upload de Post.

Exemplo: Nó HTTP JSON (Vídeo para 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": "Autorização",
          "value": "Apikey SUA_API_KEY_AQUI"
        }
      ]
    },
    "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 : 'Meu vídeo incrível'"
        },
        {
          "name": "platform[]",
          "value": "tiktok"
        }
      ]
    },
    "formBinaryData": {
      "video": "={{ $binary.data }}"
    },
    "options": {}
  },
  "name": "Fazer Upload de Vídeo para TikTok (Manual)",
  "type": "n8n-nodes-base.httpRequest"
}

Crucial: API Keys & User Identifiers

  • Segurança da Chave da API: Sempre use o gerenciamento de credenciais do n8n para sua chave API do Upload-Post. Evite codificá-la diretamente.
  • Identificador do Usuário: Ensure the user o campo no corpo da sua requisição referencia corretamente o Identificador de Usuário do Upload-Post cujas contas sociais conectadas você intend to use.
  • Ao compartilhar fluxos de trabalho, exporte sem dados de credenciais sensíveis.

Exemplo de Fluxo de Trabalho: Publicador de Mídias Sociais com IA

This workflow is available as a template: Ver em n8n.io ou veja todos os nossos modelos de n8n

What It Does

  • Monitora uma pasta do Google Drive em busca de novos vídeos
  • Transcreve o vídeo usando OpenAI
  • Gera descrições envolventes para redes sociais
  • Uploads para Instagram, TikTok e YouTube
  • Envia notificações ao concluir ou em caso de erros

Workflow Architecture

n8n Workflow Architecture

Implementation Steps

  1. Gatilho do Google Drive: Configure para monitorar uma pasta específica para novos vídeos
  2. Transcrição OpenAI: Configure para extrair áudio e converter em texto
  3. Gerador de Descrições OpenAI: Use a custom prompt to create engaging descriptions based on transcription
  4. Requisição HTTP do Upload-Post: Configure as described in previous steps with multi-platform selection
  5. Tratamento de Erros: Add Telegram notification for success/failure alerts
Get This Template on n8n.io

Exemplo de Fluxo de Trabalho: Publicador de Carrossel de Imagens para Instagram e TikTok

This workflow is available as a template: Ver em n8n.io ou veja todos os nossos modelos de n8n

What It Does

  • Automatiza o upload de várias imagens como carrosséis no Instagram
  • Automatiza o upload de várias imagens como apresentações de slides no TikTok
  • Otimize a gestão de conteúdo visual entre plataformas
  • Gerencia uploads de múltiplas imagens com um único gatilho

Workflow Steps

  1. Gatilho: Inicie o workflow com suas imagens selecionadas (por exemplo, de um agendamento, webhook ou execução manual).
  2. Processamento de Imagem: O workflow prepara as imagens para formatos específicos de cada plataforma (considere nós para redimensionamento ou formatação se necessário).
  3. Requisição HTTP do Upload-Post: Configure an HTTP Request node (similar to the video upload) but adjust for image uploads.
    • Use o campo `image[]` em vez de `video`.
    • Passe dados binários para cada imagem para o campo `image[]`.
    • Defina `platform[]` como `instagram` e/ou `tiktok`.
  4. Otimização da Plataforma: Upload-Post handles formatting according to each platform\'s requirements (carousel for Instagram, slideshow for TikTok).
  5. (Optional) Notifications: Adicione nós para notificar em caso de sucesso ou falha.

Consulte a n8n template for specific node configurations, especially for handling multiple image inputs.

Get This Template on n8n.io

Precisa de Ajuda?

Nossos especialistas em integração estão aqui para ajudar

Contact Support