Para que MuseRelay pueda leer y responder los mensajes de tu WhatsApp, Instagram o Messenger, Meta nos da un acceso (un token) a tu cuenta. Esta guía explica las dos formas de conseguir ese acceso, cuánto dura, quién lo renueva y qué pasa —y qué te avisamos— si deja de funcionar.
Dos formas de conectar
Credenciales propias (BYOK)
Usas tu propia app en Meta for Developers y pegas en MuseRelay sus identificadores y el token.
- Funciona hoy, para todos los planes con ese canal.
- El acceso es tuyo: lo controlas y lo revocas desde tu app.
- Requiere unos minutos en Meta for Developers (te guiamos paso a paso) y el App Secret de tu app, obligatorio.
- Para atender a cualquier cliente, tu app debe estar en producción y, en Instagram y Messenger, con los permisos aprobados por Meta.
Conexión guiada
Pulsas un botón, inicias sesión con Meta, eliges la cuenta o la página y aceptas. Sin apps ni tokens.
- Instagram: «Conectar con Instagram».
- Messenger: «Conectar con Facebook» y eliges la página.
- WhatsApp: «Conexión guiada (1 clic)».
- Si un día deja de funcionar, se arregla con el botón Reconectar.
Estamos incorporando la conexión guiada de forma progresiva, para que los clientes menos técnicos puedan conectar sus canales sin pasar por Meta for Developers. No sustituye a las credenciales propias: podrás elegir, canal por canal, la que prefieras. Mientras no la tengas disponible en tu cuenta, conecta con credenciales propias.
Ventajas e inconvenientes de cada modo
| Credenciales propias (BYOK) | Conexión guiada | |
|---|---|---|
| Puesta en marcha | Crear una app en Meta for Developers, generar el token, copiar App Secret e IDs y configurar el webhook. Entre 15 y 30 minutos la primera vez. | Un botón, iniciar sesión y aceptar. Un par de minutos. |
| De quién es la app | Tuya. Ves sus permisos, sus registros y su configuración en tu panel de Meta. | De MuseRelay. Autorizas a nuestra app a usar tu cuenta. |
| Control del acceso | Total: puedes regenerar el token, cambiar el App Secret o borrar la app cuando quieras, sin pasar por nosotros. | Lo retiras desde los ajustes de Instagram o Facebook, o desconectando el canal. |
| Dependencia | Tus canales funcionan con tu propia app, sin depender de la de MuseRelay. | Tus canales funcionan a través de la app de MuseRelay. |
| Revisión de Meta | WhatsApp: no hace falta. Instagram y Messenger: para hablar con cualquier persona, tu app necesita los permisos aprobados por Meta (revisión de la app y verificación de tu empresa). | La hacemos nosotros, una vez para todos los clientes. |
| Mantenimiento | Tú. Algunos tokens se renuevan solos (ver abajo); si cambias el App Secret o el token en Meta, actualízalo en el canal. | Ninguno salvo reconectar si Meta corta el acceso. |
| Seguridad de los mensajes | Cada mensaje que llega se comprueba con la firma de Meta usando tu App Secret. | Igual, con el secreto de la app de MuseRelay. |
¿Por qué elegir credenciales propias?
- Más control. La conexión vive en tu cuenta de Meta: decides qué permisos tiene, la revocas al instante y puedes cambiar de proveedor sin pedir nada a nadie.
- Más privacidad y trazabilidad. Ninguna app de terceros tiene permiso sobre tu cuenta: el acceso lo das tú a tu propia app, y Meta te muestra en tu panel qué hace con él.
- Independencia. Tus canales funcionan con tu propia app de Meta, sin depender de la de MuseRelay, y puedes conectarlos hoy mismo.
- Ideal para agencias y empresas con equipo técnico, o con políticas internas que exigen que las integraciones usen apps propias.
Si no tienes estas necesidades, la conexión guiada será la opción más cómoda en cuanto esté disponible.
¿Quién paga a Meta?
WhatsApp: Meta cobra las conversaciones directamente a tu cuenta de WhatsApp Business, con el método de pago que añadas en Meta, en los dos modos. MuseRelay no hace de intermediario en ese pago. Instagram y Messenger: Meta no cobra por los mensajes.
El App Secret: obligatorio con credenciales propias
Meta firma cada mensaje que nos envía con el App Secret de la app. Con él comprobamos que el mensaje viene de verdad de Meta y no de alguien que haya descubierto la dirección del webhook. Por eso, en la conexión con credenciales propias, es obligatorio: sin él, o si no coincide, rechazamos los mensajes.
Solo los mensajes que entran, los que Meta nos envía cuando un cliente te escribe. Sin esta comprobación, alguien que descubriera la dirección del webhook podría hacerse pasar por Meta y colar en tu bandeja mensajes falsos en nombre de un cliente: tu asistente IA los contestaría (gastando créditos) y podrían acabar en citas, tickets o leads inventados.
Los mensajes que envías no cambian: salen directamente hacia Meta con tu token.
| Canal | Dónde está el App Secret |
|---|---|
| Meta for Developers → tu app → Configuración de la app → Básica → «Clave secreta de la app». | |
Instagram (token IGAA…) | Meta for Developers → tu app → Instagram → Configuración de la API con inicio de sesión de Instagram → «Clave secreta de la app de Instagram». |
Instagram (token EAA…) | Configuración de la app → Básica → «Clave secreta de la app». |
| Messenger | Configuración de la app → Básica → «Clave secreta de la app». |
Pégalo en Ajustes del canal (en Instagram y Messenger, en el apartado «App Secret y configuración avanzada»). Se guarda cifrado y no se vuelve a mostrar; para cambiarlo, escribe el nuevo, y si dejas el campo vacío se conserva el guardado.
- Falta el App Secret: la ficha del canal muestra «Falta el App Secret: este canal no recibe mensajes», con un botón para añadirlo.
- No coincide: «Meta envía mensajes, pero la firma no coincide», con la hora del último mensaje rechazado. Suele ser el secreto de otra app (en Instagram con token
IGAA…, recuerda que es el de la app de Instagram).
En cuanto guardas el correcto, los mensajes nuevos vuelven a entrar y el aviso desaparece con el primero que llegue bien firmado.
Si usas credenciales propias: lista de comprobación
- Tu app de Meta tiene el producto del canal (WhatsApp, Instagram o Messenger) y está en producción (Live).
- Has pegado en el canal el token, los IDs que pide y el App Secret.
- En tu app has configurado el webhook con la URL y el token de verificación que te da el canal, y suscrito los eventos que indica.
- WhatsApp: el token es de usuario del sistema con caducidad «Nunca» y tu cuenta tiene un método de pago en Meta.
- Instagram y Messenger: para atender a cualquier persona, tu app tiene los permisos de mensajería aprobados por Meta; sin ellos solo funcionará con las cuentas que tengan un rol en tu app.
- Has enviado un mensaje de prueba y aparece en la bandeja.
Cuánto dura el acceso y quién lo renueva
| Canal | Credenciales propias (BYOK) | Conexión guiada |
|---|---|---|
| Con un token de usuario del sistema con caducidad «Nunca», no caduca (es el recomendado). Un token de usuario normal caduca en horas. | Se genera al conectar. MuseRelay comprueba cada día que sigue siendo válido. | |
Token IGAA…: dura 60 días y MuseRelay lo renueva solo. Token de página EAA…: se renueva solo si guardas App ID, App Secret y un token de usuario en la configuración avanzada; si no, lo renuevas tú. | Token de 60 días que MuseRelay renueva solo. | |
| Messenger | Token de página EAA…: se renueva solo si guardas App ID, App Secret y un token de usuario en la configuración avanzada; si no, lo renuevas tú. | Token de página sin caducidad. |
Cómo funciona la renovación automática: cada noche MuseRelay revisa los tokens que caducan en 10 días o menos y pide a Meta uno nuevo. No tienes que hacer nada, y si una noche falla lo vuelve a intentar las siguientes.
Meta invalida el acceso, haya renovación o no, cuando:
- quitas el permiso a la app en los ajustes de Instagram o Facebook, o cambias la contraseña de la cuenta;
- la persona que conectó deja de ser administradora de la página o de la cuenta;
- Meta lo revoca por seguridad, o borras tu app (en BYOK);
- el canal está desactivado en MuseRelay: los canales desactivados no se renuevan, y si pasan más de 60 días el token de Instagram caduca.
Cómo vigilamos tus canales
Cada 6 horas MuseRelay comprueba con Meta que el acceso de cada canal de WhatsApp, Instagram y Messenger sigue funcionando (salvo los desactivados).
- Un fallo aislado no cambia nada: el canal pasa a Error cuando dos comprobaciones seguidas fallan por el mismo motivo.
- Los problemas de red o caídas momentáneas de Meta no marcan el canal como erróneo.
- Si conocemos la fecha de caducidad del token, también la vigilamos para avisarte antes.
Qué avisos recibes
| Aviso | Cuándo | Dónde |
|---|---|---|
| Canal con error | Cuando se confirma el fallo. Si sigue sin arreglarse, se repite como mucho cada 3 días. | |
| El token caduca pronto | A 30, 15 y 7 días de la caducidad, y cuando caduca. Con los tokens que renovamos solos (IGAA…) solo avisamos a 7 días, porque significa que la renovación lleva varias noches fallando. | |
| Canales que requieren tu acción | Al entrar en el panel mientras haya canales con error o con el token caducado o a punto de caducar. Puedes elegir «No mostrar más». | Panel |
| Estado del canal | Siempre: aviso junto al canal en el menú y estado «Desconectado» en su ficha, con el botón para arreglarlo. | Panel |
Los emails llegan al propietario del espacio de trabajo y a sus administradores activos, en su idioma, e incluyen lo que dice Meta y los pasos para arreglarlo según cómo conectaste el canal.
Qué pasa mientras un canal está caído
- Las conversaciones siguen en la bandeja. Puedes leer todo el historial del canal; nada se borra.
- No se puede responder por ese canal. Ni tu asistente IA ni tu equipo pueden enviar mensajes por él hasta que se arregle; la bandeja lo indica.
- Los mensajes nuevos suelen seguir llegando. Si el token solo ha caducado, Meta normalmente sigue enviándonos los mensajes de tus clientes: se guardan en la bandeja y la campanilla te avisa, pero no podrás contestar. Si el acceso se ha revocado (por ejemplo, quitaste el permiso a la app), Meta puede dejar de enviarlos. Por eso conviene arreglarlo cuanto antes.
- El resto de canales sigue igual. El problema afecta solo a ese canal.
Cómo se arregla
Si lo conectaste con la conexión guiada
- Abre el canal en MuseRelay.
- Pulsa Reconectar cuenta (Instagram) o Reconectar página (Messenger).
- Inicia sesión con la misma cuenta del canal (en Messenger, con un usuario que administre la página) y acepta los permisos.
- Listo: el canal vuelve a funcionar en el momento.
Meta usa la sesión abierta en tu navegador. Si aparece otra cuenta, cierra sesión en esa ventana (o usa una ventana de incógnito) y entra con la correcta. MuseRelay no guarda una cuenta que ya esté en otro canal ni, en Instagram, una cuenta distinta de la del canal: te lo indica y no cambia nada.
Si lo conectaste con credenciales propias
| Canal | Qué hacer |
|---|---|
| En Meta Business Manager → Ajustes del negocio → Usuarios del sistema, genera un token nuevo para el usuario del sistema del canal (caducidad «Nunca»). | |
En tu app de Meta for Developers → Instagram → Configuración de la API, genera un token nuevo (IGAA…) para la cuenta. | |
| Messenger | En tu app → Messenger → Configuración de la API, genera un token nuevo (EAA…) para la página. Guarda también App ID, App Secret y un token de usuario para que se renueve solo. |
Después, pega el token en Ajustes del canal y guarda: MuseRelay comprueba la conexión en ese momento y, si todo está bien, el canal vuelve a Activo. También puedes pulsar Revalidar conexión cuando quieras.
Arregla siempre el canal existente; no crees uno nuevo. Así mantienes todas las conversaciones, contactos y ajustes. Al recuperarse, los avisos se reinician y volverás a recibirlos si algún día vuelve a fallar.
Preguntas frecuentes
¿Tengo que renovar algo cada 60 días?
No, si tu token es de los que renovamos solos (Instagram IGAA…, o páginas con App ID, App Secret y token de usuario guardados). Solo tendrás que intervenir si Meta corta el acceso por alguno de los motivos de arriba, y te avisaremos.
Me ha llegado «Canal con error» pero el canal funciona
Pulsa Revalidar conexión en el canal. Si la conexión está bien, el canal vuelve a Activo y los avisos se reinician.
He cambiado el App Secret en Meta y han dejado de entrar mensajes
Al restablecer el App Secret en Meta, el anterior deja de valer. Pega el nuevo en los ajustes del canal y los mensajes vuelven a entrar.
¿Puedo empezar con credenciales propias y pasar a la conexión guiada más adelante?
Te lo explicaremos cuando la conexión guiada esté disponible en tu cuenta. Mientras tanto, conecta con credenciales propias sin preocuparte: lo que importa es no borrar el canal, para conservar el historial.
¿Quién recibe los emails?
El propietario del espacio de trabajo y sus administradores activos. Los agentes no los reciben.