Guía de Configuración: Meta Publisher para n8n

1. Instalación del Nodo

Dado que este es un nodo de la comunidad, no viene preinstalado en n8n.

1. Ve a tu instancia de n8n.

2. Haz clic en Settings (Configuración) > Community Nodes.

3. Haz clic en Install.

4. Pega el nombre del paquete npm:Plaintext

   n8n-nodes-meta-publisher

5. Acepta los riesgos y confirma la instalación. Una vez instalado, reinicia n8n si es necesario (aunque usualmente es inmediato).

2. Requisitos Previos (Meta & Facebook)

Antes de configurar el flujo, necesitas credenciales válidas. La API de Meta es estricta.

1. Cuenta de Instagram Business: Tu cuenta de Instagram debe ser "Professional" o "Business" y estar vinculada a una Facebook Page.
2. Meta for Developers App:
   • Crea una app en developers.facebook.com.
   • Tipo de App: Business.
3. Permisos del Token (Scopes): Necesitas generar un Access Token (preferiblemente de larga duración o de Sistema) con los siguientes permisos:
   • instagram_basic
   • instagram_content_publish
   • pages_show_list
   • pages_read_engagement
4. Obtener el igUserId:
   • No es tu nombre de usuario ("@usuario"). Es un ID numérico largo.
   • Puedes obtenerlo usando el Graph API Explorer con la consulta: me/accounts?fields=instagram_business_account.

3. Importar el Flujo de Trabajo

He limpiado y optimizado el JSON que compartiste para que funcione como una plantilla robusta.

Instrucciones: Copia el siguiente código JSON y pégalo directamente en tu lienzo (canvas) de n8n (Ctrl+V / Cmd+V).

JSON

{ "nodes": [ { "parameters": {}, "id": "69b8b0cb-f989-4f91-9973-26d6b4f4f6f1", "name": "Trigger Manual", "type": "n8n-nodes-base.manualTrigger", "typeVersion": 1, "position": [ -560, 464 ] }, { "parameters": { "assignments": { "assignments": [ { "id": "ig-user-id", "name": "igUserId", "value": "PON_AQUI_TU_IG_USER_ID_NUMERICO", "type": "string" }, { "id": "media-url", "name": "mediaUrl", "value": "<https://images.unsplash.com/photo-1546552356-3fae876a61ca?w=1080&q=80>", "type": "string" }, { "id": "story-kind", "name": "storyKind", "value": "image", "type": "string" }, { "id": "caption", "name": "caption", "value": "Probando automatización con n8n 🚀", "type": "string" } ] }, "options": {} }, "id": "f6579ee3-3aba-4768-9bee-71f08bfe5cc7", "name": "Configurar Datos", "type": "n8n-nodes-base.set", "typeVersion": 3.4, "position": [ -340, 464 ] }, { "parameters": { "operation": "publishStory", "pollSec": 5, "maxWaitSec": 120, "igUserId": "={{ $json.igUserId }}", "storyKind": "={{ $json.storyKind }}", "mediaUrl": "={{ $json.mediaUrl }}", "caption": "={{ $json.caption }}" }, "id": "25b6d1f3-4a5f-43a5-a84b-3dff4e812cb1", "name": "Meta Publisher", "type": "n8n-nodes-meta-publisher.metaPublisher", "typeVersion": 1, "position": [ -120, 464 ], "credentials": { "metaGraphApi": { "id": "", "name": "Meta Graph (Access Token) account" } } }, { "parameters": { "conditions": { "options": { "caseSensitive": true, "leftValue": "", "typeValidation": "strict", "version": 1 }, "conditions": [ { "id": "condition-published", "leftValue": "={{ $json.published }}", "rightValue": true, "operator": { "type": "boolean", "operation": "equals" } } ] }, "combinator": "and" }, "id": "22d141aa-bc9c-4967-a68d-e673d54c8a11", "name": "¿Publicado?", "type": "n8n-nodes-base.if", "typeVersion": 2, "position": [ 100, 464 ] }, { "parameters": { "assignments": { "assignments": [ { "id": "success-message", "name": "mensaje", "value": "✅ Historia publicada exitosamente", "type": "string" }, { "id": "creation-id", "name": "creationId", "value": "={{ $json.creationId }}", "type": "string" }, { "id": "status", "name": "status", "value": "={{ $json.status }}", "type": "string" } ] }, "options": {} }, "id": "89ba655e-2822-4876-86f9-a27a17a00e32", "name": "Éxito", "type": "n8n-nodes-base.set", "typeVersion": 3.4, "position": [ 340, 360 ] }, { "parameters": { "assignments": { "assignments": [ { "id": "error-message", "name": "mensaje", "value": "❌ Error al publicar historia", "type": "string" }, { "id": "error-details", "name": "error", "value": "={{ $json }}", "type": "object" } ] }, "options": {} }, "id": "370d18d4-befb-4444-b5be-209261eeed98", "name": "Error", "type": "n8n-nodes-base.set", "typeVersion": 3.4, "position": [ 340, 560 ] } ], "connections": { "Trigger Manual": { "main": [ [ { "node": "Configurar Datos", "type": "main", "index": 0 } ] ] }, "Configurar Datos": { "main": [ [ { "node": "Meta Publisher", "type": "main", "index": 0 } ] ] }, "Meta Publisher": { "main": [ [ { "node": "¿Publicado?", "type": "main", "index": 0 } ] ] }, "¿Publicado?": { "main": [ [ { "node": "Éxito", "type": "main", "index": 0 } ], [ { "node": "Error", "type": "main", "index": 0 } ] ] } }, "pinData": {} }

4. Configuración Paso a Paso

A. Nodo: Configurar Datos (Set)

Este nodo prepara el "Payload" que necesita Meta. Es importante no usar datos "quemados" (hardcoded) dentro del nodo Publisher para mantener el flujo dinámico.

• igUserId: Reemplaza el valor PON_AQUI_TU_IG_USER_ID_NUMERICO con el ID que obtuviste en el paso 2.
• mediaUrl: La URL debe ser pública.
  • Nota: En tu JSON original usabas un link de Dropbox Preview. Estos links suelen caducar o requieren autenticación, lo que hará que Facebook falle al intentar descargar la imagen. Usa servicios como AWS S3, Google Cloud Storage público, o incluso el almacenamiento de archivos de n8n si tienes el túnel activado.
• storyKind: Puede ser image o video.

B. Nodo: Meta Publisher

Este es el núcleo de la automatización.

1. Haz doble clic en el nodo Meta Publisher.
2. Credenciales:
   • Selecciona "Create New Credential" (o selecciona una existente).
   • Nombre: Meta Graph API.
   • Access Token: Pega aquí el token que generaste en la App de Meta.
3. Resource: Selecciona Instagram.
4. Operation: Selecciona Publish Story.
5. Mapeo de Campos:
   • Observa que los campos IG User ID, Media URL y Caption están configurados como expresiones (ej. {{ $json.mediaUrl }}). Esto lee automáticamente lo que configuraste en el nodo anterior.
6. Polling (Sondeo):
   • He configurado Poll Interval en 5 segundos. Esto significa que n8n preguntará a Facebook cada 5 segundos: "¿Ya está lista la imagen para publicarse?". Una vez que Facebook dice "Sí", el nodo finaliza.

C. Nodo: ¿Publicado? (If)

Este nodo verifica la respuesta del nodo Publisher.

• El nodo Publisher devuelve un campo booleano llamado published.
• Si published es true → Va al camino de Éxito.
• Si es false o no existe → Va al camino de Error.

5. Solución de Problemas Comunes