Ir al contenido

Conectar canales

Conectar Messenger

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

  • 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).
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).

  1. Abre Conexiones → Conectar Messenger. El panel navega al Inicio de sesión con Facebook para empresas (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. 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.

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.

Messenger usa el mismo motor y la misma matriz de tipos 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.
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.

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

/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.