Conectar Instagram y Messenger — Guía completa BYOK

Modos de conexión disponibles

Desde Canales → Nuevo canal puedes conectar Instagram y Messenger (Facebook) a tu agente IA. Hay dos modos de conexión:

Modo	Para quién	Estado
Guiado · OAuth	Click en "Conectar con Facebook/Instagram" → autorizar → listo	Disponible
BYOK — Credenciales propias	Usuarios con app propia en Meta for Developers	Disponible

Esta guía cubre principalmente el modo BYOK (Bring Your Own Keys). El modo Guiado simplifica el flujo a un único click y autorización — recomendado si no tienes experiencia técnica con Meta.

Permisos de Meta — qué funciona en cada nivel

Cambio importante en 2026: Meta ha relajado las políticas de mensajería. Ahora puedes recibir Y responder mensajes dentro de la ventana de 24h sin necesidad de tener App Review aprobado en tu app. Esto cubre el 100% del caso de uso de atención al cliente reactiva.

Acción	Standard Access (sin App Review)	Advanced Access (con App Review)
Recibir mensajes de cualquier usuario	Sí	Sí
Responder dentro de ventana 24h	Sí	Sí
Auto-replies, instant replies, away messages	Sí	Sí
Mensajes proactivos (escribir primero)	No	Sí
Mensajes fuera de la ventana de 24h	No	Sí (con tags aprobados)
Marketing Messages / broadcasts	No	Sí
Human Agent tag (ventana 7 días)	No	Sí

Conclusión práctica: para atención al cliente reactiva (cliente escribe → tú respondes en 24h) BYOK funciona inmediatamente. Para mensajería proactiva (notificaciones automáticas, marketing) necesitas App Review aprobado en tu propia app de Meta.

Instagram — Flujo de conexión BYOK

Requisitos previos

Cuenta Instagram Business o Creator (no cuenta personal)
Acceso a Meta for Developers
Permisos de administrador en la app de Meta que vas a crear

Datos que necesitas tener a mano

Dato	Dónde encontrarlo
Instagram Account ID	Instagram → Configuración → Cuenta de Instagram → Identificador
Access Token (`IGQ...`)	Meta for Developers → tu app → Instagram → API Setup with Instagram Login

Importante sobre formatos de token:

IGQ... — Instagram Login API, válido 60 días con renovación automática (recomendado)
EAA... — Page Token vía System User, permanente
IGAA... — NO funcionan, Meta desactivó esta API en diciembre 2024

Pasos detallados

Ve a Meta for Developers y crea una app eligiendo "Otro — experiencia antigua"
Activa el producto Instagram → API Setup with Instagram Login
En Roles → Usuarios de prueba, añade tu propia cuenta de Instagram
Acepta la invitación desde Instagram: Configuración → Aplicaciones y sitios web → Invitaciones
Vuelve al panel Meta → Instagram → API Setup → "Generar identificadores de acceso" → añade tu cuenta → Generar identificador
Copia el token IGQ... generado
En MuseRelay, ve a Canales → Nuevo canal, elige Instagram → modo BYOK
Pega el token y el Instagram Account ID, y guarda
MuseRelay generará una URL de webhook y un Verify Token — cópialos
Vuelve a Meta Developers → Instagram → Webhooks y configura ambos valores
Suscríbete al menos al evento messages
Vuelve a MuseRelay y prueba la conexión

Por qué funciona sin App Review: al añadirte a ti mismo como tester en tu propia app, Meta te trata como desarrollador directo gestionando tu propia cuenta. El propio panel de Meta dice literalmente "puedes omitir App Review si solo gestionas tus propias cuentas". Cada cliente BYOK opera en su propia app independiente — su universo de permisos no depende del de MuseRelay ni del de otros clientes.

Identificadores que vas a encontrar — guía rápida

En el panel de Meta verás varios "identificadores" parecidos. Esta tabla aclara cuáles necesitas:

