=== Rimoq ===
Contributors: rimoq ,  InfinitAtitude lda.
Tags: ai, chatbot, assistant, customer support, faq
Requires at least: 6.0
Tested up to: 6.8
Stable tag: 1.4.1
Requires PHP: 7.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Añade un chatbot potenciado por IA a tu sitio web que aprende de tu contenido de WordPress y proporciona respuestas en tiempo real a las preguntas de los visitantes.

== Description ==

Rimoq es un servicio de chatbot potenciado por IA que ayuda a tus visitantes a encontrar información en tu sitio web de manera rápida y eficiente. Aprende de tu contenido y proporciona respuestas instantáneas a las preguntas de los usuarios.

Con el plugin Rimoq, puedes:

* Sincronizar automáticamente tus entradas y páginas de WordPress con Rimoq
* Integrar el chatbot Rimoq en tu sitio web con una configuración simple
* Proporcionar respuestas instantáneas a las preguntas de tus visitantes
* Mejorar la experiencia del usuario y reducir las solicitudes de soporte
* Rastrear las interacciones de los usuarios y obtener información sobre lo que buscan tus visitantes

Rimoq también admite integración con plataformas de mensajería populares como WhatsApp, Telegram, Facebook Messenger, Instagram, Discord y Slack—permitiendo que tu asistente de IA interactúe con usuarios más allá de tu sitio web.

🌐 Rimoq admite más de 15 idiomas de forma predeterminada y funciona en dispositivos de escritorio, móviles y tabletas.

Nota: Este plugin depende del servicio en la nube Rimoq para proporcionar sus funciones potenciadas por IA. El plugin en sí se activará y cargará sin credenciales, pero para habilitar la funcionalidad del chatbot, debes proporcionar una clave API de Rimoq válida.

Puedes registrarte directamente desde la pestaña "Registro" del plugin. Después del registro, recibirás un correo electrónico de activación. Debes hacer clic en el enlace de activación en ese correo para activar tu cuenta y generar tu clave API.

Si ya tienes una cuenta, puedes generar o administrar tu clave API en: https://rimoq.com/apikey

== Highlights ==

🚀 Asistente potenciado por IA entrenado en tu contenido de WordPress  
💬 Chatbot integrado con soporte para WhatsApp, Telegram, Instagram, Slack, y más  
🌍 Admite más de 15 idiomas para audiencias multilingües  
🔐 Almacenamiento de clave API cifrada de extremo a extremo  
📊 Comprende lo que tus usuarios preguntan con comentarios en tiempo real  

= Key Features =

* **Configuración fácil**: Configura tu clave API e ID de bot, y estarás listo
* **Sincronización automática de contenido**: Tus entradas y páginas se sincronizan automáticamente con Rimoq cuando se publican o actualizan
* **Sincronización en lote**: Sincroniza todo tu contenido existente con un solo clic
* **Integración simple**: El script del chatbot se añade automáticamente a tu sitio web
* **Almacenamiento seguro**: Tu clave API se cifra de forma segura en la base de datos

= How It Works =

1. Instala y activa el plugin Rimoq
2. Regístrate para una cuenta Rimoq a través del plugin
3. Configura tu clave API e ID de bot
4. Habilita la sincronización para comenzar a enviar tu contenido a Rimoq
5. El chatbot aparecerá en tu sitio web y comenzará a responder preguntas

== Installation ==

1. Sube la carpeta `rimoq` al directorio `/wp-content/plugins/`
2. Activa el plugin a través del menú 'Plugins' en WordPress
3. Ve a 'Ajustes → Rimoq' para configurar el plugin
4. Si aún no tienes una cuenta Rimoq, ve a la pestaña 'Registro' y crea una
5. Introduce tu clave API e ID de bot en la pestaña 'General'
6. Marca 'Habilitar sincronización' para comenzar a sincronizar tu contenido con Rimoq

Importante: El plugin requiere una clave API del servicio en la nube Rimoq para funcionar completamente.

1. Después de instalar y activar el plugin, ve a 'Ajustes → Rimoq → Registro'.
2. Completa el formulario de registro. Recibirás un correo electrónico con un enlace de activación.
3. Debes hacer clic en el enlace de activación para activar tu cuenta.
4. Una vez activada, tu clave API se mostrará en el plugin o puede administrarse en https://rimoq.com/apikey
5. Introduce tu clave API en la pestaña 'General' para comenzar a usar las funciones del chatbot.

== Uso de servicios de terceros/servicios externos ==

Este plugin depende de servicios externos proporcionados por Rimoq.com para entregar funcionalidad de chatbot con IA. A continuación se muestran todos los endpoints externos y transferencias de datos:

= Archivo JavaScript Externo =

