Asistente IA 24/7 WP

Introducción

Asistente IA 24/7 WP es un plugin de WordPress que integra un chatbot impulsado por inteligencia artificial utilizando la API de Groq. El plugin permite a los visitantes de tu sitio web obtener respuestas automáticas a sus preguntas, agendar citas, y recibir atención personalizada las 24 horas del día, los 7 días de la semana.

Características Principales

Requisitos del Sistema

Modelos de IA Disponibles

El plugin utiliza los siguientes modelos de Groq según la configuración seleccionada:

Instalación

La instalación del plugin es sencilla y sigue el proceso estándar de WordPress. A continuación se detallan los pasos para una instalación correcta.

Pasos de Instalación

Estructura del Plugin

Una vez instalado, el plugin crea la siguiente estructura en tu WordPress:

wp-content/plugins/asistente-ia-247-wp/
├── asistente-ia-247-wp.php    # Archivo principal
├── admin/                      # Panel de administración
│   ├── class-admin.php        # Clase principal del admin
│   └── views/                 # Vistas del panel
├── includes/                   # Clases y funciones
│   ├── class-api-client.php   # Cliente API de Groq
│   ├── class-rag.php          # Sistema RAG
│   ├── class-license.php      # Sistema de licencias
│   └── class-agenda.php       # Sistema de agenda
└── assets/                     # CSS y JavaScript
    ├── css/
    └── js/

Tablas de Base de Datos

El plugin crea automáticamente las siguientes tablas en tu base de datos WordPress al activarse:

Configuración Inicial

Después de activar el plugin, es necesario realizar una configuración inicial para que el chatbot funcione correctamente. Esta configuración incluye la activación de la licencia y la conexión con la API de Groq.

Acceder al Panel de Configuración

Sistema de Licencias

El plugin utiliza un sistema de licencias remoto que valida la autenticidad de tu copia y controla el acceso a las funciones premium. Este sistema se comunica con un servidor de licencias externo para verificar el estado de tu licencia de forma periódica.

Cómo Funciona el Sistema de Licencias

Proceso de Validación

1. Activación Inicial: Cuando ingresas tu licencia, el plugin envía una solicitud al servidor remoto para verificar que la clave es válida y está activa.
2. Registro del Sitio: El servidor registra el dominio de tu sitio y lo asocia con tu licencia, impidiendo el uso no autorizado en otros dominios.
3. Validación Periódica: El plugin verifica automáticamente el estado de la licencia cada 12 horas, renovando el acceso si la suscripción está activa.
4. Verificación de Actualizaciones: El sistema también verifica si hay actualizaciones disponibles para el plugin.

Formato de la Licencia

Las licencias siguen el siguiente formato:

A247-PRO-XXXX-XXXX-XXXX-XXXX

Donde:
- A247: Identificador del producto
- PRO: Tipo de licencia (PRO=Profesional)
- XXXX: Segmentos alfanuméricos únicos

Estados de Licencia

Activar tu Licencia

Desactivar Licencia

Si necesitas mover tu licencia a otro dominio:

1. Ve a Asistente IA 24/7 → Licencia
2. Haz clic en Desactivar Licencia
3. Esto liberará la activación para usarla en otro sitio

Ajustes Generales

La página de configuración general te permite personalizar todos los aspectos del funcionamiento del chatbot. Accede desde Asistente IA 24/7 → Configuración.

Opciones de Configuración

Configuración del Modelo de IA

Parámetros Avanzados

Eres un asistente de atención al cliente para [Nombre de Empresa].
Tu tono debe ser amable pero profesional.
Solo responde preguntas relacionadas con [tema].
Si no conoces la respuesta, indica amablemente que derivarás a un humano.
Siempre ofrece alternativas o soluciones cuando sea posible.

API de Groq

Para que el chatbot funcione, necesitas configurar una API Key de Groq. Esta clave permite que tu sitio se comunique con los servidores de Groq para generar respuestas de IA.

Obtener una API Key

Verificar la Conexión

Después de ingresar tu API Key, utiliza el botón Probar Conexión para verificar que todo funciona correctamente. Verás uno de los siguientes resultados:

Límites y Cuotas

Groq ofrece un plan gratuito con límites generosos. Para uso intensivo, considera actualizar a un plan de pago. Los límites actuales del plan gratuito incluyen:

• Requests por minuto: 30 peticiones
• Tokens por minuto: 18,000 tokens
• Tokens por día: 500,000 tokens

El plugin incluye protección automática contra exceso de rate limiting, pausando las peticiones cuando se alcanza el límite.

Widget Flotante

El widget flotante es una burbuja de chat que aparece en la esquina de tu sitio web, permitiendo a los visitantes iniciar conversaciones con el asistente desde cualquier página.

Activar el Widget

