# Conectar Messenger

> Cómo vincular una Página de Facebook para conversar por Messenger.

## 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 (`MESSAGING` o `MANAGE`).

## 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`](/es/errors#signup_scope_mismatch)).

## Paso a paso

1. Abre **Conexiones → Conectar Messenger**. El panel navega al [Inicio de sesión con Facebook para empresas](https://developers.facebook.com/documentation/facebook-login/facebook-login-for-business) (sin ventana emergente, funciona en el celular).
2. Entra en Facebook, elige las Páginas a las que Messajo puede acceder y acepta los permisos.
3. 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.
4. Listo: cada Página aparece como **Activa**.

Sin ninguna Página que se pueda conectar, el intento termina con [`messenger_no_pages`](/es/errors#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](/es/connect/whatsapp/#invitar-al-cliente-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

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

Messenger usa el mismo motor y la misma [matriz de tipos](/es/connect/instagram/#tipos-de-mensaje) que Instagram, con estas diferencias:

- `to` es el PSID del contacto (o el `ctc_…` de Messajo);
- texto de hasta 2.000 caracteres; adjuntos de hasta 25 MB;
- una imagen por mensaje (sin `images`), sin `like` y sin `share`;
- la confirmación de lectura de Meta (`watermark`) se convierte en `message.status` con `read` para todos los mensajes hasta ese momento.

## 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`](/es/errors#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`](/es/errors#outside_service_window).

Consulta la [política de Messenger de Meta](https://developers.facebook.com/documentation/business-messaging/messenger-platform/policy).

## 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 `payload` que envía. Messajo guarda "Empezar" antes del menú (Meta lo exige) y no deja borrarlo mientras haya menú.

![Pantalla del perfil de mensajes de una Página, con menú fijo y saludo](../../../../assets/screenshots/messenger-profile-es.png)

## 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`](/es/errors#mirror_path_blocked)), y `pass_thread_control`/`take_thread_control` exigen una clave con permiso `admin`.
