Helios Vision AIHelios Vision AI

Messenger

Conecta tu página de Facebook con Facebook Login para que un agent de IA responda las conversaciones de Messenger, con control humano en la bandeja compartida.

Objetivo

Conecta tu página de Facebook para que un agent pueda responder las conversaciones de Messenger. La vía principal es Connect with Facebook de un clic (Facebook Login for Business); una alternativa Connect manually te permite usar tu propia app de Meta.

Acceso

Sidebar -> Messaging -> Messenger Rutas:

  • /app/{tenant}/messenger (conectar y gestionar páginas)
  • /app/{tenant}/messenger/conversations (conversaciones de Messenger)

Roles

  • owner, admin: conectar, asignar, activar, editar y desconectar páginas.
  • agent: puede ver la página pero los controles son de solo lectura.

Disponibilidad y requisitos previos

  • Tu plan debe incluir Messenger; el número de páginas activas está limitado por tu plan más el complemento Social Accounts Pack.
  • Al menos un agent para asignar. Una página no puede ponerse activa sin un agent asignado y activo.
  • Un email verificado.

Si tu plan incluye Messenger pero aún no lo ves, contacta con soporte.

Connect with Facebook (recomendado)

  1. Pulsa Connect with Facebook.
  2. Completa el flujo de Facebook Login for Business y elige las páginas a conceder.
  3. Cada página que administras se conecta como inactiva y sin asignar (si tu workspace tiene exactamente un agent activo, se preasigna). Una cuenta profesional de Instagram vinculada a una página también se conecta.
  4. Verás un banner como "Connected with Facebook. Now assign an agent to each Page below, then turn it on."
  5. Para cada página: asigna un agent y ponla Active.

Connect manually (usa tu propia app de Meta)

Usa Connect manually y abre la sección Advanced (use your own Meta app):

CampoNotas
Page nameEtiqueta opcional.
AgentUn selector de responder: un agent solo o un Team.
ActiveRecibir y responder mensajes.
Facebook Page IDRequerido al añadir (solo números).
Page access tokenRequerido al añadir. Al editar, déjalo en blanco para conservar el token actual.
App secretOpcional.
Webhook verify tokenOpcional.

Se proporciona una URL de webhook copiable ({base}/api/messenger/webhook) para la configuración de tu app de Meta. Los tokens y secretos se guardan cifrados y no se muestran de nuevo.

Gestionar páginas conectadas

Cada página aparece como una tarjeta con un interruptor Active/Inactive y un selector de agent/team en línea. Expándela para ver el Page ID y, cuando esté unhealthy, el error de salud más un botón Reconnect (que reinicia el flujo de Facebook). El menú kebab tiene Edit y Disconnect.

Insignias de estado: Solo / Team (N specialists), Needs reconnection, Linked agent inactive y Paused by plan limit.

Notas:

  • Asigna un Team en vez de un solo agent para que un coordinador pueda pedir ayuda a un especialista (requiere el plan Teams y un especialista aprobado).
  • Una página no puede ponerse Active sin un agent asignado y activo (el interruptor se deshabilita con "Select an agent to start replying."); quitar el agent desactiva la página.

Límites del plan

Una línea de uso muestra "N active Pages of M". Sin el permiso ves "Messenger is not in your plan" con un enlace View plans. Alcanzar el límite abre un diálogo de mejora. El Social Accounts Pack añade un espacio de página por unidad.

Conversaciones

Abre View conversations para llegar a /app/{tenant}/messenger/conversations. La lista muestra el nombre del cliente, la hora relativa e insignias de estado de IA (AI active / Human / Escalated), además de marcas "Needs attention" y "Opted out". La vista de detalle tiene el hilo de mensajes con marcas de entrega (sent / delivered / read / failed), un botón Take over / Hand back to AI, una insignia Team-assisted cuando ayudó un equipo, y un redactor de respuesta. Un cliente que hizo opt-out muestra "They must send START to resume." en vez del redactor. Estas conversaciones también aparecen en la bandeja unificada en /app/{tenant}/conversations.

Desconectar

Disconnect pide confirmar: "Disconnect {name}? Your agent will stop replying to its Messenger conversations. This cannot be undone." Elimina la conexión permanentemente.

Buenas prácticas

  • Después de conectar con Facebook, asigna un agent a cada página antes de encenderla.
  • Si las respuestas se detienen, busca Needs reconnection y usa Reconnect para refrescar los permisos de Facebook.
  • Usa un responder de tipo Team para páginas que necesiten más de un área de especialidad.