Identificador	Dónde está	¿Lo pide MuseRelay?
App ID general	Arriba del panel	No (es para Facebook Login / WhatsApp)
App Secret general	Configuración → Básica	No
Instagram App ID	Instagram → API Setup	Va en la URL del webhook
Instagram App Secret	Instagram → API Setup → Mostrar	Solo si activas renovación automática
Instagram Account ID	Sección "Generar identificadores"	Sí — campo obligatorio
Access Token	Botón "Generar identificador"	Sí — campo obligatorio

Regla de oro: ignora App ID y App Secret generales. Instagram tiene su propia familia de credenciales completamente independiente — solo usa los del bloque Instagram.

Messenger (Facebook) — Flujo de conexión BYOK

Requisitos previos

Página de Facebook activa
Permisos de administrador en esa página
Acceso a Meta for Developers

Datos que necesitas tener a mano

Dato	Dónde encontrarlo
Page ID	Configuración de página → Información de la página
Page Access Token (`EAA...`)	Meta for Developers → tu app → Messenger → Settings, con permiso `pages_messaging`

Pasos detallados

Crea una app en Meta for Developers (la misma puede servir si ya tienes una para Instagram)
Activa el producto Messenger y asocia tu Página de Facebook
Genera un Page Access Token con permiso pages_messaging
Copia el Page ID y el Page Access Token
En MuseRelay → Canales → Nuevo canal → Messenger → modo BYOK
Pega el Page ID y el token, y guarda
MuseRelay genera la URL del webhook y el Verify Token — cópialos
En Meta Developers → Messenger → Settings → Webhooks, configura ambos valores
Suscríbete a los eventos recomendados:
- messages — mensajes entrantes (obligatorio)
- messaging_postbacks — botones presionados
- message_deliveries — confirmaciones de entrega
Vuelve a MuseRelay y prueba la conexión

Limitación de Messenger en modo BYOK

Lo que SÍ puedes hacer en BYOK Messenger sin App Review:

Recibir todos los mensajes que tus clientes envíen a tu Página
Responder a esos mensajes dentro de la ventana de 24 horas tras el último mensaje del cliente
Auto-replies, away messages, instant replies

Lo que NO puedes hacer sin App Review aprobado en tu propia app:

Enviar mensajes proactivos (sin que el usuario te haya escrito primero)
Responder fuera de la ventana de 24 horas (con excepciones para tags específicos como confirmaciones de pedido)
Enviar Marketing Messages o broadcasts a usuarios que dieron opt-in
Usar el Human Agent tag para extender la ventana a 7 días

Para casos de atención al cliente reactiva (clientes que escriben con dudas y reciben respuestas), BYOK de Messenger funciona perfectamente sin necesidad de App Review.

Para casos de uso avanzados (notificaciones automáticas, marketing recurrente, soporte fuera de ventana), recomendamos usar el modo Guiado de MuseRelay cuando esté disponible para tu cuenta — opera con nuestro App Review.

Modo Guiado — alternativa de un click

El modo Guiado simplifica todo el proceso anterior. En lugar de crear una app en Meta for Developers y copiar tokens, el flujo es:

Click en "Conectar con Facebook" (Messenger) o "Conectar con Instagram"
Se abre la ventana de Meta pidiendo autorización
Autorizas con tu cuenta
Si tienes varias Páginas (Messenger), eliges cuál conectar
Listo — webhooks suscritos automáticamente

Sin tokens, sin webhooks, sin Meta for Developers. El modo Guiado usa el App Review de MuseRelay para que cualquier usuario pueda conectar sin trámites adicionales.

Mientras el App Review de MuseRelay esté en proceso, el modo Guiado funciona solo con cuentas autorizadas como testers. BYOK es la vía libre disponible inmediatamente para cualquiera.

Resumen — qué modo elegir

Tu situación	Recomendación
Tienes experiencia técnica con Meta y quieres control total	BYOK
Solo quieres conectar y usar — no eres técnico	Guiado (cuando esté disponible para tu cuenta)
Caso de uso: atención al cliente reactiva	BYOK funciona desde el día 1
Caso de uso: mensajería proactiva, marketing, broadcasts	Guiado (App Review de MuseRelay) o BYOK con tu propio App Review

Para dudas durante la configuración, contacta con soporte desde el panel.