Cómo conectar Meta (Facebook e Instagram) a Merez

Vas a conectar la página de Facebook de tu negocio y su cuenta de Instagram a Merez para publicar desde el módulo de Publicación, sin abrir cada red por separado. Lo que configuras son dos datos de tu app de Meta, el App ID y el App Secret, más una dirección de vuelta. Aquí están los nombres exactos, dónde se consigue cada dato y las pruebas para confirmar que la publicación sale sola.

Qué necesitas antes de empezar

Revisa la lista completa antes de abrir Merez. Si falta una pieza, la conexión se cae a mitad de camino y el error aparece lejos de la causa real.

• Cuenta de desarrollador de Meta. Se registra en developers.facebook.com con tu cuenta de Facebook. Sin este registro no existe el App Dashboard y no hay dónde crear la app.
• Una app de Meta. Se crea en el App Dashboard y es la que aporta el App ID y el App Secret. Lo sano es una app para pruebas y otra para producción, así un experimento no toca la cuenta real del comercio.
• Los productos correctos dentro de la app. Meta nombra «Facebook Login for Business» y, dentro del menú de Instagram, la configuración de la API con inicio de sesión de Facebook. Hay una advertencia textual de Meta que conviene leer dos veces: una app puede usar Facebook Login o Instagram Login, pero no los dos.
• Cuenta de Instagram profesional. Debe ser de empresa o de creador y estar vinculada a la página de Facebook. Con una cuenta personal no hay publicación por API.
• Permiso real sobre la página. Quien autoriza necesita poder ejecutar la tarea de contenido o la de control total en la página, porque de ahí salen los permisos que Meta puede otorgar.
• Quién lo hace. Un administrador de la app en Meta y alguien con administración del sitio en Merez. Esto no es una tarea de marketing: es configuración y se hace una vez.

Las credenciales, una por una

Son tres datos y un permiso. La tabla usa los nombres de Meta, no traducciones libres, para que los encuentres tal cual en pantalla.

Campo	Qué es	Dónde se consigue exactamente
App ID	Identificador público de la app. Viaja en la URL del diálogo de autorización; no es secreto.	App Dashboard, «Configuración de la app» > «Básica», en developers.facebook.com/apps.
App Secret	Llave privada con la que el servidor canjea el código de autorización por un token. Con ella se pueden fabricar tokens de app que actúan en nombre de cualquier usuario.	La misma pantalla de configuración básica. Ahí mismo se restablece si se filtró, y no se puede rotar por API.
URI de redirección de OAuth válida	La dirección exacta a la que Meta devuelve la autorización. Si no coincide, Meta no devuelve nada.	«Productos» > «Facebook Login» > «Configuración» > «Client OAuth Settings». El valor debe ser https://api.merez.co/api/v1/content/meta/callback
Permisos	instagram_basic, instagram_content_publish, pages_read_engagement y pages_show_list. Sin el de publicación no se publica.	Se solicitan al autorizar y se aprueban en «App Review» > «Permissions and Features». Con acceso estándar solo sirven para usuarios con rol en la app.
Cuenta de Instagram vinculada	La cuenta profesional que cuelga de la página. No es una credencial, pero sin ella el flujo no publica en Instagram.	Se vincula desde la app de Instagram o desde Meta Business Suite, nunca desde Merez.

Dónde se pega cada cosa

El App ID y el App Secret van en Merez, en el módulo de Publicación, dentro de la integración de Meta. Los pegas, guardas y después pulsas Conectar. La URI de redirección no se pega en Merez: se registra en Meta. Si la dejas solo en Merez, la autorización nunca vuelve.

Al pulsar Conectar se abre la ventana de Meta y, en una sola autorización, se piden la página y su cuenta de Instagram. Por eso el botón no es un detalle: es el momento en que el comercio le dice a Meta qué permite.

Simulación de uso: de la plataforma a Merez

Pongamos un caso concreto. Trigo y Sal es una panadería de Medellín con página de Facebook y con @trigoysal.co en Instagram. Quiere programar el martes a las 8:00 un post con el enlace a su catálogo de tortas.

1. En Meta. El administrador entra al App Dashboard, confirma que la app tiene Facebook Login for Business y el producto de Instagram configurado, copia el App ID y el App Secret, y registra la vuelta con la dirección exacta: https://api.merez.co/api/v1/content/meta/callback.
2. En Merez. Pega los dos datos en la integración de Meta del módulo de Publicación, guarda y pulsa Conectar.
3. La autorización. Meta muestra qué va a permitir: administrar la página, leer su contenido y publicar en la cuenta de Instagram vinculada. Si el usuario desmarca la casilla de publicación, el resto funciona y la publicación falla después; ese es el error más común y el más difícil de diagnosticar.
4. La vuelta. Meta devuelve el código a la dirección registrada, Merez lo canjea en el servidor con el App Secret y guarda un token de larga duración. La pantalla queda en «Conectado» y muestra la página y la cuenta de Instagram reconocidas.
5. La pieza. Se crea la publicación con texto, imagen y el enlace al catálogo, se programa para el martes a las 8:00 y queda en estado «Programada».
6. El martes. Merez crea el contenedor de medios, espera a que esté listo, publica y guarda el identificador. La pieza pasa a «Publicada» y el enlace queda en la página y en el perfil de Instagram.

