Helios Vision AIHelios Vision AI

Instagram

Conecta una cuenta profesional de Instagram con Facebook Login para que un agent de IA responda los mensajes directos, con control humano en la bandeja compartida.

Objetivo

Conecta una cuenta profesional de Instagram para que un agent pueda responder sus mensajes directos. 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 -> Instagram Rutas:

  • /app/{tenant}/instagram (conectar y gestionar cuentas)
  • /app/{tenant}/instagram/conversations (conversaciones de mensajes directos de Instagram)

Roles

  • owner, admin: conectar, asignar, activar, editar y desconectar cuentas.
  • agent: puede abrir la página y las conversaciones, pero no puede conectar, editar ni desconectar cuentas.

Disponibilidad y requisitos previos

  • Tu plan debe incluir Instagram; el número de cuentas activas está limitado por tu plan más el complemento Social Accounts Pack.
  • Una cuenta profesional de Instagram (business o creator) vinculada a una página de Facebook.
  • Al menos un agent activo para asignar. Una cuenta no puede ponerse activa sin un agent asignado y activo.
  • Un email verificado.

Si tu plan incluye Instagram pero aún no lo ves en el sidebar, contacta con soporte (este canal se está habilitando de forma gradual).

Connect with Facebook (recomendado)

  1. Pulsa Connect with Facebook.
  2. Completa el flujo de Facebook Login for Business y concede las páginas cuyas cuentas de Instagram vinculadas quieras conectar.
  3. Cada cuenta profesional de Instagram vinculada se conecta como inactiva y sin asignar.
  4. Verás un banner: "Connected with Facebook. Now assign an agent to each account below, then turn it on."
  5. Para cada cuenta: asigna un agent y ponla Active.

Para añadir una cuenta que creaste después, pulsa Connect with Facebook de nuevo y elige Edit settings (Edit access) en el diálogo de Facebook. Si no se encuentran cuentas nuevas verás "No new Instagram accounts were found."

Connect manually (usa tu propia app de Meta)

Usa Connect manually para abrir el formulario de conexión. Los campos técnicos viven en la sección Advanced (use your own Meta app) (expandida por defecto al añadir).

Campos principales:

CampoNotas
UsernameOpcional. Tu handle de Instagram, sin la @. Se muestra en el dashboard.
AgentUn selector de responder: un agent solo o un Team.
ActiveRecibir y responder mensajes.

Campos avanzados:

CampoNotas
Instagram account IDEl ID de la cuenta profesional de Instagram. Requerido al añadir (solo números).
Facebook Page IDLa página de Facebook vinculada a esta cuenta de Instagram. Requerido al añadir (solo números).
Page access tokenEl token de acceso de la página con permisos de mensajería. Requerido al añadir. Al editar, déjalo en blanco para conservar el token actual.
App secretOpcional. Solo se necesita con tu propia app de Meta.
Webhook verify tokenOpcional. Solo se necesita con tu propia app de Meta.

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

El botón Connect manually se deshabilita cuando alcanzas el límite de cuentas de tu plan.

Gestionar cuentas conectadas

Cada cuenta aparece como una tarjeta titulada con su @handle (o con su Instagram account ID cuando no hay handle). Tiene 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:

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

Límites del plan

Una línea de uso muestra "N active accounts of M" (o "(unlimited)"). Sin el permiso ves "Instagram is not in your plan" con un enlace View plans a facturación. Alcanzar el límite abre un diálogo de mejora. El Social Accounts Pack añade un espacio de cuenta por unidad.

Conversaciones

Abre View conversations para llegar a /app/{tenant}/instagram/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 "This customer opted out of messages. 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 direct messages. This cannot be undone." Elimina la conexión permanentemente.

Buenas prácticas

  • Después de conectar con Facebook, asigna un agent a cada cuenta 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 cuentas que necesiten más de un área de especialidad.