Por defecto, el widget flotante está activado. Para configurarlo:

1. Ve a Asistente IA 24/7 → Configuración
2. Busca la sección Widget Flotante
3. Activa la opción Mostrar widget en el sitio
4. Personaliza la apariencia según tus preferencias
5. Guarda los cambios

Opciones de Personalización

Vista Previa

Ocultar en Páginas Específicas

Para ocultar el widget en páginas específicas, ingresa los IDs de las páginas en el campo Páginas excluidas, separados por comas:

Ejemplo: 12, 45, 78

Esto ocultará el widget en las páginas con ID 12, 45 y 78.

Para encontrar el ID de una página, edítala en WordPress y mira la URL: post.php?post=123&action=edit — el número 123 es el ID.

Base de Conocimiento (RAG)

El sistema RAG (Retrieval Augmented Generation) permite que el asistente responda preguntas utilizando el contenido específico de tu sitio web, ofreciendo respuestas más precisas y contextualizadas.

¿Cómo Funciona RAG?

Indexar Contenido

Para que RAG funcione, primero debes indexar el contenido de tu sitio:

Configuración de Chunking

El contenido se divide en fragmentos (chunks) para optimizar la búsqueda:

Preguntas Frecuentes Personalizadas

Puedes agregar respuestas predefinidas para preguntas comunes:

1. Ve a Asistente IA 24/7 → Conocimiento → FAQs
2. Haz clic en Añadir FAQ
3. Escribe la pregunta (puedes usar variantes separadas por coma)
4. Escribe la respuesta que dará el asistente
5. Guarda los cambios

Las FAQs tienen prioridad sobre las respuestas generadas por IA, asegurando respuestas consistentes para preguntas comunes.

Reindexar Contenido

Cuando agregues nuevo contenido o actualices páginas existentes, reindexa para mantener la base de conocimiento actualizada:

Shortcode

Además del widget flotante, puedes incrustar el chatbot directamente en cualquier página o entrada utilizando el shortcode integrado.

Uso Básico

[asistente _ia_247]

Este shortcode muestra el chatbot en línea dentro del contenido de la página, con un diseño que se adapta al ancho disponible.

Parámetros del Shortcode

Ejemplos de Uso

[asistente _ia_247]

[asistente _ia_247 altura="600" titulo="Soporte Técnico" color="#2563eb"]

[asistente _ia_247 altura="700" ancho="400" titulo="Asistente de Ventas" color="#10b981" placeholder="¿En qué puedo ayudarte hoy?"]

Usar en Plantillas PHP

Para incrustar el chatbot en archivos de plantilla de tu tema:

<?php
echo do_shortcode('[asistent e_ia_247 altura="600"]');
?>

Usar con Gutenberg

En el editor de bloques:

1. Agrega un bloque Shortcode
2. Escribe [asistente _ia_247] con los parámetros deseados
3. Vista previa para verificar el resultado

Agenda IA

El sistema de Agenda IA permite que los usuarios agenden citas directamente a través del chatbot. El asistente guía la conversación para recopilar la información necesaria y verificar la disponibilidad en tiempo real. Requiere Licencia PRO

Configurar Disponibilidad

Flujo de Agendamiento

El chatbot guía al usuario a través del siguiente proceso:

Ver y Gestionar Citas

Todas las citas agendadas aparecen en Asistente IA 24/7 → Agenda → Citas. Desde aquí puedes:

• Ver detalles: Información completa de cada cita
• Confirmar/Rechazar: Cambiar el estado de la cita
• Reagendar: Modificar fecha y hora
• Cancelar: Eliminar la cita y liberar el horario
• Enviar recordatorio: Email automático al cliente

Notificaciones por Email

El sistema puede enviar notificaciones automáticas cuando se agenda una cita:

• Al cliente: Confirmación de la cita con detalles
• Al administrador: Notificación de nueva cita
• Recordatorio: Email 24 horas antes de la cita

Configura las plantillas de email en Asistente IA 24/7 → Agenda → Notificaciones.

Sistema RAG Avanzado

El sistema RAG (Retrieval Augmented Generation) es el motor que permite que el asistente responda con conocimiento específico de tu sitio web. Esta sección detalla el funcionamiento interno y las opciones avanzadas.

Arquitectura del Sistema

