Cómo usar la integración de Postoria con n8n

La integración de Postoria con n8n te permite crear flujos automatizados de publicación en redes sociales dentro de n8n sin tener que llamar manualmente a la API pública de Postoria.

Puedes utilizar el nodo comunitario oficial y verificado de Postoria para listar espacios de trabajo y cuentas sociales, subir o importar contenido multimedia, publicar contenido inmediatamente, programar publicaciones, añadir publicaciones a colas, listar publicaciones existentes, consultar su estado y eliminarlas de Postoria.

La integración está disponible en los planes Pro y Agency.

Disponibilidad actual

El nodo oficial de Postoria está disponible como nodo comunitario verificado tanto en n8n Cloud como en instalaciones de n8n autohospedadas.

El nombre del paquete es:

@postoria/n8n-nodes-postoria

  • n8n Cloud: busca Postoria directamente desde el lienzo del flujo de trabajo y añade el nodo al flujo.
  • n8n autohospedado: instala el paquete desde Settings → Community Nodes o selecciónalo directamente si tu versión de n8n incluye nodos comunitarios verificados.

En algunas instalaciones, puede que tengas que reiniciar la instancia de n8n y activar Verified Community Nodes en el panel de administración para que aparezca el nodo.

Antes de empezar

Necesitas:

  • Un plan Pro o Agency de Postoria activo.
  • Una clave de la API pública de Postoria.
  • Acceso a n8n Cloud o a una instancia de n8n autohospedada.
  • Una cuenta de n8n con rol Owner o Admin si necesitas instalar o activar nodos comunitarios.

El nodo de Postoria se conecta directamente a la API pública de Postoria. Tu clave de API se guarda en el sistema de credenciales de n8n.

Añade el nodo de Postoria a n8n

n8n Cloud

  1. Abre un flujo de trabajo.
  2. Haz clic para añadir un nodo.
  3. Busca Postoria.
  4. Selecciona el nodo verificado de Postoria y añádelo al flujo.

No es necesario instalar manualmente ningún paquete npm.

n8n autohospedado

  1. Abre tu instancia de n8n autohospedada.
  2. Ve a Settings.
  3. Abre Community Nodes.
  4. Haz clic en Install.
  5. Introduce el nombre del paquete:

@postoria/n8n-nodes-postoria

  1. Confirma que entiendes los riesgos de instalar un paquete comunitario.
  2. Haz clic en Install.

Después de la instalación, busca Postoria en el panel de nodos y añádelo a un flujo como cualquier otro nodo de n8n.

Algunas implementaciones autohospedadas pueden requerir que se reinicie n8n después de la instalación. Si tu implementación de n8n utiliza el modo de cola, asegúrate de que todos los workers que puedan ejecutar el flujo tengan instalada la misma versión del paquete.

Crea una clave de la API pública de Postoria

  1. Abre Postoria Settings.
  2. Busca la sección Public API.
  3. Haz clic en Create API key.
  4. Copia la clave y guárdala de forma segura.

Postoria muestra la clave completa una sola vez. Después de cerrar el cuadro de diálogo, solo verás su prefijo.

Si pierdes la clave, revócala y crea una nueva.

Puedes obtener más información sobre las claves y el comportamiento de la API en el artículo de ayuda sobre la API pública de Postoria.

Añade las credenciales de Postoria en n8n

  1. Crea un flujo de trabajo en n8n.
  2. Añade el nodo Postoria.
  3. En el campo de credenciales, elige Create new credential.
  4. Selecciona Postoria API.
  5. Pega tu clave de la API pública de Postoria.
  6. Ejecuta la prueba de credenciales.
  7. Guarda la credencial.

Puedes reutilizar la misma credencial en varios nodos de Postoria dentro de tus flujos de n8n.

Crea tu primer flujo de Postoria

