AndresRV AI ChatBot 🤖 — Plugin Oficial para WordPress

Plugin profesional de Inteligencia Artificial para WordPress desarrollado por AndresRV.
Diseñado para empresas, tiendas online y agencias que necesitan un asistente virtual omnisciente, con tolerancia a fallos multi-marca, selectores desplegables nativos de modelos (ClinePass, OpenRouter, Google Gemini, OpenAI, DeepSeek y NVIDIA NIM), entrenamiento documental RAG continuo (PDF, Word, PPTX, TXT, MD, CSV), orquestación con n8n, cierre asistido a WhatsApp y un sistema de actualización automática en 1-clic desde GitHub.

💎 Comparativa de Planes y Vertientes

El plugin está diseñado bajo una arquitectura modular de un solo paquete: arranca por defecto en el Plan Starter gratuito y desbloquea capacidades avanzadas al introducir tu clave de licencia en la pestaña Licencia y Planes sin necesidad de reinstalar.

📥 Descarga e Instalación

Método 1: Instalación desde archivo ZIP (Recomendada)

1. Descarga el paquete oficial más reciente: andresrv-ai-chatbot-v1.6.0.zip.
2. En tu panel de WordPress, dirígete a Plugins > Añadir nuevo > Subir plugin.
3. Selecciona el archivo ZIP descargado y haz clic en Instalar ahora.
4. Activa el plugin.
5. El plugin se iniciará en Plan Starter gratuito con todas las funciones comunitarias activas.

Método 2: Clonado con Git (Para Desarrolladores)

cd wp-content/plugins
git clone https://github.com/AndresRVWeb/andresrv-ai-chatbot.git andresrv-ai-chatbot

🔄 Actualizaciones Automáticas en 1-Clic desde WordPress

El plugin cuenta con el actualizador nativo AndresRV_Plugin_Updater conectado directamente con los Releases de este repositorio de GitHub:

• Cada vez que publiquemos una nueva versión, WordPress mostrará automáticamente el aviso oficial de actualización en Plugins:
  «Hay una nueva versión de AndresRV AI ChatBot disponible. Ver detalles de la versión o Actualizar ahora».
• Puedes actualizar con un solo clic sin perder tu base de conocimientos entrenada, ajustes ni licencias.

🔑 Activación de Licencias (Plan PRO y Agencias)

Si has adquirido una licencia en andresrv.com:

1. En el panel de WordPress, abre el menú AndresRV ChatBot (o el nombre personalizado por tu agencia).
2. Haz clic en la pestaña 🔑 Licencia y Planes.
3. Introduce tu clave de licencia recibida en el correo de compra:
   • Formato PRO: ARV-PRO-XXXX-XXXX-XXXX
   • Formato Agencias: ARV-AGENCY-XXXX-XXXX-XXXX
4. Pulsa «🔑 Activar Licencia».
5. El plugin valida tu clave contra el servidor oficial https://andresrv.com/wp-json/andresrv/v1/license-validate y desbloquea inmediatamente todas las funciones contratadas:
   • En Plan PRO: RAG ilimitado, conmutación automática ante caídas (Failover Chain), integración con n8n y opción de ocultar la firma del widget.
   • En Plan Agencias: Todo lo anterior más la activación en hasta 20 dominios independientes y la opción de renombrar el menú de WordPress en la pestaña de Personalización Visual.

[!TIP] Tolerancia a fallos en licenciamiento: El plugin cuenta con triple capa de validación (API de andresrv.com, webhook de n8n.andresrv.com y validación estructural offline), por lo que nunca dejará de funcionar ante problemas puntuales de conectividad.

⚙️ Guía de Configuración y Uso

0. Interruptor Maestro (Encendido / Apagado)

En la parte superior de la cabecera del plugin tienes un interruptor con indicador luminoso:

• CHATBOT ACTIVO: El widget se inyecta en el frontend de la web y responde a los usuarios.
• CHATBOT APAGADO: El widget desaparece completamente del DOM y la API queda pausada. Ideal para periodos de mantenimiento o actualización de contenidos.

1. Base de Conocimiento y Entrenamiento RAG

• Subida de Archivos: Sube documentos en formato PDF, Word (.docx), PowerPoint (.pptx), Markdown (.md), Texto plano (.txt) o CSV.
• Notas de Texto Rápidas: Añade avisos puntuales, horarios especiales o cambios de tarifas al instante.
• Algoritmo de Recencia Temporal: Si una tarifa del 2026 contradice a un PDF del 2024, el motor RAG prioriza matemáticamente la fuente más reciente (ORDER BY updated_at DESC).

2. Proveedores de IA y Modelos

Elige tu proveedor preferido a través de menús desplegables nativos:

• ClinePass & Modelos FREE: Acceso a modelos gratuitos (GLM 5.3 Flash, DeepSeek V4 Flash, MiniMax M2.5, Muse Spark) y modelos avanzados por suscripción.
• OpenRouter: Cientos de modelos de código abierto y comerciales con cadena de modelos de respaldo (fallback).
• Google AI (Gemini): Conexión ultrarrápida con Gemini 1.5 Flash y Gemini 1.5 Pro.
• OpenAI: Modelos GPT-4o, GPT-4o Mini y razonamiento o1/o3.
• DeepSeek: DeepSeek V4 Flash, V4 Pro, deepseek-chat y deepseek-reasoner.
• NVIDIA NIM: Modelos empresariales acelerados como Nemotron 3.5 Lightning.

3. Ajustes del Asistente, n8n y Guía de Prompt

• WhatsApp: Introduce el teléfono de atención. Cuando el visitante solicite hablar con una persona o se active la directiva [[DELEGAR_WHATSAPP]], aparecerá un botón interactivo para continuar la charla en WhatsApp.
• Orquestación n8n: Activa el modo n8n para delegar la lógica conversacional a tus propios flujos de trabajo con Bearer Token seguro.
• Directivas Maestras (System Prompt): Configura el rol de la empresa, tono de voz, restricciones de URLs y reglas de derivación.

4. Personalización Visual del Widget (Marca Blanca)

Adapta el diseño al 100% a los colores de tu marca:

• Nombre y subtítulo del asistente.
• URL del avatar personalizado.
• Mensaje de bienvenida inicial (admite HTML y la etiqueta {site}).
• Sugerencias rápidas (chips clicables).
• Colores primarios y de interacción (hover) con vista previa en tiempo real.
• Marca Blanca en Widget (PRO/Agencias): Oculta la firma «Powered by AndresRV».
• Marca Blanca en Backoffice (Agencias): Personaliza el nombre que tus clientes ven en el menú lateral de WordPress (ej: «Asistente IA»).

5. Historial de Conversaciones

Consulta los últimos mensajes registrados, el emisor (Usuario o Asistente), el modelo de IA utilizado, si se derivó a WhatsApp y la dirección IP.

🛠️ Requisitos Técnicos

• WordPress: 5.8 o superior (probado hasta 6.7).
• PHP: 7.4 o superior (recomendado PHP 8.1 - 8.3).
• Extensiones PHP: curl, json, mbstring y zip (opcional para extracción de archivos .docx/.pptx).
• Base de Datos: MySQL 5.7+ o MariaDB 10.3+.

📄 Licencia

Este proyecto está bajo la licencia GPL v2 or later. Consulta el archivo LICENSE para más información.

Desarrollado con pasión y precisión por Andrés RV
GitHub: @AndresRVWeb
Contacto y Soporte: https://andresrv.com