Documentación de la Plataforma de Asesoría y Análisis

1. Descripción General

1.1. Sobre la Plataforma

La Plataforma de Asesoría y Análisis es un servicio de software como servicio (SaaS) diseñado para empresas que necesitan analizar, gestionar y optimizar sus conversaciones comerciales a través de múltiples canales de comunicación.

1.2. Funcionalidades Principales

• Análisis de Conversaciones: Procesamiento y análisis inteligente de conversaciones mediante inteligencia artificial
• Business Intelligence: Generación de estadísticas, métricas y reportes detallados
• Gestión Multi-Canal: Soporte para WhatsApp, SMS, Email, Instagram, Facebook y otros canales
• Análisis de Sentimiento: Clasificación automática del sentimiento en conversaciones
• Gestión de Contactos: Organización y perfilamiento automatizado de contactos
• Reportes Personalizados: Generación de reportes y análisis de rendimiento

1.3. Integraciones

La plataforma se integra con:

• GoHighLevel CRM: Sincronización bidireccional de conversaciones y contactos
• WhatsApp Business API: A través de WAHA (WhatsApp API Hub)
• Otros sistemas CRM: Mediante APIs estándar

2. Integración con GoHighLevel

2.1. Descripción de la Integración

La plataforma ofrece una integración completa con GoHighLevel CRM que permite:

• Sincronización automática de conversaciones desde GoHighLevel
• Sincronización de contactos y sus datos
• Análisis inteligente de mensajes y conversaciones
• Sincronización de múltiples canales (WhatsApp, SMS, Email, Instagram, Facebook, etc.)
• Gestión de múltiples ubicaciones (Locations) de GoHighLevel

2.2. Autenticación OAuth 2.0

La integración utiliza OAuth 2.0 para autenticación segura con GoHighLevel.

2.2.1. Configuración Inicial

Para configurar la integración, se requiere:

1. Client ID y Client Secret: Credenciales de la aplicación GoHighLevel
2. Scopes Requeridos:
   • locations.readonly - Lectura de ubicaciones
   • contacts.readonly - Lectura de contactos
   • contacts.write - Escritura de contactos
   • users.readonly - Lectura de usuarios
3. Redirect URI: URL de callback para el flujo OAuth

2.2.2. Flujo de Autenticación

1. El usuario inicia el proceso de conexión desde la plataforma
2. Se redirige al usuario a GoHighLevel para autorización
3. El usuario autoriza la aplicación en GoHighLevel
4. GoHighLevel redirige de vuelta con un código de autorización
5. La plataforma intercambia el código por tokens de acceso
6. Los tokens se almacenan de forma segura y se renuevan automáticamente

2.3. Sincronización de Datos

2.3.1. Conversaciones

La plataforma sincroniza automáticamente:

• Conversaciones activas y cerradas
• Mensajes de todos los canales soportados
• Metadatos de conversaciones (fechas, estados, asignaciones)
• Archivos adjuntos y medios

2.3.2. Contactos

Se sincronizan:

• Información básica de contactos
• Historial de interacciones
• Datos de perfil y preferencias
• Notas y etiquetas

2.3.2. Canales Soportados

La integración soporta los siguientes canales de GoHighLevel:

• WhatsApp
• SMS
• Email
• Instagram
• Facebook
• Google My Business
• Web Chat
• Llamadas

2.4. Configuración de Conexión

Para crear una conexión con GoHighLevel, se requiere:

1. Location ID: Identificador de la ubicación en GoHighLevel
2. User ID (Assigned To): ID del usuario asignado en GoHighLevel
3. Credenciales OAuth: Configuración de OAuth completada previamente

2.5. Sincronización Automática

La plataforma realiza sincronizaciones automáticas periódicas para mantener los datos actualizados. Los usuarios también pueden iniciar sincronizaciones manuales cuando sea necesario.

3. API y Endpoints

3.1. Autenticación

La API utiliza autenticación basada en tokens. Los usuarios deben autenticarse para acceder a los endpoints.

3.2. Endpoints Principales

3.2.1. Gestión de Integraciones

• Configurar Integración GoHighLevel: Configuración inicial de OAuth
• Obtener Estado de Integración: Verificar estado de conexión
• Renovar Tokens: Renovación automática de tokens de acceso

3.2.2. Gestión de Conexiones

• Crear Conexión: Crear una nueva conexión con GoHighLevel
• Listar Conexiones: Obtener lista de conexiones activas
• Actualizar Conexión: Modificar configuración de conexión
• Eliminar Conexión: Remover una conexión