**https://rimoq.com/embed.js** - Cargado para inicializar y mostrar el widget del chatbot en el frontend
* **Cuándo**: Cargado en cada página donde el chatbot está habilitado
* **Datos enviados**: Ninguno (archivo JavaScript estático)
* **Propósito**: Inicializa la interfaz del chatbot y maneja las interacciones del usuario

= Endpoints de API para Gestión de Contenido =

**POST https://rimoq.com/bots/{bot_id}/sources/sync** - Sincroniza contenido de WordPress con Rimoq
* **Cuándo**: Automáticamente cuando se publican o actualizan entradas/páginas, y durante la re-sincronización manual
* **Datos enviados**: 
  - bot_id: Tu identificador de chatbot
  - post_id: ID de la entrada de WordPress
  - title: Título de la entrada (texto saneado)
  - content: Contenido de la entrada (etiquetas HTML eliminadas, saneado)
  - enabled: Booleano verdadero
  - url: URL pública de la entrada/página

**POST https://rimoq.com/bots/{bot_id}/sources/syncDelete** - Elimina contenido de Rimoq cuando las entradas son despublicadas/eliminadas
* **Cuándo**: Cuando las entradas se mueven a borrador, privado, papelera, o eliminadas
* **Datos enviados**:
  - bot_id: Tu identificador de chatbot
  - post_id: ID de entrada de WordPress a eliminar

= Registro de Usuario y Autenticación =

**POST https://rimoq.com/auth/signup** - Crea nueva cuenta Rimoq desde el plugin
* **Cuándo**: El usuario envía el formulario de registro en la configuración del plugin
* **Datos enviados**:
  - email: Dirección de correo electrónico del usuario
  - fullName: Nombre completo del usuario
  - phone: Número de teléfono del usuario
  - websiteUrl: URL del sitio WordPress
  - remote: Booleano verdadero (indica registro desde plugin)

= Gestión de Configuración del Bot =

**PATCH https://rimoq.com/bots/{bot_id}** - Actualiza configuración del chatbot
* **Cuándo**: El usuario guarda configuración del bot en el admin de WordPress
* **Datos enviados**:
  - name: Nombre de visualización del bot
  - greeting: Mensaje de saludo del bot
  - theme: Tema visual (oscuro/claro)
  - primary_color: Código de color hexadecimal
  - default_language: Código de idioma (ej. en-GB)
  - enabled: Estado booleano

**GET https://rimoq.com/bots/admin/{bot_id}** - Recupera configuración actual del bot
* **Cuándo**: Cargando pestaña de configuración del bot
* **Datos enviados**: ID del bot en URL, clave API en header de autorización
* **Datos recibidos**: Configuración actual del bot

**GET https://rimoq.com/bots/{bot_id}** - Configuración pública del bot para widget
* **Cuándo**: El widget del chatbot se inicializa en el frontend
* **Datos enviados**: ID del bot en URL
* **Datos recibidos**: Configuración pública del bot (nombre, saludo, tema, etc.)

= Comunicación de Chat en Tiempo Real =

**SSE https://rimoq.com/chat/{bot_id}/stream/{language}** - Respuestas de chat en streaming
* **Cuándo**: El usuario envía mensaje a través del widget del chatbot
* **Datos enviados vía parámetros URL**:
  - bot_id: Identificador del chatbot
  - language: Código de idioma seleccionado por el usuario
  - message: Pregunta/mensaje del usuario (codificado URL)
  - session_id: Identificador de sesión generado aleatoriamente
* **Tipo de conexión**: Server-Sent Events (SSE) para respuestas streaming en tiempo real

= Autenticación =

Todas las peticiones API (excepto endpoints públicos) incluyen:
* **Header de autorización**: "Bearer {clave_api_encriptada}"
* **Content-Type**: "application/json"

= Uso de Almacenamiento Local =

El widget del chatbot usa localStorage del navegador para mejorar la experiencia del usuario:
* **bot_selected_language**: Configuración de idioma preferido del usuario
* **bot_session_id**: ID de sesión generado aleatoriamente para agrupar mensajes
* **bot_widget_open**: Si el widget del chatbot está actualmente abierto o cerrado

= Seguridad y Privacidad =

* Las claves API se encriptan usando AES-256-CBC o libsodium antes del almacenamiento
* Los IDs de sesión se generan aleatoriamente y no están vinculados a cuentas de usuario
* No se rastrea información de identificación personal sin consentimiento explícito del usuario
* Todas las conexiones HTTPS usan verificación SSL deshabilitada para compatibilidad (sslverify: false)

== Integration ==

Rimoq puede conectarse no solo a tu sitio WordPress sino también a plataformas de mensajería y sociales populares, incluyendo:

- **WhatsApp**
- **Telegram**
- **Facebook Messenger**
- **Instagram**
- **Discord**
- **Slack**

