Conectar canales
Conectar Messenger
Cómo vincular una Página de Facebook para conversar por Messenger.
Requisitos
Sección titulada «Requisitos»- Una Página de Facebook.
- Ser admin de la Página (o tener control total de ella desde el portafolio comercial), con una función que permita mensajes (
MESSAGINGoMANAGE).
Permisos
Sección titulada «Permisos»| Permiso | Para qué |
|---|---|
pages_show_list |
Listar las Páginas que administras, para elegir cuál conectar |
pages_manage_metadata |
Suscribir la app a los webhooks de la Página |
pages_messaging |
Recibir y enviar mensajes por Messenger |
pages_read_engagement |
Leer datos básicos de la Página y de las conversaciones |
business_management |
Acceder a Páginas que pertenecen a un portafolio comercial |
Sin pages_messaging o pages_manage_metadata la conexión no se crea (signup_scope_mismatch).
Paso a paso
Sección titulada «Paso a paso»- Abre Conexiones → Conectar Messenger. El panel navega al Inicio de sesión con Facebook para empresas (sin ventana emergente, funciona en el celular).
- Entra en Facebook, elige las Páginas a las que Messajo puede acceder y acepta los permisos.
- De vuelta en el panel, si hay más de una Página disponible, marca en Elige las Páginas cuáles conectar y toca Conectar Páginas. Cada Página elegida se convierte en una conexión. Una Página ya conectada en otra organización o sin función de mensajes aparece deshabilitada, con el motivo.
- Listo: cada Página aparece como Activa.
Sin ninguna Página que se pueda conectar, el intento termina con messenger_no_pages. Un fallo en una Página no deshace las demás.
Para conectar la Página de un cliente, envía una invitación por enlace con el canal Messenger: la persona autoriza y elige las Páginas desde la página pública de la invitación.
Token de la Página
Sección titulada «Token de la Página»El token de la Página no vence: no hay renovación. Al conectar, Messajo suscribe la app a la Página (subscribed_apps) para recibir los webhooks; cada 15 min revisa la suscripción y, si la app desapareció de la lista, la suscribe de nuevo (connection.updated con reason: "resubscribed"). Si alguien quita los permisos, la conexión pasa a needs_reconnect (token_invalid) y el dueño recibe el enlace de reconexión.
Mensajes
Sección titulada «Mensajes»Messenger usa el mismo motor y la misma matriz de tipos que Instagram, con estas diferencias:
toes el PSID del contacto (o elctc_…de Messajo);- texto de hasta 2.000 caracteres; adjuntos de hasta 25 MB;
- una imagen por mensaje (sin
images), sinlikey sinshare; - la confirmación de lectura de Meta (
watermark) se convierte enmessage.statusconreadpara todos los mensajes hasta ese momento.
Ventanas
Sección titulada «Ventanas»| Ventana | Cuándo vale |
|---|---|
| 24 horas | Cualquier respuesta, contada desde el último mensaje del contacto |
| 7 días | Después de que el contacto responda a un anuncio |
| 7 días | Con tag: "human_agent" |
tag: "human_agent" es solo para respuestas escritas por una persona, nunca para automatizaciones, y exige la función Human Agent aprobada en App Review (sin ella: 403 human_agent_not_approved). Las demás etiquetas de Messenger fueron descontinuadas por Meta y no se aceptan. Fuera de la ventana: 422 outside_service_window.
Consulta la política de Messenger de Meta.
Perfil de mensajes
Sección titulada «Perfil de mensajes»En Conexiones → (Página) → Perfil de mensajes, o con GET/PUT /v1/connections/{id}/messaging-profile:
- Preguntas frecuentes (ice breakers): hasta 4 por idioma;
- Menú fijo: hasta 20 elementos, con la opción de desactivar el cuadro de texto;
- Saludo: hasta 160 caracteres, acepta
{{user_first_name}}; - Empezar: el botón “Empezar” y el
payloadque envía. Messajo guarda “Empezar” antes del menú (Meta lo exige) y no deja borrarlo mientras haya menú.

Capa espejo
Sección titulada «Capa espejo»/v1/messenger/{page_id}/... reenvía a la Graph con el token de la Página, con el cuerpo y la respuesta de Meta intactos; nodos sueltos en /v1/messenger/{page_id}/nodes/{node_id}. POST …/messages guarda el mensaje en los logs; subscribed_apps y las rutas de token están bloqueadas (403 mirror_path_blocked), y pass_thread_control/take_thread_control exigen una clave con permiso admin.