3.2.3. Sincronización

• Sincronizar Manualmente: Iniciar sincronización manual
• Estado de Sincronización: Verificar estado de sincronización
• Historial de Sincronizaciones: Ver historial de sincronizaciones

3.2.4. Datos

• Conversaciones: Obtener conversaciones sincronizadas
• Mensajes: Obtener mensajes de conversaciones
• Contactos: Obtener contactos sincronizados
• Estadísticas: Obtener estadísticas y métricas

3.3. Formatos de Respuesta

Las respuestas de la API se proporcionan en formato JSON estándar.

3.4. Manejo de Errores

La API utiliza códigos de estado HTTP estándar:

• 200 - Éxito
• 400 - Solicitud inválida
• 401 - No autorizado
• 404 - Recurso no encontrado
• 500 - Error del servidor

4. Seguridad y Privacidad

4.1. Protección de Datos

La plataforma implementa medidas de seguridad robustas para proteger los datos:

• Cifrado: Todos los datos se cifran en tránsito y en reposo
• Autenticación Segura: OAuth 2.0 con renovación automática de tokens
• Control de Acceso: Sistema de roles y permisos granulares
• Auditoría: Registro de todas las actividades y accesos

4.2. Cumplimiento Normativo

La plataforma cumple con:

• Ley 1581 de 2012 (Ley de Protección de Datos Personales de Colombia)
• Estándares ISO 27001 (implementación de controles de seguridad)
• Mejores prácticas de seguridad de la información

4.3. Privacidad

Todos los datos se manejan de acuerdo con nuestra Política de Privacidad.

5. Uso de la Plataforma

5.1. Registro y Configuración Inicial

1. Crear Cuenta: Registro de empresa en la plataforma
2. Configurar Integración: Configurar credenciales de GoHighLevel
3. Crear Conexión: Crear conexión con ubicación de GoHighLevel
4. Iniciar Sincronización: Primera sincronización de datos

5.2. Gestión de Conversaciones

• Ver conversaciones sincronizadas desde GoHighLevel
• Filtrar por canal, fecha, estado, etc.
• Ver mensajes completos con archivos adjuntos
• Analizar sentimiento y contexto

5.3. Análisis y Reportes

• Ver estadísticas generales y por canal
• Generar reportes personalizados
• Analizar rendimiento de asesores
• Identificar tendencias y patrones

5.4. Gestión de Contactos

• Ver contactos sincronizados
• Perfilamiento automático mediante IA
• Análisis de comportamiento
• Segmentación y etiquetado

6. Soporte y Recursos

6.1. Documentación Adicional

• Política de Privacidad
• Términos y Condiciones

6.2. Contacto

6.3. Actualizaciones

La documentación se actualiza periódicamente. Se recomienda revisar esta página regularmente para estar al tanto de nuevas funcionalidades y cambios.

7. Limitaciones y Consideraciones

7.1. Servicios de Terceros

La plataforma utiliza servicios de terceros, incluyendo:

• Proveedores de inteligencia artificial (OpenAI, etc.)
• Servicios de infraestructura en la nube
• APIs de GoHighLevel

La disponibilidad y funcionalidad de estos servicios puede afectar el funcionamiento de la plataforma.

7.2. Rate Limiting

La plataforma implementa límites de velocidad (rate limiting) para proteger los servicios y garantizar un uso equitativo.

7.3. Disponibilidad

Aunque nos esforzamos por mantener la plataforma disponible 24/7, pueden ocurrir interrupciones por mantenimiento, actualizaciones o causas fuera de nuestro control.

8. Propiedad Intelectual

8.1. Derechos de Propiedad

Todos los derechos de propiedad intelectual sobre la plataforma, incluyendo software, diseño, documentación y marcas, son propiedad de Proyectoscol SAS.

8.2. Prohibiciones

Está estrictamente prohibido:

• Realizar ingeniería inversa del software
• Descompilar o desensamblar el código
• Copiar, modificar o crear obras derivadas sin autorización
• Utilizar la plataforma para desarrollar productos o servicios competitivos

Cualquier violación de estas prohibiciones resultará en acciones legales y la terminación inmediata del acceso a la plataforma.

9. Versión y Actualizaciones

Versión de Documentación: 1.0

Última Actualización: 28/04/2026

Esta documentación se actualiza periódicamente. Para la versión más reciente, consulte siempre la versión en línea.

10. Términos de Uso

El uso de la plataforma está sujeto a nuestros Términos y Condiciones.

Al utilizar la plataforma, usted acepta cumplir con estos términos y condiciones.