n8n

• 1. Abre el panel de nodos. En un flujo de trabajo, haz clic en «+» y busca «Sofia».
• 2. Instala el nodo. Selecciona Sofia y luego «Install node». El propietario de la instancia lo instala una vez, para todos los miembros.
• 3. O instala el paquete. En una instancia autoalojada, abre «Settings › Community nodes › Install» e introduce el nombre del paquete n8n-nodes-sofia-post.

• 1. Crea una clave personal. En los ajustes, página «Sofia API», pestaña «Acceso personal», «Nueva clave». Solo se muestra una vez.
• 2. Crea la credencial en n8n. Añade una credencial «Sofia API» y pega la clave en el campo «Personal Key» (sofia_pk_live_…). Deja «API URL» como está; n8n prueba la clave con GET /v1/me.
• 3. Úsala en un flujo de trabajo. Una sola credencial llega a todos tus establecimientos, con tus derechos.

Las listas «Establishment» y «Accounts» se rellenan a partir de tus establecimientos y tus cuentas conectadas. Deja «Schedule At» vacío para publicar ahora; una fecha se lee en la zona horaria del flujo de trabajo. «Draft» guarda la publicación sin publicarla. Un campo incoherente (borrador con fecha, dirección de archivo incompleta) se rechaza antes de que se cree la publicación.

• 1. Crea la publicación. Añade un nodo «Sofia» en «Post › Create», elige un establecimiento y sus cuentas, escribe el texto y luego añade «Media URLs» y «Schedule At» en «Additional Fields».
• 2. Lee su estado. Añade un segundo nodo «Sofia» en «Post › Get» y dale el id devuelto por el paso anterior. Cuando la publicación ha salido, su status es published, partial o failed, con el enlace y la respuesta de cada red.
• 3. Reacciona ante un fallo. Inicia otro flujo de trabajo con un nodo «Sofia Trigger» en «Post Failed» y conéctalo a un nodo de Slack o de correo electrónico con el mensaje de abajo.

{{ $json.platforms }}: {{ $json.errors }}

El disparador sondea Sofia. Empieza por las publicaciones que aparecen después de activar el flujo de trabajo: las anteriores no se vuelven a procesar. «Fetch Test Event» muestra la última publicación para que puedas asignar sus campos, y si eliges un establecimiento solo se vigila ese.

• 401: la clave ya no es válida, crea una nueva y pégala en la misma credencial.
• 429: demasiadas llamadas; el error indica cuántos segundos esperar antes de reintentar.
• Cualquier otro rechazo: el error de Sofia, con su código, se muestra en n8n. Con «Continue On Fail», un elemento rechazado se convierte en un elemento error en lugar de detener el flujo de trabajo.

Usa n8n cuando tus automatizaciones ya están ahí. Prefiere Zapier si tus herramientas se conectan a él, y los webhooks o Sofia API cuando escribes código.