Un primer flujo sencillo consiste en listar los espacios de trabajo de Postoria disponibles para tu cuenta.

  1. Añade un nodo Manual Trigger.
  2. Añade un nodo Postoria y conéctalo al disparador.
  3. Selecciona:
    • Resource: Workspace
    • Operation: Get Many
  4. Selecciona tu credencial de Postoria.
  5. Haz clic en Execute workflow.

El resultado contiene los identificadores, nombres y zonas horarias de los espacios de trabajo disponibles. Las demás operaciones de Postoria utilizan el espacio de trabajo que selecciones en el nodo.

Recursos y operaciones disponibles

El nodo de Postoria admite actualmente los siguientes recursos:

Workspace

  • Get Many — lista los espacios de trabajo disponibles para tu cuenta de Postoria.

Social Account

  • Get Many — lista las cuentas sociales conectadas a un espacio de trabajo seleccionado.

Utiliza los identificadores de cuenta devueltos cuando crees publicaciones.

Queue

  • Get Many — lista las colas de publicación de un espacio de trabajo seleccionado.

Utiliza el identificador de cola devuelto cuando añadas una publicación a una cola.

Media

  • Upload Binary — sube datos binarios recibidos de otro nodo de n8n.
  • Import From URL — importa contenido multimedia desde una URL HTTPS pública.
  • Get — obtiene un elemento multimedia y consulta su estado actual.

Post

  • Create — publica inmediatamente, programa una publicación o la añade a una cola.
  • Get — obtiene una publicación mediante su identificador.
  • Get Many — lista publicaciones con filtros y paginación opcionales.
  • Delete — elimina una publicación de Postoria.

Eliminar una publicación de Postoria no retira de una red social el contenido que ya se haya publicado.

Publica contenido inmediatamente

  1. Añade un nodo Postoria.
  2. Selecciona:
    • Resource: Post
    • Operation: Create
  3. Selecciona el espacio de trabajo.
  4. Configura Publish Mode como Publish Now.
  5. Selecciona una o varias cuentas sociales.
  6. Añade el texto y cualquier ajuste opcional de la publicación.
  7. Añade los identificadores de contenido multimedia si la publicación incluye archivos subidos o importados.
  8. Ejecuta el nodo.

El nodo devuelve la publicación creada en Postoria y su estado inicial.

Programa una publicación

  1. Selecciona:
    • Resource: Post
    • Operation: Create
  2. Selecciona el espacio de trabajo y las cuentas sociales.
  3. Configura Publish Mode como Schedule.
  4. Introduce la fecha y la hora programadas.
  5. Añade el texto, el contenido multimedia, el enlace y cualquier ajuste específico de cada red.
  6. Ejecuta el nodo.

Puedes utilizar una expresión de n8n para definir una programación relativa. Por ejemplo, esta expresión programa la publicación dos horas después de la ejecución del flujo:

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

Añade una publicación a una cola

  1. Selecciona:
    • Resource: Post
    • Operation: Create
  2. Selecciona el espacio de trabajo.
  3. Configura Publish Mode como Add to Queue.
  4. Selecciona la cola.
  5. Selecciona las cuentas sociales.
  6. Añade el contenido de la publicación.
  7. Ejecuta el nodo.

La cola debe existir previamente en el espacio de trabajo de Postoria seleccionado. Puedes crear y administrar colas desde la aplicación web de Postoria.

Importa contenido multimedia desde una URL pública

Utiliza Media → Import From URL cuando una imagen, un vídeo o un documento ya estén disponibles mediante una URL HTTPS pública.

  1. Añade un nodo de Postoria antes del nodo que crea la publicación.
  2. Selecciona:
    • Resource: Media
    • Operation: Import From URL
  3. Selecciona el espacio de trabajo.
  4. Introduce la URL HTTPS pública.
  5. Ejecuta el nodo.

El nodo inicia la importación del contenido multimedia y comprueba automáticamente el estado del procesamiento. Solo devuelve un resultado cuando el archivo está listo para utilizarse o cuando se alcanza el tiempo de espera del procesamiento.

