Como usar a integração do Postoria com o n8n

A integração do Postoria com o n8n permite criar fluxos automatizados de publicação em redes sociais no n8n sem chamar manualmente a API pública do Postoria.

Você pode usar o nó comunitário oficial e verificado do Postoria para listar espaços de trabalho e contas sociais, enviar ou importar mídia, publicar posts imediatamente, agendar posts, adicionar posts a filas, listar posts existentes, verificar o status de posts e excluir posts no Postoria.

A integração está disponível nos planos Pro e Agency.

Disponibilidade atual

O nó oficial do Postoria está disponível como nó comunitário verificado tanto no n8n Cloud quanto no n8n auto-hospedado.

O nome do pacote é:

@postoria/n8n-nodes-postoria

  • n8n Cloud: pesquise Postoria diretamente na área de edição do fluxo e adicione o nó ao seu fluxo.
  • n8n auto-hospedado: instale o pacote em Settings → Community Nodes ou selecione-o diretamente se sua versão do n8n incluir nós comunitários verificados.

Em algumas instalações, pode ser necessário reiniciar a instância do n8n e ativar Verified Community Nodes no painel de administração antes que o nó apareça.

Antes de começar

Você precisa de:

  • Um plano Pro ou Agency ativo no Postoria.
  • Uma chave da API pública do Postoria.
  • Acesso ao n8n Cloud ou a uma instância auto-hospedada do n8n.
  • Uma conta Owner ou Admin do n8n, se precisar instalar ou habilitar nós comunitários.

O nó do Postoria se conecta diretamente à API pública do Postoria. Sua chave de API fica armazenada no sistema de credenciais do n8n.

Adicione o nó do Postoria ao n8n

n8n Cloud

  1. Abra um fluxo.
  2. Clique para adicionar um nó.
  3. Pesquise Postoria.
  4. Selecione o nó verificado do Postoria e adicione-o ao fluxo.

Não é necessário instalar manualmente um pacote npm.

n8n auto-hospedado

  1. Abra sua instância auto-hospedada do n8n.
  2. Acesse Settings.
  3. Abra Community Nodes.
  4. Clique em Install.
  5. Insira o nome do pacote:

@postoria/n8n-nodes-postoria

  1. Confirme que você entende os riscos de instalar um pacote comunitário.
  2. Clique em Install.

Após a instalação, pesquise Postoria no painel de nós e adicione-o a um fluxo como qualquer outro nó do n8n.

Algumas instalações auto-hospedadas podem exigir a reinicialização do n8n após a instalação. Se sua instalação do n8n usa o modo de filas, verifique se a mesma versão do pacote está instalada em todos os workers que podem executar o fluxo.

Crie uma chave da API pública do Postoria

  1. Abra as Configurações do Postoria.
  2. Encontre a seção API pública, servidor MCP e integração com n8n.
  3. Clique em Criar chave de API.
  4. Copie a chave e guarde-a com segurança.

O Postoria mostra a chave completa apenas uma vez. Depois de fechar a janela, você verá somente o prefixo dela.

Se perder a chave, revogue-a e crie uma nova.

Saiba mais sobre as chaves e o comportamento da API no artigo de ajuda da API pública do Postoria.

Adicione as credenciais do Postoria no n8n

  1. Crie um fluxo no n8n.
  2. Adicione o nó Postoria.
  3. No campo de credencial, escolha Create new credential.
  4. Selecione Postoria API.
  5. Cole sua chave da API pública do Postoria.
  6. Execute o teste de credencial.
  7. Salve a credencial.

A mesma credencial pode ser reutilizada por vários nós do Postoria nos seus fluxos do n8n.

Crie seu primeiro fluxo do Postoria

Um primeiro fluxo simples é listar os espaços de trabalho do Postoria disponíveis para sua conta.

  1. Adicione um nó Manual Trigger.
  2. Adicione um nó Postoria e conecte-o ao gatilho.
  3. Selecione:
    • Resource: Workspace
    • Operation: Get Many
  4. Selecione sua credencial do Postoria.
  5. Clique em Execute workflow.

