Documentación Oficial: BuenChat

BuenChat es un asistente inteligente de ventas y atención al cliente para WordPress, que forma parte integral de Buenclick Suite. Su motor está diseñado para interactuar naturalmente con los clientes, gestionar procesos de comercio electrónico complejos y conectarse con sistemas de terceros de forma autónoma.

1. Modos de Operación

El plugin opera a través de dos interfaces principales gestionadas por su núcleo (OperationMode):

  • Modo IA (Inteligencia Artificial): Despliega un widget de chat interactivo en el sitio web, donde un asistente virtual autónomo atiende al cliente, resuelve dudas, busca productos y procesa ventas utilizando Procesamiento de Lenguaje Natural.
  • Modo WhatsApp: Un widget optimizado para redirigir la intención de compra y las consultas directamente al WhatsApp del negocio, inyectando el contexto de la página o producto que el usuario está viendo.

2. Proveedores de Inteligencia Artificial Soportados

BuenChat cuenta con un ProviderFactory que le permite conectarse con los Modelos de Lenguaje (LLMs) más avanzados del mercado, permitiendo al administrador elegir el motor deseado:

  • OpenAI: Soporte completo para modelos GPT-4o, GPT-4 y GPT-3.5.
  • Anthropic (Claude): Integración con la familia Claude 3.5 Sonnet.
  • Google Gemini: Conectividad con la API de Gemini Pro.
  • xAI (Grok): Soporte experimental/avanzado para los modelos de xAI.

3. Capacidades y Habilidades (Skills)

El núcleo de IA de BuenChat utiliza una arquitectura de Skills (Llamadas a Funciones) que permite al bot ejecutar acciones reales en la base de datos de WordPress y WooCommerce. Las capacidades se dividen en las siguientes categorías:

Comercio Electrónico (WooCommerce)

  • Búsqueda y Catálogo: SearchProduct (buscar productos en el catálogo), GetProductDetails (ver detalles, precios y stock) y GetProductReviews (leer reseñas).
  • Gestión de Carrito y Checkout: AddToCart (añadir productos), GetCartStatus (ver contenido del carrito), ApplyCoupon (aplicar códigos de descuento) y CheckoutSkill (generación de enlaces de pago).
  • Envíos y Pagos: GetShippingCost (calcular tarifas de envío), CheckShippingAvailability (validar zonas de entrega) y GetPaymentMethods (consultar métodos de pago activos).
  • Gestión de Pedidos (Post-Venta): OrderStatus (estado actual), TrackOrder (rastreo), GetOrderHistory (historial de compras), Reorder (volver a pedir) y CancelOrder (cancelaciones).

Membresías (Integración con BuenSubs/BuenReg)

  • GetMembershipPlans: Listar planes de suscripción disponibles.
  • SubscribeToMembership: Iniciar un proceso de suscripción.
  • GetMembershipStatus / GetBillingHistory: Consultar el estado activo y el historial de cobros.
  • CancelMembership: Procesar la cancelación de una suscripción recurrente.

Gestión de Cuenta y Soporte

  • UpdateProfile / ResetPassword: Asistencia para actualizar datos del cliente o restablecer contraseñas.
  • CreateSupportTicket: Derivación de consultas complejas a un sistema de tickets.

4. Motor de Búsqueda Avanzado (NLP)

BuenChat no usa la búsqueda básica de WordPress. Su servicio de búsqueda (ProductSearcher) está potenciado por algoritmos lingüísticos de vanguardia:

  • Fuzzy Matcher: Permite encontrar productos aunque el usuario cometa errores tipográficos o de ortografía al escribir en el chat.
  • Phonetic Matcher: Búsqueda fonética que encuentra coincidencias por «cómo suena» una palabra.
  • Spanish Inflector: Motor de inflexión gramatical nativo para el idioma español (entiende plurales, singulares y derivaciones de palabras).

5. Arquitectura RAG (Memoria Semántica)

El plugin incluye un módulo completo de Inteligencia Artificial basado en RAG (Retrieval-Augmented Generation):

  • Content Indexer: Escanea e indexa automáticamente páginas, productos y políticas de tu sitio web.
  • Vector Service: Convierte el contenido de tu sitio web en bases de datos vectoriales para que el LLM pueda «leer» tu documentación y dar respuestas precisas basadas únicamente en la información de tu negocio.
  • System Prompt Builder: Genera dinámicamente las instrucciones de comportamiento (reglas del bot) asegurando que mantenga el tono y las restricciones comerciales configuradas.

6. Integración CRM (HubSpot Pro)

Mediante su módulo HubSpotProvider, BuenChat permite automatizar la canalización de ventas B2B:

  • SaveLead (Captura de prospectos): El bot está entrenado para solicitar amigablemente el nombre y correo del usuario cuando muestra interés, enviándolo directamente al CRM.
  • Funciones Avanzadas (Módulo Pro): Soporta HubSpot Lead Scoring (Puntuación de leads), Deals Manager (Gestión de negocios/oportunidades) y sincronización por Webhooks.

7. Seguridad y Privacidad

El SecurityService protege tu endpoint de la API y garantiza una experiencia de usuario segura:

  • Rate Limiting: Evita el abuso bloqueando direcciones IP que realicen demasiadas solicitudes en un periodo corto (ej. más de 20 mensajes por hora).
  • Google reCAPTCHA v3: Integración silenciosa para validar que quien chatea es un humano y no un bot automatizado extrayendo datos.
  • Filtro de Contenido: Detección de spam y bloqueo de groserías para mantener el entorno profesional.
  • Conversation Logger & Analytics: Todo el registro de actividad cumple con estándares de privacidad, recopilando analíticas útiles sin exponer datos sensibles innecesariamente.

8. Configuración Rápida

Toda la gestión del plugin se realiza desde el panel central de la suite a través del componente Buenclick Hub:

  1. Ve a Buenclick Hub > BuenChat en el menú de WordPress.
  2. Selecciona tu Modo de Operación (IA o WhatsApp).
  3. Si usas IA, ingresa la clave de tu proveedor (ej. OpenAI API Key) en la pestaña de Proveedores.
  4. Navega a la pestaña de RAG / Conocimiento y haz clic en «Indexar Contenido» para que el bot aprenda sobre tu catálogo actual.
  5. Personaliza la apariencia (colores, logo del bot) en la pestaña de Personalización.