Instagram Comments e Instagram Direct

• Tipo de canal: Texto (comentarios / mensajería directa).
• Visibilidad del canal: Público.
• Complejidad de integración: Media (depende de la aplicación de Facebook Developer y de una cuenta empresarial/profesional de Instagram; comparte mecanismo de integración con Facebook).
• Chat general o solo Kyubo: Chat general.
• Sandbox disponible: Sí (Instagram Direct, según región — ver modulosandbox.md y acceso por región).

Definición

Instagram (IG) es un canal de red social disponible actualmente para integraciones de comentarios y mensajes directos, integrado a la plataforma de gestión de aplicaciones de Facebook (Facebook Developer). La integración con este canal depende de la incorporación de parámetros obtenidos de la aplicación de Facebook para su posterior configuración en la herramienta de integración de canales de Lynn.

Proceso de aprobación de la red social

El proceso de aprobación de aplicaciones puede tardar hasta dos semanas según el análisis y tiempos que ofrece la red social (Facebook/Instagram valida que la aplicación cumpla con los requisitos de la plataforma).

Requisitos

• Página de Facebook (con rol administrador).
• Perfil comercial.
• Cuenta de Facebook Developer.
• Aplicación en Facebook Developer.
• Cuenta empresarial/profesional de Instagram.
• Aprobación de permisos por parte de Facebook.
• Firma de contrato comercial.

Otorgar permisos para enviar y recibir mensajes de Instagram

Desde la aplicación móvil de Instagram, para que las personas con accesos aprobados a las páginas de Facebook puedan enviar o recibir mensajes desde la cuenta de Instagram:

1. Acceder a Instagram desde el teléfono y entrar al menú de opciones.

   

2. Seleccionar "Herramientas".

   

3. Activar la opción "Permitir acceso a los mensajes".

   

   

   

Permisos necesarios (Instagram Comments)

• Public_profile
• Page_show_list
• Page_manage_metadata
• Page_read_engagement
• Instagram_manage_comment
• Instagram_basic

Configurar Webhooks

Suscribir en la sección Instagram los eventos Comments y Mentions, y presionar "Subscribe".

Suscribir la página que recibirá los eventos mediante:

curl --location --request POST 'https://graph.facebook.com/v6.0/<<identificador_pagina>>/subscribed_apps?subscribed_fields=feed&access_token=<<token_acceso_pagina>>'

Relacionar los componentes de la integración

1. Crear una página de Facebook y asociar la cuenta de Instagram (Configuración → Instagram → login con la cuenta comercial de Instagram vinculada a la cuenta business).

   

   

   

2. Suscribir los eventos de webhook (ver arriba).

3. Generar el token de página asociado a la cuenta administradora de la página de Facebook.

4. Configurar todos los parámetros del tenant para el uso de Instagram.

Parámetros de configuración manual (además de los compartidos con Facebook)

Parámetro	Descripción
INSTAGRAM_APP_IDENTIFIER / INSTAGRAM_APP_SECRET	Identificador y clave de la aplicación de Facebook asociada.
INSTAGRAM_PAGE_IDENTIFIER	Identificador de la página de Facebook vinculada a la cuenta de Instagram.
INSTAGRAM_PERMANENT_TOKEN	Token de acceso permanente a la página. Ver Token de redes sociales META.
INSTAGRAM_TOKEN_VERIFICATION_WEBHOOK	GUID de verificación del webhook.
INSTAGRAM_BUSINESS_ACCOUNT	Código de usuario de la cuenta de Instagram; se obtiene consultando el endpoint graph.facebook.com/v8.0/<pagina>?fields=instagram_business_account&access_token=<token>.
INSTAGRAM_BUSINESS_ACCOUNT_USERNAME	Nombre de usuario de la cuenta de Instagram (sin @).

Configuración V.1 (recomendada)

Al igual que Facebook, Instagram admite el mecanismo de integración V.1, administrado por una aplicación de Facebook mantenida por Lynn (login with Facebook, selección de página/cuenta de Instagram, cesión de permisos, verificación automática de parámetros). Ver el detalle del flujo en Facebook Messenger.

Renovación de token META

Ver procedimiento completo de verificación y renovación en Token de redes sociales META.