Ahora las dos variantes que más se ven. Si la app sigue en modo desarrollo, solo los usuarios con rol en la app pueden autorizar y publicar: el cliente final verá un error de permisos aunque la configuración sea impecable. Y si la página exige autorización de publicación, Meta bloquea la publicación hasta que el dueño la complete, sin importar lo que diga Merez.

Cuando algo falla del lado de Instagram, el estado del contenedor lo dice con una palabra: «ERROR» si el proceso se detuvo, «EXPIRED» si pasaron más de 24 horas sin publicarlo, «FINISHED» cuando ya se puede publicar. Ese estado es la primera pista, antes de tocar cualquier credencial.

Los permisos de publicación los otorga Meta, no Merez. Merez los usa y muestra el resultado; si Meta no aprobó un permiso, ninguna casilla de Merez lo arregla.

Cómo comprobar que quedó bien

No confíes en el mensaje «Conectado». Haz esta prueba con una pieza real y corta.

1. Una pieza de prueba. Publica ahora, no programes: texto de una línea, imagen JPEG y enlace al catálogo. La imagen importa porque la API de Instagram solo acepta JPEG y descarga el archivo desde una URL pública.
2. Mira el estado, no la ilusión. En Merez la pieza debe pasar de «Programada» a «Publicada» y guardar el identificador que devuelve Meta. Si se queda en «Error», el mensaje trae la causa.
3. Abre las dos redes. Entra a la página de Facebook y al perfil de Instagram desde otro navegador o sin sesión. Si el post aparece solo cuando estás logueado como administrador, la publicación no salió: la estás viendo por rol.
4. Revisa el consumo. Para Instagram, el endpoint de límite de publicación dice cuántas piezas llevas en la ventana de 24 horas. Si el contador no se mueve después de publicar, la publicación no ocurrió.
5. Repite con el usuario del cliente. Autoriza con una cuenta que no tenga rol en la app. Si ahí falla, el problema es el modo de la app o el nivel de acceso, no la pieza.

Errores frecuentes

Síntoma	Causa probable	Qué hacer
Después de autorizar, la ventana se queda en un error de redirección y Merez no recibe nada.	La URI registrada en Meta no es idéntica a la de Merez: barra final, http en vez de https o dominio distinto.	Registrar la dirección exacta en «Client OAuth Settings». Meta compara carácter por carácter.
Conecta bien, pero no aparece ninguna cuenta de Instagram.	La cuenta es personal o es profesional pero no está vinculada a la página.	Convertirla a profesional, vincularla a la página y volver a pulsar Conectar.
Todo conectado y al publicar responde que faltan permisos.	Se desmarcó instagram_content_publish al autorizar, o el permiso está en acceso estándar y quien autoriza no tiene rol en la app.	Reconectar aceptando todos los permisos; para usuarios sin rol hace falta acceso avanzado con App Review.
Funciona con tu usuario y falla con el del cliente.	La app está en modo desarrollo, donde solo operan los usuarios con rol.	Completar App Review y verificación de negocio, y pasar la app a modo Live.
La conexión funcionaba y dejó de hacerlo sin cambios aparentes.	El token de larga duración venció a los 60 días, o alguien restableció el App Secret y todos los tokens quedaron revocados.	Actualizar el App Secret en Merez si cambió y volver a conectar. Programa una revisión antes del día 60.
El contenedor de Instagram termina en «ERROR» o «EXPIRED».	La imagen no es JPEG, la URL no es pública en el momento de publicar, o el contenedor pasó 24 horas sin publicarse.	Corregir el archivo o la URL y volver a programar la pieza. Los contenedores no se reciclan.

Límites y buenas prácticas

• Lo que Merez no hace. No aprueba contenido, no compra verificación, no tramita permisos por ti y no publica si Meta no los dio. Tampoco puede saltarse el modo desarrollo.
• Límite de publicaciones. Instagram permite 100 publicaciones por API en una ventana móvil de 24 horas, y un carrusel cuenta como una sola.
• Vida de los tokens. El código de autorización dura una hora, el token corto una hora y el de larga duración 60 días. Se puede refrescar antes de que venza, pero no es eterno.
• Acceso avanzado. Servir cuentas que no son tuyas exige App Review y verificación de negocio, más el chequeo anual de uso de datos. Sin eso, la app solo funciona entre quienes tienen rol.
• Contenido y formato. La API de Instagram publica JPEG y descarga los medios desde un servidor público. Las etiquetas de compra y los filtros no están soportados.
• Seguridad. El App Secret nunca va en el navegador ni en un repositorio. Si se filtra, Meta puede restablecerlo y todas las integraciones dejan de funcionar hasta que lo actualices.