Mensajería Nexovate (Facebook e Instagram)

El módulo Nexovate Messenger integra Facebook Messenger e Instagram Direct Messages para gestionar mensajes de redes sociales directamente desde Nexovate. Incluye procesamiento de medios enriquecidos (imágenes, audio, video, documentos, mensajes de voz), un sistema de cola asíncrona para alto volumen, asignación inteligente de agentes y un dashboard de métricas.

Características principales

  • Soporte dual: Facebook Messenger e Instagram Direct Messages

  • Mensajes multimedia (imágenes, videos, documentos, audio, mensajes de voz)

  • Gestión multi-página con configuración independiente por página

  • Alto rendimiento: cola asíncrona para 1000+ mensajes por minuto

  • Asignación inteligente de conversaciones a agentes (round-robin, menos ocupado, aleatorio)

  • Notificaciones en tiempo real con auto-apertura de conversaciones

  • OAuth 2.0 con tokens de larga duración

  • Meta Graph API v21.0

  • Dashboard con estadísticas y tendencias

  • Detección de duplicados en mensajes entrantes

  • Soporte multi-cuenta de Instagram

Requisitos previos

Antes de configurar el módulo, necesita:

  1. Una cuenta de desarrollador de Meta (https://developers.facebook.com).

  2. Una aplicación de Meta con los productos Messenger y/o Instagram configurados.

  3. Una página de Facebook vinculada a su negocio.

  4. (Para Instagram) Una cuenta de Instagram Business vinculada a su página de Facebook.

  5. Los permisos necesarios: pages_messaging, pages_manage_metadata, instagram_basic, instagram_manage_messages.

Advertencia

Debe cumplir con las políticas de la plataforma Meta y obtener la aprobación de los permisos en modo producción para usar estas integraciones.

Configuración de Facebook Messenger

Crear la configuración

  1. Vaya a Mensajería Nexovate ‣ Configuración ‣ Configuración de Messenger.

  2. Haga clic en Nuevo.

  3. Complete los campos:

    • Nombre: Nombre descriptivo de la configuración.

    • App ID de Facebook: ID de la aplicación de Meta.

    • App Secret de Facebook: Secreto de la aplicación.

    • URI de redirección: URL de callback para OAuth (se genera automáticamente).

    • Token de verificación del webhook: Token personalizado para verificar los webhooks de Meta.

  4. Guarde la configuración.

Conectar páginas de Facebook

  1. En la configuración de Messenger, haga clic en Conectar con Facebook.

  2. Autorice el acceso a sus páginas de Facebook en la ventana emergente de Meta.

  3. Al completar la autorización, el sistema:

    • Obtiene un token de acceso de larga duración.

    • Crea registros para cada página conectada con sus tokens individuales.

    • Configura automáticamente los webhooks para recibir mensajes.

Configurar páginas

Cada página de Facebook conectada puede configurarse individualmente:

  1. Vaya a Mensajería Nexovate ‣ Páginas.

  2. Seleccione una página.

  3. Configure la asignación de conversaciones:

    • Asignación automática: Active para distribuir conversaciones entre agentes.

    • Método de asignación:

      • Round Robin: Distribución equitativa entre agentes.

      • Menos ocupado: Asigna al agente con menos conversaciones activas.

      • Aleatorio: Asignación aleatoria.

    • Usuarios asignados: Seleccione los agentes que atenderán esta página.

Configurar webhooks en Meta

  1. En la consola de desarrolladores de Meta, vaya a su aplicación.

  2. En Productos –> Messenger –> Configuración, agregue la URL del webhook:

    • URL de callback: https://SU-NEXOVATE.com/webhook/meta_messenger

    • Token de verificación: El mismo configurado en Nexovate.

  3. Suscríbase a los eventos: messages, messaging_postbacks.

Configuración de Instagram

Crear la configuración

  1. Vaya a Mensajería Nexovate ‣ Configuración ‣ Configuración de Instagram.

  2. Haga clic en Nuevo.

  3. Complete los campos:

    • Nombre: Nombre descriptivo.

    • App ID: ID de la aplicación de Meta (puede ser la misma de Messenger).

    • App Secret: Secreto de la aplicación.

    • URI de redirección: URL de callback OAuth.

    • Token de verificación del webhook: Token para verificación.

  4. Haga clic en Conectar con Instagram para autorizar el acceso.

Al conectar, el sistema:

  • Obtiene un token de acceso de larga duración para Instagram.

  • Crea registros para cada cuenta de Instagram Business vinculada.

  • Descarga la foto de perfil y datos del perfil.

  • Vincula la cuenta de Instagram con su página de Facebook.

Configurar webhooks de Instagram en Meta

  1. En la consola de desarrolladores de Meta, en Productos –> Instagram –> Configuración:

    • URL de callback: https://SU-NEXOVATE.com/webhook/meta_instagram

    • Token de verificación: El configurado en Nexovate.

  2. Suscríbase al evento: messages.

Gestión de mensajes

Los mensajes entrantes de Facebook e Instagram se procesan automáticamente:

  1. Se identifica el remitente (por su PSID de Facebook o ID de Instagram).

  2. Se crea o recupera el registro del contacto social (messenger.sender).

  3. Se crea un canal de Discuss para la conversación (si no existe).

  4. El mensaje se publica en el canal con los adjuntos multimedia procesados.

  5. Se envía una notificación en tiempo real a los agentes.

Tipos de contenido soportados

Tipo

Descripción

Texto

Mensajes de texto plano

Imágenes

JPG, PNG, GIF con descarga automática

Video

MP4 y otros formatos soportados por Meta

Audio

Archivos de audio

Mensajes de voz

Grabaciones de voz con transcripción automática

Documentos

PDF y otros archivos adjuntos

Stickers

Stickers de Facebook/Instagram

Responder mensajes

Para responder a un mensaje de red social:

  1. Vaya a Mensajería Nexovate ‣ Contactos y seleccione un contacto.

  2. Haga clic en Abrir Chat para abrir la conversación en Discuss.

  3. Escriba su respuesta en el compositor de mensajes.

  4. El mensaje se envía automáticamente a la red social correspondiente vía la API de Meta.

Las respuestas también pueden enviarse directamente desde el canal de Discuss correspondiente.

Cola de procesamiento asíncrono

Para escenarios de alto volumen (campañas publicitarias, lanzamientos), el módulo incluye un sistema de cola asíncrona:

Configuración

  1. En la configuración de Messenger, active Procesamiento asíncrono.

  2. Configure el Umbral de mensajes/hora que activa el modo cola.

Funcionamiento

  • Los mensajes entrantes se encolan con estado pendiente.

  • Una acción programada procesa la cola periódicamente.

  • Los mensajes se procesan por prioridad.

  • En caso de error, se reintenta con backoff exponencial (hasta 3 intentos).

  • Los mensajes fallidos quedan marcados para revisión manual.

Para monitorear la cola:

  1. En la configuración de Messenger, haga clic en el botón inteligente Cola.

  2. Se muestran los mensajes pendientes, en proceso, completados y fallidos.

Dashboard

El módulo incluye un dashboard de métricas accesible desde los controladores internos:

  • Estadísticas generales: Total de mensajes, conversaciones, leads y tickets.

  • Tendencias de mensajes: Gráfico de mensajes por período (día, semana, mes).

  • Páginas principales: Ranking de páginas por volumen de mensajes.

  • Estadísticas por plataforma: Comparativa entre Facebook e Instagram.

Nota

El dashboard está disponible vía endpoints JSON internos. Consulte a su administrador para configurar su visualización.