A saída contém os IDs, nomes e fusos horários dos espaços de trabalho disponíveis. Outras operações do Postoria usam o espaço de trabalho selecionado no nó.

Recursos e operações disponíveis

Atualmente, o nó do Postoria oferece estes recursos:

Workspace

  • Get Many — lista os espaços de trabalho disponíveis para sua conta do Postoria.

Social Account

  • Get Many — lista as contas sociais conectadas a um espaço de trabalho selecionado.

Use os IDs de contas retornados ao criar posts.

Queue

  • Get Many — lista as filas de publicação de um espaço de trabalho selecionado.

Use o ID de fila retornado ao adicionar um post a uma fila.

Media

  • Upload Binary — envia dados binários recebidos de outro nó do n8n.
  • Import From URL — importa mídia de uma URL HTTPS pública.
  • Get — obtém um item de mídia e verifica seu status atual.

Post

  • Create — publica agora, agenda um post ou adiciona um post a uma fila.
  • Get — obtém um post pelo ID.
  • Get Many — lista posts com filtros e paginação opcionais.
  • Delete — exclui um post do Postoria.

Excluir um post do Postoria não remove o conteúdo que já foi publicado em uma rede social.

Publique um post imediatamente

  1. Adicione um nó Postoria.
  2. Selecione:
    • Resource: Post
    • Operation: Create
  3. Selecione o espaço de trabalho.
  4. Defina Publish Mode como Publish Now.
  5. Selecione uma ou mais contas sociais.
  6. Adicione a legenda e as configurações opcionais do post.
  7. Adicione IDs de mídia quando o post incluir mídias enviadas ou importadas.
  8. Execute o nó.

O nó retorna o post criado no Postoria e seu status inicial.

Agende um post

  1. Selecione:
    • Resource: Post
    • Operation: Create
  2. Selecione o espaço de trabalho e as contas sociais.
  3. Defina Publish Mode como Schedule.
  4. Insira a data e o horário de agendamento.
  5. Adicione a legenda, a mídia, o link e as configurações específicas de cada rede.
  6. Execute o nó.

Você pode usar uma expressão do n8n para um agendamento relativo. Por exemplo, esta expressão agenda o post para duas horas depois da execução do fluxo:

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

Adicione um post a uma fila

  1. Selecione:
    • Resource: Post
    • Operation: Create
  2. Selecione o espaço de trabalho.
  3. Defina Publish Mode como Add to Queue.
  4. Selecione a fila.
  5. Selecione as contas sociais.
  6. Adicione o conteúdo do post.
  7. Execute o nó.

A fila já precisa existir no espaço de trabalho selecionado do Postoria. Você pode criar e gerenciar filas no aplicativo web do Postoria.

Importe mídia de uma URL pública

Use Media → Import From URL quando uma imagem, um vídeo ou um documento já estiver disponível em uma URL HTTPS pública.

  1. Adicione um nó do Postoria antes do nó de criação do post.
  2. Selecione:
    • Resource: Media
    • Operation: Import From URL
  3. Selecione o espaço de trabalho.
  4. Insira a URL HTTPS pública.
  5. Execute o nó.

O nó inicia a importação da mídia e verifica automaticamente o status do processamento. Ele só retorna quando a mídia está pronta para uso ou quando o tempo limite de processamento é atingido.

Mapeie o file_id retornado para o campo Media IDs do nó do Postoria que cria o post.

Envie mídia binária

Use Media → Upload Binary quando um nó anterior do n8n fornecer o arquivo como dados binários.

Por exemplo, os dados binários podem vir de um nó HTTP Request, de um nó de armazenamento em nuvem, de um webhook, do envio de um formulário ou de outra etapa de processamento de arquivos.

  1. Conecte o nó que fornece o arquivo binário a um nó do Postoria.
  2. Selecione:
    • Resource: Media
    • Operation: Upload Binary
  3. Selecione o espaço de trabalho.
  4. Insira o nome da propriedade binária. O padrão é data.
  5. Execute o nó.