┌─────────────────────────────────────────────────────────────┐
│                    FLUJO DEL SISTEMA RAG                    │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  Usuario hace pregunta                                      │
│         │                                                   │
│         ▼                                                   │
│  ┌─────────────────┐                                        │
│  │ Clasificación   │ → Determina tipo de pregunta          │
│  │ de Intención    │   (FAQ, conocimiento, general)        │
│  └────────┬────────┘                                        │
│           │                                                 │
│           ▼                                                 │
│  ┌─────────────────┐                                        │
│  │ Procesamiento   │ → Limpieza y extracción               │
│  │ de Texto        │   de palabras clave                   │
│  └────────┬────────┘                                        │
│           │                                                 │
│           ▼                                                 │
│  ┌─────────────────┐                                        │
│  │ Búsqueda en     │ → Consulta chunks indexados           │
│  │ Conocimiento    │   ordenados por relevancia            │
│  └────────┬────────┘                                        │
│           │                                                 │
│           ▼                                                 │
│  ┌─────────────────┐                                        │
│  │ Construcción    │ → Combina contexto + pregunta         │
│  │ del Prompt      │   con instrucciones del sistema       │
│  └────────┬────────┘                                        │
│           │                                                 │
│           ▼                                                 │
│  ┌─────────────────┐                                        │
│  │ API de Groq     │ → Genera respuesta                    │
│  └────────┬────────┘                                        │
│           │                                                 │
│           ▼                                                 │
│  ┌─────────────────┐                                        │
│  │ Evaluación de   │ → Verifica calidad de respuesta       │
│  │ Respuesta       │   y aplica filtros                    │
│  └────────┬────────┘                                        │
│           │                                                 │
│           ▼                                                 │
│      Respuesta al usuario                                   │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Clases del Sistema RAG

El plugin incluye las siguientes clases especializadas:

Historial y Logs

El plugin mantiene un registro detallado de todas las conversaciones y eventos del sistema, permitiendo auditar, analizar y mejorar el rendimiento del asistente.

Ver Conversaciones

Accede a Asistente IA 24/7 → Conversaciones para ver:

Detalles de Conversación

Al hacer clic en una conversación, puedes ver:

• Transcripción completa de todos los mensajes
• Metadatos (IP, navegador, página de origen)
• Calificación de satisfacción si el usuario la proporcionó
• Intenciones detectadas y contexto utilizado

Sistema de Logs

En Asistente IA 24/7 → Logs encontrarás:

Exportar Datos

Puedes exportar las conversaciones y logs en formato CSV para análisis externo:

1. Ve a la sección correspondiente (Conversaciones o Logs)
2. Selecciona el rango de fechas
3. Haz clic en Exportar CSV
4. El archivo se descargará automáticamente

Retención de Datos

Por privacidad y rendimiento, configura cuánto tiempo se conservan los datos:

API REST - Endpoints

El plugin expone una API REST completa que permite interactuar con el chatbot desde aplicaciones externas, integraciones personalizadas, o servicios de terceros.

URL Base

https://tu-sitio.com/wp-json/asistente-ia-247/v1/

Todos los endpoints están prefijados con esta URL base. Las respuestas se devuelven en formato JSON.

Autenticación

Los endpoints públicos (chat, config) no requieren autenticación. Para endpoints administrativos, utiliza la autenticación de WordPress:

• Cookie Authentication: Para uso desde el frontend de WordPress
• Application Passwords: Para integraciones externas
• JWT (opcional): Instalando un plugin de JWT

Lista de Endpoints

API REST - Chat

POST /chat

Envía un mensaje al chatbot y recibe una respuesta generada por la IA.

Parámetros del Body (JSON)

Ejemplo de Request

{
    "message": "¿Cuáles son sus horarios de atención?",
    "session_id": "abc123def456",
    "context": {
        "page_url": "https://misitio.com/contacto",
        "page_title": "Contacto"
    }
}

Respuesta Exitosa (200)

{
    "success": true,
    "data": {
        "response": "Nuestros horarios de atención son de lunes a viernes de 9:00 AM a 6:00 PM, y sábados de 10:00 AM a 2:00 PM.",
        "session_id": "abc123def456",
        "intent": "consulta_horarios",
        "confidence": 0.92,
        "sources": [
            {
                "type": "page",
                "id": 45,
                "title": "Horarios de Atención",
                "relevance": 0.88
            }
        ],
        "metadata": {
            "model": "gpt-oss-20b",
            "tokens_used": 156,
            "response_time": 0.842
        }
    }
}

Respuesta de Error

{
    "success": false,
    "error": {
        "code": "rate_limit_exceeded",
        "message": "Has excedido el límite de mensajes. Intenta más tarde.",
        "details": {
            "limit": 50,
            "remaining": 0,
            "reset_at": "2024-01-15T00:00:00Z"
        }
    }
}

GET /config

Obtiene la configuración pública del chatbot (útil para inicializar el widget desde una aplicación externa).

Respuesta

{
    "success": true,
    "data": {
        "assistant_name": "Asistente Virtual",
        "welcome_message": "¡Hola! ¿En qué puedo ayudarte?",
        "placeholder": "Escribe tu mensaje...",
        "primary_color": "#6366f1",
        "language": "es",
        "features": {
            "chat": true,
            "agenda": true,
            "rag": true
        },
        "license_status": "active"
    }
}