Asigna el file_id devuelto al campo Media IDs del nodo de Postoria que crea la publicación.

Sube contenido multimedia binario

Utiliza Media → Upload Binary cuando un nodo anterior de n8n proporcione el archivo como datos binarios.

Por ejemplo, los datos binarios pueden proceder de un nodo HTTP Request, un nodo de almacenamiento en la nube, un webhook, el envío de un formulario u otro paso de procesamiento de archivos.

  1. Conecta el nodo que proporciona el archivo binario a un nodo de Postoria.
  2. Selecciona:
    • Resource: Media
    • Operation: Upload Binary
  3. Selecciona el espacio de trabajo.
  4. Introduce el nombre de la propiedad binaria. El valor predeterminado es data.
  5. Ejecuta el nodo.

El nodo de Postoria realiza todo el proceso de carga:

  1. Crea una carga multimedia en Postoria.
  2. Sube el archivo binario.
  3. Completa la carga.
  4. Comprueba el estado del procesamiento cada cinco segundos.
  5. Devuelve el contenido multimedia cuando alcanza el estado ready.

El tiempo de espera predeterminado del procesamiento es de 600 segundos. Puedes cambiarlo en los ajustes del nodo cuando un archivo grande necesite más tiempo.

Los formatos de carga compatibles incluyen JPEG, PNG, WebP, GIF, MP4, MOV y PDF.

Una vez completada la carga, asigna el file_id devuelto al campo Media IDs del nodo que crea la publicación.

Comportamiento de la fecha y la zona horaria

Postoria interpreta las fechas programadas utilizando la zona horaria del flujo de n8n.

Antes de programar publicaciones, abre los ajustes del flujo en n8n y confirma que la zona horaria sea correcta.

El nodo procesa las fechas de la siguiente manera:

  • Una fecha que contiene Z se interpreta como UTC.
  • Una fecha que contiene un desplazamiento explícito conserva ese momento exacto.
  • Una fecha local sin desplazamiento se interpreta en la zona horaria del flujo de n8n y se convierte a UTC antes de enviarse a Postoria.

Por ejemplo:

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

Utilizar la zona horaria del flujo ayuda a evitar que cambie la hora de las publicaciones programadas cuando el servidor de n8n se ejecuta en otra región.

Utiliza Postoria como herramienta de un AI Agent

El nodo de Postoria también puede conectarse a la entrada Tool de un AI Agent de n8n.

  1. Añade un nodo AI Agent.
  2. Conecta un Chat Model compatible.
  3. Haz clic en el conector Tool del AI Agent.
  4. Añade el nodo Postoria.
  5. Selecciona el recurso y la operación de Postoria que el agente podrá utilizar.

Un ejemplo sencillo y seguro es:

  • Resource: Workspace
  • Operation: Get Many

El agente podrá responder entonces a una solicitud como esta:

Lista mis espacios de trabajo de Postoria.

Para las acciones que publican, programan, añaden contenido a una cola o eliminan publicaciones, revisa el espacio de trabajo, las cuentas sociales, el contenido, los archivos multimedia y la hora programada antes de ejecutar el flujo.

Ideas de flujos de ejemplo

El nodo de Postoria puede combinarse con otros nodos de n8n para crear flujos como los siguientes:

  • Importar un artículo nuevo desde un CMS y programar una publicación en redes sociales.
  • Leer publicaciones aprobadas desde Google Sheets y añadirlas a una cola de Postoria.
  • Recibir un webhook, importar una imagen y publicar inmediatamente.
  • Descargar contenido multimedia desde un almacenamiento en la nube y subirlo a Postoria.
  • Generar un texto con un nodo de IA y enviarlo a Postoria para su revisión o publicación.
  • Listar las publicaciones programadas y enviar un resumen diario por correo electrónico o Slack.

Paquete y código fuente

El paquete npm está disponible aquí:

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

La integración es de código abierto en GitHub:

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