> ## Documentation Index
> Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Nó de automação de redes sociais para n8n

> Instale o nó da comunidade do Social media studio no n8n auto-hospedado para agendar publicações, gerenciar rascunhos e mídia e disparar fluxos de trabalho a partir de eventos.

O [n8n](https://n8n.io/) é uma ferramenta de código aberto de automação de fluxos de trabalho. O pacote oficial de nós da comunidade, **`@social-media-scheduler/n8n-nodes-social-media-scheduler`**, permite que um fluxo de trabalho do n8n crie e agende publicações, gerencie rascunhos, envie mídia, leia suas contas conectadas e reaja a eventos de publicação.

## Os dois nós

O pacote traz dois nós. Ambos usam a mesma credencial **Social Media Studio API**.

| Nó | Tipo | Finalidade |
| - | - | - |
| **Social Media Studio** | Ação | Executa operações em publicações, rascunhos, mídia e contas sociais. |
| **Social Media Studio Trigger** | Gatilho | Inicia um fluxo de trabalho quando uma publicação é criada, agendada, publicada ou falha, quando um rascunho vira publicação ou quando um limite de cota é atingido. |

### Operações

| Recurso | Operações |
| - | - |
| Post | Create, Get, Get Many, Update, Delete, Schedule, Unschedule, Retry, Resubmit, Bulk Delete, Get Calendar |
| Draft | Create, Get, Get Many, Update, Delete, Convert to Post |
| Media | Upload, Upload to Library, Presign Upload, Presign Library Upload, Get File (with upload verification), Get Many Files, Search, Validate, Get Rules, Delete, Bulk Delete, Move File, Rename File, Create Folder, Get Many Folders, Rename Folder, Move Folder, Delete Folder |
| Social Account | Get, Get Many, Get TikTok Creator Info, List Pinterest Boards, List Discord Channels, List Slack Channels |

Publicações e rascunhos podem ir para Twitter/X, Instagram, LinkedIn (pessoal e Página), Facebook, TikTok, YouTube, Threads, Pinterest, Dribbble, Bluesky, Mastodon, WordPress, Dev.to, Discord e Slack. Os tipos de publicação e as opções disponíveis dependem da conta de destino.

### Eventos do gatilho

| Evento | Dispara quando |
| - | - |
| `post.created` | Uma publicação é criada. |
| `post.scheduled` | Uma publicação é agendada. |
| `post.published` | Uma publicação é publicada na plataforma. |
| `post.failed` | Uma publicação falha ao ser publicada. |
| `draft.converted` | Um rascunho é convertido em publicação. |
| `quota.limit_reached` | Seu plano atinge um limite de uso. |

O nó Trigger gerencia a própria assinatura de webhook. Ele registra uma assinatura quando você ativa o fluxo de trabalho e a remove quando você o desativa. Ele verifica a assinatura **HMAC-SHA256** de cada entrega e responde HTTP 401 para uma assinatura ausente ou incorreta. Veja [Payloads de webhook](/pt-BR/webhooks/payloads.md) para o corpo de cada evento.

> [!NOTE]
>
> O Social media studio precisa conseguir acessar a URL de webhook do seu n8n. Uma instância de n8n auto-hospedada em `localhost` precisa de uma URL pública (por exemplo, um túnel) antes de o nó Trigger poder receber eventos.

## Autenticação

Os dois nós usam uma única credencial de chave de API.

**1. Crie uma chave de API**

No painel do Social media studio, vá em **Configurações → API** e crie uma chave. Veja [Autenticação](/pt-BR/authentication.md) para mais detalhes.

**2. Adicione a credencial no n8n**

No n8n, crie uma nova credencial **Social Media Studio API** e cole a sua chave. O n8n envia a chave no cabeçalho `X-API-Key` e a testa quando você salva a credencial.

> [!NOTE]
>
> Mantenha a **Base URL** padrão (`https://api.so-me.studio`), a menos que você rode o seu próprio backend do Social media studio.

## Instalação

**1. Abra os Community Nodes**

No n8n, vá em **Settings → Community Nodes → Install**.

**2. Instale o pacote**

Digite `@social-media-scheduler/n8n-nodes-social-media-scheduler` e confirme. Os nós **Social Media Studio** e **Social Media Studio Trigger** aparecem no painel de nós.

Em uma instância de n8n auto-hospedada, você também pode instalá-lo diretamente:

```bash theme={null}
npm install @social-media-scheduler/n8n-nodes-social-media-scheduler
```

> [!NOTE]
>
> O n8n exige o Node.js 20 ou superior para executar nós da comunidade.

> [!WARNING]
>
> Este não é um nó da comunidade verificado, então ele só está disponível no **n8n auto-hospedado**. O n8n Cloud não oferece nós da comunidade não verificados.

## Exemplo: publique uma publicação com imagem

**1. Envie a imagem**

Adicione um nó **Social Media Studio** com **Media → Upload to Library**. Defina **Binary Property** com o campo binário que contém a imagem. O nó envia e verifica o arquivo e retorna o ID dele.

**2. Escolha a conta**

Adicione um segundo nó **Social Media Studio** com **Post → Create**. Defina **Platform** e **Post Type** e selecione o destino em **Account Name or ID**.

**3. Anexe a imagem e agende**

Coloque o ID do arquivo da etapa 1 em **Media Library File IDs**, escreva o **Text** e defina **Schedule For**. Deixe **Schedule For** vazio para publicar agora.

> [!TIP]
>
> Execute **Media → Validate** antes de agendar uma publicação. Ele confere cada arquivo com as regras de cada destino e informa quais arquivos uma plataforma vai recusar.

## Threads e primeiros comentários

**Post → Create**, **Update** e **Schedule**, e **Draft → Create**, **Update** e **Convert to Post**, têm os campos **Thread Parts** e **First Comment**. O campo **Text** é a primeira parte do encadeamento (thread) e as demais partes vêm em seguida, em ordem. Os encadeamentos funcionam no Twitter/X, Threads, Bluesky e Mastodon.

## TikTok

Antes de publicar no TikTok, execute **Social Account → Get TikTok Creator Info** e escolha um dos níveis de privacidade retornados. O TikTok recusa uma publicação sem um nível de privacidade permitido.

## Modelos do n8n

Cinco fluxos de trabalho prontos para importar. Cada um usa apenas o nó publicado e os nós integrados do n8n; a nota adesiva amarela em cada canvas lista o que mudar.

| Modelo | O que faz |
| - | - |
| [RSS → AI caption → X](https://github.com/7t1-studio/n8n-nodes-social-media-scheduler/blob/main/templates/rss-ai-caption-to-x.json) | Cada novo item do feed recebe uma publicação para o X escrita por IA, agendada duas horas à frente com o link. |
| [YouTube → LinkedIn and X](https://github.com/7t1-studio/n8n-nodes-social-media-scheduler/blob/main/templates/youtube-to-linkedin-and-x.json) | Cada novo vídeo do seu canal é compartilhado no LinkedIn e no X 30 minutos depois. |
| [Google Sheets content calendar](https://github.com/7t1-studio/n8n-nodes-social-media-scheduler/blob/main/templates/google-sheets-content-calendar.json) | As linhas marcadas como `ready` viram publicações agendadas; o status e o ID da publicação são gravados de volta. |
| [Slack alert on publish or failure](https://github.com/7t1-studio/n8n-nodes-social-media-scheduler/blob/main/templates/post-status-slack-alert.json) | Envia o link publicado, ou o motivo da falha, para um canal do Slack. |
| [Weekly analytics email](https://github.com/7t1-studio/n8n-nodes-social-media-scheduler/blob/main/templates/weekly-analytics-email.json) | Toda segunda-feira, os números da semana anterior de cada conta do Facebook, Instagram, YouTube, LinkedIn e X. |

Baixe um arquivo e, no n8n, abra **Workflows → Create workflow → ⋯ → Import from File**. Abra cada nó que mostrar um aviso e selecione a sua credencial. Os modelos de RSS e de análises também precisam de uma credencial **Header Auth** do n8n (Name `X-API-Key`, Value: sua chave de API) para o nó HTTP Request.

As notas de configuração de cada modelo estão no [README dos modelos](https://github.com/7t1-studio/n8n-nodes-social-media-scheduler/blob/main/templates/README.md). Os mesmos arquivos ficam no monorepo do Social media studio, em `apps/n8n-node/templates/`.

## Outras ferramentas de automação

Ainda não existe um app nativo do Zapier ou do Make. Ambos podem chamar a mesma API REST e receber os mesmos webhooks: veja [Zapier](/pt-BR/integrations/zapier.md) e [Make](/pt-BR/integrations/make.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.