API REST - Agenda

GET /agenda/check-slot

Verifica si un horario está disponible para agendar.

Parámetros Query

Ejemplo de Request

GET /wp-json/asistente-ia-247/v1/agenda/check-slot?date=2024-01-20&time=14:00&duration=30

Respuesta

{
    "success": true,
    "data": {
        "available": true,
        "date": "2024-01-20",
        "time": "14:00",
        "duration": 30,
        "end_time": "14:30"
    }
}

POST /agenda/book

Agenda una nueva cita.

Parámetros del Body

Ejemplo de Request

{
    "date": "2024-01-20",
    "time": "14:00",
    "name": "Juan Pérez",
    "email": "juan@ejemplo.com",
    "phone": "+34 612 345 678",
    "notes": "Consulta sobre servicios premium",
    "duration": 30
}

Respuesta Exitosa

{
    "success": true,
    "data": {
        "appointment_id": 123,
        "status": "confirmed",
        "date": "2024-01-20",
        "time": "14:00",
        "duration": 30,
        "message": "Tu cita ha sido agendada exitosamente. Recibirás un email de confirmación."
    }
}

API REST - Ejemplos de Uso

Ejemplos prácticos de integración con la API REST del plugin.

// Enviar mensaje al chatbot
async function enviarMensaje(mensaje, sessionId = null) {
    const response = await fetch('/wp-json/asistente-ia-247/v1/chat', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
        },
        body: JSON.stringify({
            message: mensaje,
            session_id: sessionId
        })
    });
    
    const data = await response.json();
    
    if (data.success) {
        console.log('Respuesta:', data.data.response);
        console.log('Session ID:', data.data.session_id);
        return data.data;
    } else {
        console.error('Error:', data.error.message);
        throw new Error(data.error.message);
    }
}

// Uso
enviarMensaje('¿Cuáles son sus horarios?')
    .then(result => {
        console.log(result.response);
    })
    .catch(error => {
        console.error('Error:', error);
    });

<?php
function enviar_mensaje_chatbot($mensaje, $session_id = null) {
    $url = 'https://tu-sitio.com/wp-json/asistente-ia-247/v1/chat';
    
    $body = [
        'message' => $mensaje,
        'session_id' => $session_id
    ];
    
    $args = [
        'method' => 'POST',
        'headers' => [
            'Content-Type' => 'application/json',
        ],
        'body' => json_encode($body),
        'timeout' => 30
    ];
    
    $response = wp_remote_post($url, $args);
    
    if (is_wp_error($response)) {
        return ['error' => $response->get_error_message()];
    }
    
    $data = json_decode(wp_remote_retrieve_body($response), true);
    
    if ($data['success']) {
        return $data['data'];
    }
    
    return ['error' => $data['error']['message']];
}

// Uso
$resultado = enviar_mensaje_chatbot('¿Cuáles son sus horarios?');

if (isset($resultado['error'])) {
    echo 'Error: ' . $resultado['error'];
} else {
    echo 'Respuesta: ' . $resultado['response'];
}
?>

import requests
import json

def enviar_mensaje_chatbot(mensaje, session_id=None):
    url = 'https://tu-sitio.com/wp-json/asistente-ia-247/v1/chat'
    
    payload = {
        'message': mensaje,
        'session_id': session_id
    }
    
    headers = {
        'Content-Type': 'application/json'
    }
    
    response = requests.post(
        url, 
        data=json.dumps(payload), 
        headers=headers,
        timeout=30
    )
    
    data = response.json()
    
    if data.get('success'):
        return data['data']
    else:
        raise Exception(data['error']['message'])

# Uso
try:
    resultado = enviar_mensaje_chatbot('¿Cuáles son sus horarios?')
    print(f"Respuesta: {resultado['response']}")
    print(f"Session ID: {resultado['session_id']}")
except Exception as e:
    print(f"Error: {e}")

Solución de Problemas

Esta sección cubre los problemas más comunes y sus soluciones.

Habilitar Modo Debug

Para diagnósticos avanzados, habilita el modo debug:

1. Añade a tu wp-config.php: define('WP_DEBUG', true); y define('WP_DEBUG_LOG', true);
2. Ve a Asistente IA 24/7 → Configuración → Avanzado
3. Activa Modo Debug
4. Los logs detallados se guardarán en /wp-content/uploads/a247-debug.log

Preguntas Frecuentes

/* Ejemplo: CSS personalizado para el widget */
.a247-widget-container {
    border-radius: 20px !important;
}
.a247-chat-header {
    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
}

Ejemplo de contexto para español formal:

Eres un asistente profesional. Responde siempre en español 
formal, usando "usted" en lugar de "tú". Mantén un tono 
profesional pero cercano.