O nó do Postoria executa todo o processo de upload:

  1. Cria um upload de mídia no Postoria.
  2. Envia o arquivo binário.
  3. Conclui o upload.
  4. Verifica o status do processamento a cada cinco segundos.
  5. Retorna a mídia depois que ela atinge o status ready.

O tempo limite padrão de processamento é de 600 segundos. Você pode alterá-lo nas configurações do nó quando um arquivo grande precisar de mais tempo.

Os formatos de upload aceitos incluem JPEG, PNG, WebP, GIF, MP4, MOV e PDF.

Após a conclusão do upload, mapeie o file_id retornado para o campo Media IDs do nó de criação do post.

Comportamento de datas e fusos horários

O Postoria interpreta as datas agendadas usando o fuso horário do fluxo do n8n.

Antes de agendar posts, abra as configurações do fluxo no n8n e confirme se o fuso horário está correto.

O nó trata as datas da seguinte forma:

  • Uma data que contém Z é tratada como UTC.
  • Uma data com deslocamento de fuso explícito preserva aquele instante exato.
  • Uma data local sem deslocamento é interpretada no fuso horário do fluxo do n8n e depois convertida para UTC antes de ser enviada ao Postoria.

Por exemplo:

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

Usar o fuso horário do fluxo ajuda a evitar mudanças no horário dos posts agendados quando o servidor do n8n é executado em outra região.

Use o Postoria como ferramenta de um AI Agent

O nó do Postoria também pode ser conectado à entrada Tool de um AI Agent do n8n.

  1. Adicione um nó AI Agent.
  2. Conecte um Chat Model compatível.
  3. Clique no conector Tool do AI Agent.
  4. Adicione o nó Postoria.
  5. Selecione o recurso e a operação do Postoria que o agente terá permissão para usar.

Um exemplo simples e seguro é:

  • Resource: Workspace
  • Operation: Get Many

O agente poderá então responder a um pedido como:

Liste meus espaços de trabalho do Postoria.

Para ações que publiquem, agendem, adicionem à fila ou excluam posts, revise o espaço de trabalho, as contas sociais, o conteúdo, a mídia e o horário agendado antes de executar o fluxo.

Ideias de fluxos de trabalho

O nó do Postoria pode ser combinado com outros nós do n8n para criar fluxos como:

  • Importar um novo artigo de um CMS e agendar um post nas redes sociais.
  • Ler posts aprovados no Google Sheets e adicioná-los a uma fila do Postoria.
  • Receber um webhook, importar uma imagem e publicar um post imediatamente.
  • Baixar mídia de um armazenamento em nuvem e enviá-la ao Postoria.
  • Gerar uma legenda com um nó de IA e enviá-la ao Postoria para revisão ou publicação.
  • Listar posts agendados e enviar um resumo diário por e-mail ou Slack.

Exemplo real de fluxo: Car OS Media

O Car OS Media é um fluxo gratuito do n8n criado pela bilsimaging. Ele transforma uma foto de carro em uma campanha automotiva que passa por revisão, com envio inicial pelo Telegram, cinco papéis criativos desempenhados por IA, imagens principais do GPT Image 2, geração opcional de vídeo com LTX 2.3 e duas etapas de aprovação humana.

Na etapa de distribuição, o nó verificado do Postoria encontra o espaço de trabalho disponível e as contas conectadas, importa a imagem ou o vídeo finalizado, aguarda a mídia ficar pronta e publica imediatamente ou agenda a publicação. O fluxo também registra o resultado do Postoria no relatório diário de operações.

O Car OS Media depende de vários serviços externos de criação e hospedagem. A configuração padrão envia temporariamente a fotografia original para o serviço público ImgBB com expiração em sete dias. Revise o fluxo, os requisitos de identificação de conteúdo das redes de destino, a política de dados dos clientes e as configurações dos serviços externos antes de usá-lo em produção. Substitua a etapa de hospedagem de imagens por armazenamento temporário controlado quando um serviço público de terceiros não for adequado.

Pacote e código-fonte

O pacote npm está disponível aqui:

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

A integração tem código aberto no GitHub:

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