> ## 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.

# Nodo de automatización de redes sociales para n8n

> Instala el nodo de la comunidad de Social media studio en n8n autoalojado para programar publicaciones, gestionar borradores y medios, y lanzar flujos de trabajo a partir de eventos.

[n8n](https://n8n.io/) es una herramienta de automatización de flujos de trabajo de código abierto. El paquete oficial de nodos de la comunidad, **`@social-media-scheduler/n8n-nodes-social-media-scheduler`**, permite que un flujo de n8n cree y programe publicaciones, gestione borradores, suba medios, lea tus cuentas conectadas y reaccione a eventos de publicación.

## Los dos nodos

El paquete incluye dos nodos. Ambos usan la misma credencial **Social Media Studio API**.

| Nodo | Tipo | Finalidad |
| - | - | - |
| **Social Media Studio** | Acción | Ejecutar operaciones sobre publicaciones, borradores, medios y cuentas sociales. |
| **Social Media Studio Trigger** | Disparador | Iniciar un flujo cuando se crea, programa o publica una publicación, o falla, cuando un borrador se convierte en publicación o cuando se alcanza un límite de cuota. |

### Operaciones

| Recurso | Operaciones |
| - | - |
| 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 |

Las publicaciones y los borradores pueden ir a Twitter/X, Instagram, LinkedIn (personal y Page), Facebook, TikTok, YouTube, Threads, Pinterest, Dribbble, Bluesky, Mastodon, WordPress, Dev.to, Discord y Slack. Los tipos de publicación y las opciones disponibles dependen de la cuenta de destino.

### Eventos del disparador

| Evento | Se dispara cuando |
| - | - |
| `post.created` | Se crea una publicación. |
| `post.scheduled` | Se programa una publicación. |
| `post.published` | Una publicación se publica en la plataforma. |
| `post.failed` | Una publicación no se puede publicar. |
| `draft.converted` | Un borrador se convierte en publicación. |
| `quota.limit_reached` | Tu plan alcanza un límite de uso. |

El nodo Trigger gestiona su propia suscripción de webhook. Registra una suscripción cuando activas el flujo y la elimina cuando lo desactivas. Comprueba la firma **HMAC-SHA256** de cada entrega y responde HTTP 401 ante una firma ausente o incorrecta. Consulta [Payloads de webhook](/es/webhooks/payloads.md) para ver el cuerpo de cada evento.

> [!NOTE]
>
> Social media studio debe poder acceder a la URL de webhook de tu n8n. Una instancia de n8n autoalojada en `localhost` necesita una URL pública (por ejemplo, un túnel) antes de que el nodo Trigger pueda recibir eventos.

## Autenticación

Ambos nodos usan una única credencial de clave de API.

**1. Crea una clave de API**

En el panel de Social media studio, ve a **Ajustes → Claves de API** y crea una clave. Consulta [Autenticación](/es/authentication.md) para más detalles.

**2. Añade la credencial en n8n**

En n8n, crea una credencial **Social Media Studio API** nueva y pega tu clave. n8n envía la clave en el encabezado `X-API-Key` y la prueba cuando guardas la credencial.

> [!NOTE]
>
> Mantén la **Base URL** por defecto (`https://api.so-me.studio`) a menos que ejecutes tu propio backend de Social media studio.

## Instalación

**1. Abre Community Nodes**

En n8n, ve a **Settings → Community Nodes → Install**.

**2. Instala el paquete**

Introduce `@social-media-scheduler/n8n-nodes-social-media-scheduler` y confirma. Los nodos **Social Media Studio** y **Social Media Studio Trigger** aparecen en el panel de nodos.

En una instancia de n8n autoalojada, también puedes instalarlo directamente:

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

> [!NOTE]
>
> n8n requiere Node.js 20 o posterior para ejecutar nodos de la comunidad.

> [!WARNING]
>
> No es un nodo de la comunidad verificado, por lo que solo está disponible en **n8n autoalojado**. n8n Cloud no ofrece nodos de la comunidad sin verificar.

## Ejemplo: publicar una publicación con una imagen

**1. Sube la imagen**

Añade un nodo **Social Media Studio** con **Media → Upload to Library**. Establece **Binary Property** en el campo binario que contiene la imagen. El nodo sube y verifica el archivo y devuelve su ID de archivo.

**2. Elige la cuenta**

Añade un segundo nodo **Social Media Studio** con **Post → Create**. Establece **Platform** y **Post Type**, y luego selecciona el destino en **Account Name or ID**.

**3. Adjunta la imagen y programa**

Pon el ID de archivo del paso 1 en **Media Library File IDs**, escribe el **Text** y establece **Schedule For**. Deja **Schedule For** vacío para publicar ahora.

> [!TIP]
>
> Ejecuta **Media → Validate** antes de programar una publicación. Comprueba cada archivo con las reglas de cada destino e indica qué archivos rechazará una plataforma.

## Hilos y primeros comentarios

**Post → Create**, **Update** y **Schedule**, y **Draft → Create**, **Update** y **Convert to Post**, tienen los campos **Thread Parts** y **First Comment**. El campo **Text** es la primera parte del hilo, y las partes del hilo siguen en orden. Los hilos funcionan en Twitter/X, Threads, Bluesky y Mastodon.

## TikTok

Antes de publicar en TikTok, ejecuta **Social Account → Get TikTok Creator Info** y elige uno de los niveles de privacidad que devuelve. TikTok rechaza una publicación sin un nivel de privacidad permitido.

## Plantillas de n8n

Cinco flujos de trabajo listos para importar. Cada uno usa solo el nodo publicado y los nodos integrados de n8n; la nota adhesiva amarilla de cada lienzo indica qué cambiar.

| Plantilla | Qué hace |
| - | - |
| [RSS → AI caption → X](https://github.com/7t1-studio/n8n-nodes-social-media-scheduler/blob/main/templates/rss-ai-caption-to-x.json) | Cada elemento nuevo del feed obtiene una publicación de X redactada con IA, programada con dos horas de antelación y con el enlace. |
| [YouTube → LinkedIn and X](https://github.com/7t1-studio/n8n-nodes-social-media-scheduler/blob/main/templates/youtube-to-linkedin-and-x.json) | Cada vídeo nuevo de tu canal se comparte en LinkedIn y X 30 minutos después. |
| [Google Sheets content calendar](https://github.com/7t1-studio/n8n-nodes-social-media-scheduler/blob/main/templates/google-sheets-content-calendar.json) | Las filas marcadas como `ready` se convierten en publicaciones programadas; el estado y el ID de la publicación se escriben de vuelta. |
| [Slack alert on publish or failure](https://github.com/7t1-studio/n8n-nodes-social-media-scheduler/blob/main/templates/post-status-slack-alert.json) | Publica el enlace público, o el motivo del fallo, en un canal de Slack. |
| [Weekly analytics email](https://github.com/7t1-studio/n8n-nodes-social-media-scheduler/blob/main/templates/weekly-analytics-email.json) | Cada lunes, las cifras de la semana pasada de cada cuenta de Facebook, Instagram, YouTube, LinkedIn y X. |

Descarga un archivo y, en n8n, abre **Workflows → Create workflow → ⋯ → Import from File**. Abre cada nodo que muestre una advertencia y selecciona tu credencial. Las plantillas de RSS y analíticas también necesitan una credencial **Header Auth** de n8n (Name `X-API-Key`, Value: tu clave de API) para el nodo HTTP Request.

Las notas de configuración de cada plantilla están en el [README de las plantillas](https://github.com/7t1-studio/n8n-nodes-social-media-scheduler/blob/main/templates/README.md). Los mismos archivos se mantienen en el monorepo de Social media studio, en `apps/n8n-node/templates/`.

## Otras herramientas de automatización

Todavía no existe una app nativa de Zapier ni de Make. Ambas pueden llamar a la misma API REST y recibir los mismos webhooks: consulta [Zapier](/es/integrations/zapier.md) y [Make](/es/integrations/make.md).


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