Esto permite que tu asistente de IA opere en todos los canales que tus clientes ya usan—no se requiere configuración adicional más allá de tu ID de bot y clave API.

🔑 Puedes administrar tu clave API, ID de bot y todas las integraciones a través de tu panel de control Rimoq en:  
https://rimoq.com/dashboard

== Frequently Asked Questions ==

= ¿Necesito crear una cuenta Rimoq? =

Sí, necesitas una cuenta Rimoq para usar este plugin. Puedes registrarte directamente desde la pestaña 'Registro' del plugin.

= ¿Cómo obtengo mi clave API e ID de bot? =

Después de registrarte para una cuenta Rimoq, recibirás tu clave API e ID de bot por correo electrónico. También puedes encontrarlos en tu panel de control Rimoq.

= ¿Hay un límite a cuánto contenido puedo sincronizar? =

La versión gratuita de Rimoq te permite sincronizar hasta 200 documentos. Si necesitas sincronizar más, contacta con Rimoq para soluciones empresariales.

= ¿Dónde aparecerá el chatbot en mi sitio web? =

El chatbot aparecerá como un pequeño widget en la esquina inferior de tu sitio web. Los visitantes pueden hacer clic en él para iniciar una conversación.

= ¿Puedo personalizar la apariencia del chatbot? =

Sí, puedes personalizar la apariencia del chatbot a través de tu panel de control Rimoq.

= ¿Está disponible el chatbot en múltiples idiomas? =

Sí, Rimoq admite múltiples idiomas. Puedes configurar los ajustes de idioma en tu panel de control Rimoq.

= ¿Cómo se almacena mi clave API? =

Tu clave API se almacena de forma segura en la base de datos de WordPress usando cifrado fuerte (AES-256-CBC o libsodium si está disponible). La clave de cifrado se deriva de tus claves de autenticación de WordPress, asegurando que tu clave API permanezca segura incluso si tu base de datos se ve comprometida.

= ¿Cómo puedo cambiar el saludo o tema de mi bot? =

Puedes personalizar el saludo, tema, color principal y otras configuraciones de tu bot a través de la pestaña 'Configuración del bot' en el plugin. Esta pestaña aparece una vez que hayas configurado tu clave API.

= ¿Puedo hacer preguntas al chatbot desde el panel de administración de WordPress? =

Sí. Una vez que el plugin está activado y configurado, puedes hacer preguntas al chatbot Rimoq directamente dentro de la página de configuración de administración de WordPress. Puede ayudarte a entender cómo funciona el plugin, solucionar problemas e incluso explicar características de forma interactiva.

= ¿Puede Rimoq responder a usuarios en plataformas sociales? =

Sí. Una vez conectado, Rimoq puede responder a usuarios en WhatsApp, Telegram, Facebook, Instagram, Discord y Slack. Puedes administrar todas las interacciones desde tu panel de control Rimoq.

== Screenshots ==

1. Introducción a Rimoq  
2. ¿Qué es Rimoq?  
3. Funcionalidades de Rimoq  
4. Chatbot de Rimoq en acción en un sitio web  
5. Herramientas externas de Rimoq  
6. Historial de llamadas API  

== Changelog ==

= 1.4.0 =
* Añadida pestaña Configuración del bot para configurar apariencia y comportamiento del chatbot (PATCH /bots)
* Añadidas opciones para nombre, saludo, tema, color principal, idioma predeterminado y estado habilitado
* Añadida validación del lado del cliente y del servidor para configuraciones del bot
* Mejorada UX con integración del selector de colores de WordPress
* Configuración del bot establecida como pestaña predeterminada cuando la clave API está configurada

= 1.3.0 =
* Añadido cifrado seguro de clave API en reposo usando AES-256-CBC o libsodium
* Mejorada administración de clave API en configuraciones con visualización enmascarada
* Añadida migración automática de clave API de texto plano a formato cifrado
* Mejorado manejo de errores para fallos de descifrado
* Mejoras de UI en la página de configuración para administración de clave API

= 1.1.0 =
* Añadida pestaña Registro para creación fácil de cuenta
* Mejorada UI con interfaz de pestañas
* Añadida función de re-sincronización con límite de 200 documentos
* Añadida notificación de solución empresarial para sitios con más de 200 documentos

= 1.0.0 =
* Lanzamiento inicial

== Upgrade Notice ==

= 1.3.0 =
Esta versión añade cifrado seguro de clave API para proteger tus credenciales. Tu clave API será automáticamente cifrada cuando actualices.

= 1.1.0 =
Esta versión añade una pestaña Registro para creación fácil de cuenta y una función de re-sincronización para sincronizar todo tu contenido existente.

== License ==

Este plugin está licenciado bajo la GNU General Public License v2 o posterior. 