Conecta Meta con un token (System User)

Paso 1 — Abre la Configuración del negocio

Ve al Business Manager de Meta e inicia sesión con una cuenta de administrador.

Abrir Meta Business Settings

ℹ️ Si gestionas varios negocios, comprueba arriba a la izquierda que tienes seleccionado el negocio correcto — el que es propietario de la cuenta publicitaria.

Paso 2 — Crea un usuario del sistema

Un usuario del sistema (System User) es un "usuario técnico" del negocio, pensado específicamente para integraciones.

1. En el menú de la izquierda, ve a Usuarios → Usuarios del sistema.
2. Haz click en Añadir.
3. Ponle un nombre reconocible, p. ej. RoyLead Sync.
4. Rol: Empleado — basta con acceso de lectura, no hace falta Admin. Haz click en Crear usuario del sistema.

Paso 3 — Asigna la cuenta publicitaria

El token solo funciona en los activos que asignes explícitamente a este usuario.

1. Con el usuario del sistema seleccionado, haz click en Asignar activos.
2. En Cuentas publicitarias, selecciona la cuenta que quieres conectar.
3. En los permisos, activa solo el interruptor "Ver el rendimiento" (bajo Acceso parcial): es el acceso de lectura que necesita ads_read. Deja apagados "Gestionar campañas" y "Control total".
4. Haz click en Asignar activos.

⚠️ Si te saltas este paso, al conectar la cuenta verás un error de permisos: el token sería válido pero "no vería" ninguna cuenta.

Paso 4 — Prepara la app

El token se genera a través de una app del negocio, y el usuario del sistema necesita un rol en esa app. Si ya tienes una app vinculada al usuario del sistema, pasa al Paso 5.

Crea la app (si no tienes una)

No hace falta la aprobación de Meta: la app es solo el "contenedor" técnico del token, y sirve cualquier app del negocio con la Marketing API.

1. Ve a Configuración del negocio → Cuentas → Apps → Añadir → "Crear un nuevo ID de app".

2. Nombre de la app: p. ej. RoyLead Sync (el email de contacto ya es el tuyo).

3. Casos de uso: deja seleccionado "Crear y gestionar anuncios con la API de Marketing" (la primera opción, marcada por defecto).

4. Negocio: vincula la app a tu portfolio de negocio para que pertenezca al negocio correcto.
5. Revisa el Resumen y haz click en Crear app. La Marketing API ya está incluida gracias al caso de uso elegido.

Vincula la app al usuario del sistema

No basta con crear la app: el usuario del sistema necesita un rol en la app, si no, el paso "Asignar permisos" del token queda vacío.

1. Ve a Cuentas → Apps y selecciona tu app.
2. Haz click en Asignar personas.

3. Selecciona el usuario del sistema roylead, activa el interruptor "Desarrollar app" y haz click en Asignar.

Paso 5 — Genera el token

1. En el usuario del sistema, haz click en Generar nuevo token.
2. Selecciona tu app de la lista (la que preparaste en el Paso 4).
3. Entre los permisos, marca ads_read.
4. Expiración del token: puedes ponerla en Nunca para una conexión permanente.
5. Haz click en Generar token y cópialo enseguida.

⚠️ Si en el paso "Asignar permisos" ves "No hay permisos disponibles", la app no está vinculada al usuario del sistema: completa el Paso 4 y vuelve a intentarlo.

🔒 Meta muestra el token solo una vez. Si lo pierdes no hay problema: genera otro y vuelve a pegarlo en RoyLead.

Paso 6 — Encuentra el ID de la cuenta publicitaria

1. En la Configuración del negocio, ve a Cuentas → Cuentas publicitarias.
2. Selecciona la cuenta: el ID es el número mostrado (p. ej. 123456789012345).

RoyLead acepta tanto el número solo como el formato act_123456789012345.

Paso 7 — Pega todo en RoyLead

1. Abre la sección Publicidad en RoyLead.
2. Haz click en Conectar cuenta y elige Facebook · con token.
3. Pega el token y el ID de cuenta, luego confirma.

Ir a Publicidad ↗

RoyLead valida de inmediato el token con Meta, obtiene automáticamente el nombre y la moneda de la cuenta (no los eliges tú) y guarda la conexión.

Paso 8 — Comprueba

• La cuenta aparece en la lista con el estado Conectado.
• La sincronización automática se ejecuta cada pocas horas; también puedes forzarla con el botón Sincronizar.
• Tras la primera sincronización, el gasto y el ROI aparecen en Analytics junto a tus leads.

Token y app: cómo conviven

El token manual y "Iniciar sesión con Facebook" (OAuth) son dos formas de conseguir lo mismo: permiso para leer los datos de la cuenta. Puedes usar el token ahora y pasarte a OAuth cuando quieras, sin perder los datos históricos.

ℹ️ Un aviso: el token está vinculado a la app de Meta usada para generarlo. Si esa app es suspendida por Meta, tanto el token como el OAuth dejan de funcionar. El token te protege de problemas en el flujo de login, no de una suspensión de la app.

Si el token caduca o deja de funcionar

Si generas un token con caducidad y esta llega, o lo revocas desde Business Manager, RoyLead marca la cuenta con un estado de error.

Para arreglarlo: en la tarjeta de la cuenta, menú ⋯ → Editar credenciales, pega el nuevo token y guarda. No hace falta rehacer toda la conexión.

Solución de problemas

💡 Genera el token con expiración Nunca para evitar interrupciones: es la opción más cómoda para una sincronización continua.

Buenas prácticas

• 🔑 Usa un usuario del sistema dedicado para RoyLead: revocar su token solo bloquea esta integración.
• 🔒 Asigna al usuario del sistema solo las cuentas publicitarias que realmente quieres sincronizar.
• 🚨 Trata el token como una contraseña: si crees que se ha filtrado, regenéralo en Business Manager y vuelve a pegarlo.