Conectar Instagram y Messenger (BYOK — Credenciales propias)

Canales disponibles

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

Modo	Para quién	Estado
BYOK — Credenciales propias	Usuarios con app propia en Meta for Developers	Disponible
Guiado	Usuarios sin experiencia técnica en Meta	Próximamente

Esta guía cubre el modo BYOK (Bring Your Own Keys), que es el disponible hoy. El modo Guiado estará disponible próximamente y simplificará todo este proceso.

Qué necesitas saber sobre permisos de Meta

Importante antes de empezar: los permisos de Meta tienen dos niveles — Standard Access (desarrollo) y Advanced Access (producción). La diferencia principal afecta a si puedes responder mensajes de usuarios externos.

Nivel de acceso	Mensajes entrantes	Mensajes salientes (responder)	Requiere
Standard Access (desarrollo)	De cualquier usuario que te escriba	Solo a cuentas testers de tu app	Nada especial — es el estado inicial de toda app
Advanced Access (producción)	De cualquier usuario	A cualquier usuario	App Review + Business Verification en Meta

En Standard Access puedes recibir mensajes de cualquier persona que te escriba, pero solo puedes responder a cuentas que sean testers de tu app. Para responder a cualquier usuario (tus clientes reales), necesitas Advanced Access.

Resumen práctico: con Standard Access puedes configurar el canal, recibirás mensajes, pero el agente solo podrá responder a cuentas de test. Para atender clientes reales, necesitas solicitar Advanced Access en instagram_business_manage_messages. Ese proceso lo hace tu app en Meta for Developers.

Instagram — Flujo de conexión BYOK

Requisitos previos

Cuenta Instagram Business o Creator (no cuenta personal)
Página de Facebook vinculada a esa cuenta de Instagram
Acceso a Meta for Developers
Permisos de administrador en la app de Meta

Datos que necesitas tener a mano

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

Los tokens IGAA... ya no funcionan. Meta desactivó el Basic Display API el 04/12/2024. Usa únicamente tokens IGQ... (Instagram Login API, se renueva cada 60 días) o EAA... (System User, permanente).

Pasos

Ve a Canales → Nuevo canal, elige Instagram y selecciona el modo BYOK.
Asigna un nombre al canal (ej: "Instagram Ventas") y haz clic en Crear Canal Instagram.
En la pantalla de configuración, introduce:
- Tu Instagram Account ID
- Tu Access Token
El campo Token de verificación del webhook se genera automáticamente. Cópialo — lo necesitarás en el siguiente paso.
Haz clic en Guardar y Continuar. Se generará la URL del webhook y el Verify Token definitivos.
Ve a Meta for Developers → tu app → Instagram → Webhooks y configura:
- Webhook URL: la URL mostrada en MuseRelay
- Verify Token: el token mostrado en MuseRelay
Suscríbete al menos al evento messages.
Vuelve a MuseRelay y prueba la conexión.

Configuración avanzada (opcional pero recomendada)

En la sección Avanzado puedes añadir App ID, App Secret y un User Access Token EAA. Esto permite a MuseRelay introspectar el token (ver scopes y caducidad real), detectar problemas de permisos antes de que fallen, y renovar tokens EAA automáticamente sin intervención manual. El canal funciona sin estos datos, pero con ellos el diagnóstico es más preciso.

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

Ve a Canales → Nuevo canal, elige Messenger y selecciona el modo BYOK.
Asigna un nombre al canal y haz clic en Crear Canal Messenger.
En la pantalla de configuración, introduce:
- Tu Page ID
- Tu Page Access Token
Copia el Token de verificación del webhook generado automáticamente.
Haz clic en Guardar y Continuar para generar la URL definitiva del webhook.
Ve a Meta for Developers → tu app → Messenger → Configuración → Webhooks y configura la URL y el Verify Token.
Suscríbete a los eventos de webhook recomendados:
- messages — Mensajes entrantes (obligatorio)
- messaging_postbacks — Botones presionados
- message_deliveries — Confirmaciones de entrega
Vuelve a MuseRelay y prueba la conexión.

Configuración avanzada (opcional)

Igual que en Instagram, puedes añadir App ID, App Secret y un User Access Token EAA para habilitar la renovación automática de Page Tokens y diagnósticos avanzados.

Modo Guiado — Próximamente

Estamos preparando un flujo asistido que simplificará toda esta configuración. Con el modo Guiado no necesitarás crear una app en Meta for Developers ni copiar tokens manualmente — el proceso se hará a través de la plataforma.

Mientras tanto, el modo BYOK es la vía disponible. Si tienes dudas durante la configuración, contacta con soporte desde el panel.