Introducción

Especialista en WP Chat es un plugin avanzado para WordPress que proporciona un widget de chat inteligente alimentado por IA. Utiliza la API de Google Gemini para generar respuestas naturales y contextualmente relevantes, mientras gestiona automáticamente el flujo de conversación y la captura de leads potenciales.

El plugin está diseñado para mejorar la experiencia del usuario en tu sitio web, proporcionando asistencia inmediata y capturando información valiosa de contacto de manera orgánica durante las conversaciones.

Características principales:

• Widget de chat con IA powered by Google Gemini
• Gestión automática de estados de conversación
• Captura inteligente de leads
• Soporte multiidioma completo
• Sistema de protección anti-spam y baneos
• Panel de administración completo
• Hooks extensibles para desarrolladores

Instalación y Configuración

Instalación del Plugin

1. Descarga el archivo .zip del plugin Especialista en WP Chat.

2. En tu panel de administración de WordPress, ve a Plugins > Añadir nuevo.

3. Haz clic en el botón Subir plugin en la parte superior de la página.

4. Selecciona el archivo .zip que descargaste y haz clic en Instalar ahora.

5. Una vez instalado, haz clic en Activar plugin.

Configuración Inicial

Después de activar el plugin, aparecerá un nuevo menú “Experto en WP Chat” en tu panel de administración.

1. Ve a Experto en WP Chat > Configuración.

2. Completa los campos básicos:

• Nombre del Negocio: El nombre de tu empresa o sitio web
• Nombre del Agente: Cómo se identificará el bot (ej. “Asistente Virtual”)
• Información Base: Información sobre tu negocio, servicios y productos que el IA usará para responder

Configuración de API de Google Gemini

Para que el chat funcione con IA, necesitas configurar tu clave de API de Google Gemini:

1. Obtén tu clave de API desde Google AI Studio.

2. En Configuración, pega tu clave en el campo “Clave API de Google Gemini”.

3. Selecciona el modelo de Gemini (por defecto: gemini-2.0-pro-exp-02-05).

4. Guarda los cambios. El widget de chat aparecerá automáticamente en tu sitio web.

Widget de Chat

Funcionamiento del Chat

El widget de chat aparece como un botón flotante en la esquina inferior derecha de tu sitio web. Los visitantes pueden hacer clic para iniciar una conversación.

Características del widget:

• Diseño responsive que funciona en móviles y escritorio
• Indicadores de escritura en tiempo real
• Persistencia de conversaciones entre páginas
• Soporte para RTL (idiomas de derecha a izquierda)
• Modo debug opcional para desarrollo

Estados de Conversación

El plugin gestiona automáticamente diferentes estados durante la conversación:

• Inicio: Saludo inicial y consultas generales
• Información: Proporcionando información sobre productos/servicios
• Captura de Lead: Recopilando datos de contacto del usuario
• Despedida: Finalizando la conversación

La IA decide automáticamente cuándo transicionar entre estados basándose en el contexto de la conversación.

Captura de Leads

Cuando la IA detecta interés comercial, activará automáticamente el modo de captura de leads:

1. Solicitará de manera natural el nombre y email del usuario.

2. Opcionalmente puede pedir el número de teléfono.

3. Los datos se guardan automáticamente en la base de datos.

4. Se envían notificaciones configurables a los administradores.

Los usuarios pueden “escapar” del modo de captura de leads si aún tienen dudas, volviendo al flujo informativo.

Panel de Administración

Dashboard de Leads

Gestiona todos los leads capturados desde Experto en WP Chat > Leads:

• Lista de leads: Visualiza todos los contactos capturados
• Estados: Nuevo, Contactado, Cerrado
• Acciones masivas: Cambia el estado de múltiples leads
• Historial de conversación: Ve la conversación completa que llevó al lead
• Exportación: Posibilidad de exportar datos para CRM externos

Cada lead incluye información detallada como nombre, email, teléfono (opcional), y el log completo de la conversación.

Gestión de Baneos

El plugin incluye protección automática contra spam y comportamiento abusivo:

1. Ve a Experto en WP Chat > Baneos para gestionar IPs baneadas.

2. Los baneos se aplican automáticamente cuando se detecta contenido inapropiado.

3. Puedes desbanear IPs manualmente o limpiar el almacenamiento local.

4. Los baneos son temporales y se levantan automáticamente después del período establecido.

Configuraciones Avanzadas

Opciones adicionales disponibles en el panel de configuración:

• Modo de Depuración: Muestra información técnica para desarrollo
• Idioma de IA: Código de idioma para las respuestas de la IA
• Modelo de Gemini: Selección del modelo de IA a utilizar
• Configuración de Sesiones: Tiempo de vida de las sesiones de chat

Soporte Multiidioma

Idiomas Disponibles

El plugin incluye soporte completo para múltiples idiomas:

• Español (es_ES): Idioma por defecto
• Inglés (en_US): Soporte completo
• Otros idiomas: Fácilmente extensible

Configuración de Idioma

1. En Configuración, selecciona el idioma predeterminado de la interfaz.

2. Configura el “Idioma Default AI” para las respuestas de la inteligencia artificial.

3. La IA puede detectar automáticamente el idioma del usuario y adaptar sus respuestas.

4. Los textos de la interfaz se adaptan automáticamente al idioma seleccionado.

Personalización y Hooks

Hooks para Desarrolladores

El plugin proporciona múltiples hooks para extender su funcionalidad:

Hooks de acción:

• especialista_wp_chat_lead_captured – Se ejecuta cuando se captura un lead
• especialista_wp_chat_conversation_started – Al iniciar una conversación
• especialista_wp_chat_message_processed – Después de procesar un mensaje

Integraciones con CRM

Ejemplo de integración con un CRM externo:

add_action('especialista_wp_chat_lead_captured', 'enviar_lead_a_crm', 10, 3);

function enviar_lead_a_crm($lead_id, $lead_data, $conversation_history) {
    // Tu código de integración con CRM aquí
    // $lead_data contiene: nombre, email, teléfono, etc.
    // $conversation_history contiene el historial completo
}
      

Solución de Problemas

El chat no aparece en el sitio:

• Verifica que la clave de API de Gemini esté configurada correctamente
• Asegúrate de que el plugin esté activado
• Revisa la consola del navegador para errores de JavaScript

La IA no responde o da errores:

• Verifica tu clave de API en Google AI Studio
• Comprueba que el modelo de Gemini seleccionado esté disponible
• Activa el modo de depuración para ver errores detallados

Los leads no se guardan:

• Verifica que la tabla de base de datos se haya creado correctamente
• Comprueba los permisos de la base de datos
• Revisa los logs de PHP para errores

Problemas de rendimiento:

• El plugin usa transients para optimizar el rendimiento
• Los baneos y sesiones se limpian automáticamente
• Considera usar caché de objeto para sitios de alto tráfico

Para soporte adicional: Contacta con EspecialistaEnWP.com