BravesChat

Descripción

BravesChat es el puente entre tu sitio de WordPress y tus flujos de trabajo de N8N: conecta cualquier agente de IA que hayas creado con tus visitantes, sin código adicional y en cuestión de minutos.

Diseñado para la comunidad WordPress y N8N

  • Webhook listo para N8N: Apunta BravesChat a la URL de tu flujo de trabajo y empieza a recibir mensajes al instante. Admite un token de identificación en la cabecera (X-N8N-Auth) para proteger tus endpoints.
  • Carga útil completa en cada mensaje: Cada solicitud incluye el mensaje actual y el sessionId único del usuario: todo lo que tu Agente de N8N (nodo) necesita para mantener el contexto de la conversación.
  • Respuestas en Markdown: Los mensajes de tu agente se muestran con formato avanzado (negrita, listas, enlaces y código) sin necesidad de configuración adicional.
  • Historial de conversaciones: Explora todas las sesiones desde el panel de control de WordPress y expórtalas a tu CRM, hoja de cálculo o base de datos con un solo clic.

Listo para producción

  • Tres modos de visualización: Widget flotante, pantalla completa o mixto — burbuja global con pantalla completa en páginas específicas mediante un bloque de Gutenberg.
  • Panel de administración con modo oscuro: Alterna entre tema claro y oscuro. La preferencia se guarda por usuario y se restaura sin parpadeo.
  • Horario comercial configurable: Define cuándo está activo el chat y muestra un mensaje personalizado fuera de ese horario; ideal si tu agente depende de un humano en el proceso.
  • Cumplimiento del RGPD integrado: Banner de consentimiento que bloquea el chat hasta que el usuario lo acepta para poder chatear. La fuente Montserrat es cargada localmente, sin solicitudes externas.
  • Personalización completa de marca: Colores, textos, posición, skin y modo de visualización; todo ajustable sin tocar el código.
  • Seguridad reforzada: El token de identificación de N8N solo viaja en el servidor; nunca queda expuesto en el HTML de la página.
  • Compatible con WooCommerce: Funciona en tiendas de WooCommerce sin problemas, lo que permite ofrecer asistencia conversacional durante todo el proceso de compra.

Identificación de sesión mediante huella digital

BravesChat genera un identificador de sesión único sessionId para cada visitante basándose en las características del navegador (hash SHA-256), sin almacenar datos personales. Esto permite a N8N mantener el contexto de la conversación incluso si el usuario actualiza la página.

Servicios externos

Webhook N8N (configurado por ti)

Este plugin envía los mensajes del chat a una URL de webhook de N8N configurada por el administrador del sitio.

Qué datos se envían: El mensaje de chat del visitante, el historial de la conversación, un identificador de sesión anónimo (huella digital) y la URL de la página actual.

Cuándo: Cada vez que un visitante envía un mensaje a través del widget de chat, pero solo si el administrador ha configurado una URL de webhook.

Por qué: Para reenviar la conversación al flujo de trabajo N8N del administrador para su procesamiento mediante IA.

La URL del webhook, es decir, el servidor y todo el procesamiento de datos están totalmente bajo el control del administrador del sitio. No se envía ningún dato a ningún servidor gestionado por nosotros Braves Lab.

Capturas

  • Modo oscuro del panel de administración — tema oscuro completo con el nuevo interruptor.
  • Widget flotante en la portada — skin Braves mostrando diferentes comportamientos de visualización.
  • Apariencia — personalización de color, posición, skin, imagen de burbuja y modo de visualización.
  • Historial de conversaciones — visor por sesión con burbujas de chat y exportación a CSV.
  • Ajustes — Configuración del webhook de N8N, método de identificación y comportamiento del chat.

Bloques

Este plugin proporciona 1 bloque.

  • BravesChat — Full Screen

Instalación

  1. Sube la carpeta braveschat al directorio /wp-content/plugins/.
  2. Activa el plugin desde el menú Plugins de WordPress.
  3. Ve a «BravesChat Ajustes» e introduce la URL del webhook de N8N.
  4. (Opcional) Personaliza los colores, los textos y la posición en Apariencia.
  5. (Opcional) Configura el banner de consentimiento en RGPD.

FAQ

¿Necesito una cuenta de N8N para usar BravesChat?

Sí. BravesChat funciona como el widget de chat de tu WordPress, pero la inteligencia y las respuestas las gestiona tu propio flujo de trabajo de N8N. Puedes utilizar N8N Cloud o tu propia instancia self-hosted.

¿Funciona con cualquier agente de IA en N8N?

Sí. BravesChat envía el mensaje y la conversación sessionId a la URL del webhook que configures. El agente puede conectarse a OpenAI, Claude, Gemini, Ollama o cualquier modelo que admita tu flujo de trabajo; BravesChat no impone ninguna restricción.

¿Qué datos se envían al webhook con cada mensaje?

Cada solicitud incluye: el mensaje del usuario (chatInput) y el identificador único de sesión (sessionId). N8N gestiona el historial de conversaciones a través del sessionId.

¿Se guarda el historial de conversaciones en la base de datos de WordPress?

No. El historial que se muestra en el panel de administración se obtiene directamente de tu fuente de datos de N8N (por ejemplo, PostgreSQL) a través de un webhook independiente que tú mismo configuras, en nuestra pagina web puedes descargar el flujo.

¿Puedo ocultar el chat en algunas páginas?

Sí. En la sección ajustes puedes indicar las páginas en las que no debe aparecer el widget.

¿Es compatible con WooCommerce?

Sí, BravesChat es compatible con WooCommerce y no genera conflictos con el proceso de pago ni con los estilos de la tienda.

¿El plugin cumple con el RGPD?

Sí. Puedes activar un banner de consentimiento que bloquee el chat hasta que el usuario lo acepte. La identificación de usuarios no recopila datos personales. La fuente Montserrat se carga localmente, sin realizar solicitudes a Google Fonts.

¿Puedo usar BravesChat sin N8N?

Técnicamente sí: el webhook puede apuntar a cualquier endpoint HTTP que devuelva JSON con el campo output. Sin embargo, el plugin está optimizado y documentado para flujos de trabajo de N8N.

¿Es seguro el token de identificación de N8N?

Sí. El token solo viaja en el servidor; nunca queda expuesto en el HTML ni en el JavaScript de la página. La portada envía los mensajes al endpoint AJAX de WordPress, que actúa como proxy y añade el token antes de contactar con N8N.

Reseñas

No hay valoraciones para este plugin.

Colaboradores y desarrolladores

«BravesChat» es un software de código abierto. Las siguientes personas han colaborado con este plugin.

Colaboradores

«BravesChat» está traducido en 1 idioma. Gracias a los traductores por sus contribuciones.

Traduce «BravesChat» a tu idioma.

¿Interesado en el desarrollo?

Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.

Registro de cambios

2.4.6

  • CORREGIDO: Los enlaces del chat procedentes de respuestas de IA con protocolos que no son HTTP (p. ej. javascript:) ya no se muestran; solo se aceptan https:// y http://. Previene posibles ataques XSS en respuestas de agentes maliciosos.
  • CORREGIDO: El nombre de la cabecera de identificación se sanea antes de usarse para prevenir inyección de cabeceras.
  • FIXED: History modal no longer shows hardcoded Spanish labels («Conversación Anónima», «Session:», «Usuario») — all strings are now translatable.
  • AÑADIDO: Los versículos bíblicos en la cabecera del panel aparecen ahora en inglés cuando WordPress no está configurado en español.
  • MEJORA: La línea de tiempo del changelog en la página «Acerca de» ya no requiere valores de espaciado manual — añadir una nueva entrada es tan sencillo como indicar braves-tl-right o braves-tl-left.

2.4.5

  • CORREGIDO: Eliminada la dependencia de Bible API — los versículos ahora se sirven desde un archivo local con 365 versículos NVI. Sin peticiones externas.
  • AÑADIDO: Traducción completa al inglés de la interfaz de usuario de administración con compatibilidad con i18n para es_ES.
  • AÑADIDO: Página «Acerca de» traducida al inglés; las traducciones en español se conservan en el archivo .po.
  • CORREGIDO: El token de identificación de N8N ya no se expone mediante console.log en el navegador.
  • CORREGIDO: Añadida validación del esquema HTTP/HTTPS antes de las llamadas a wp_remote_get().
  • CORREGIDO: $_GET[‘page’] saneado y valores booleanos correctamente escapados en los campos ocultos.
  • CORREGIDO: El patrón i18n en admin.js se ha actualizado para usar const { __ } = wp.i18n — compatible con wp i18n make-json.

2.4.4

  • MEJORA: Todas las cadenas visibles para el usuario en el JavaScript del panel de administración ahora son totalmente traducibles a través de la internacionalización de WordPress (wp.i18n.__).
  • MEJORA: Script de administración registrado con compatibilidad con traducciones: los archivos de idioma JSON se cargan automáticamente para la configuración regional activa.
  • CORREGIDO: El texto predeterminado codificado directamente en la burbuja, el pie de pantalla y los campos de ajustes es ahora traducible; no más cadenas sin traducir en instalaciones en idiomas distintos al inglés.

2.4.3

  • AÑADIDO: Modo de visualización mixto — burbuja flotante en todas las páginas, chat a pantalla completa en las páginas con el bloque de Gutenberg.
  • MEJORA: El widget de chat fuerza ahora el esquema de color claro, evitando que el modo oscuro de iOS Safari invierta los colores del widget.
  • MEJORA: Los colores del banner de RGPD están ahora completamente aislados del modo oscuro del tema — los colores de texto se mantienen coherentes en todos los temas.
  • CORREGIDO: El modo de bloque de pantalla completa ahora muestra una superposición de fondo que oculta el fondo blanco de la página mientras se carga el chat.
  • CORREGIDO: El color del texto de marcador de posición del campo de chat ya no hereda del tema activo.
  • CORREGIDO: El CSS de pantalla completa ahora siempre se carga en las páginas que usan el bloque de Gutenberg de pantalla completa, independientemente del ajuste global del modo de visualización.

2.4.2

  • AÑADIDO: Modo oscuro para el panel de administración — alterna entre tema claro y oscuro. La preferencia se guarda por usuario y se restaura en cada carga de página sin parpadeo.
  • MEJORA: La interfaz de administración usa variables CSS semánticas en todas partes — el modo oscuro se adapta automáticamente sin colores codificados directamente.
  • MEJORA: Los botones de seleccionar/anular selección de todas las páginas en Ajustes tienen ahora un estilo coherente con el resto del panel de administración.
  • MEJORA: Los estilos en línea se han eliminado del texto de ayuda de los campos y las etiquetas de rango; los estilos provienen ahora de clases CSS para un mejor soporte del modo oscuro.
  • MEJORA: La vista previa de mensajes ya no inyecta estilos en línea codificados directamente; usa una clase CSS en su lugar.

2.4.0

  • AÑADIDO: Modo de pantalla completa en móvil — en dispositivos de hasta 480px el chat se abre como una superposición a pantalla completa con su propia cabecera, botones de retroceso/cierre y compatibilidad con el área segura de iOS.
  • MEJORA: Compatibilidad con WooCommerce — z-index ajustado para que los elementos del carrito y de finalizar compra de WooCommerce siempre se muestren por encima del widget de chat.
  • MEJORA: El logotipo ahora se muestra como una etiqueta img estándar en lugar de SVG en línea — compatible con configuraciones estrictas de Política de Seguridad de Contenido.
  • MEJORA: Los scripts de administración se han trasladado de las plantillas PHP a wp_add_inline_script — resuelve las advertencias de Plugin Check (PCP) sobre scripts en línea en plantillas.
  • MEJORA: El SVG del icono de menú se sanea antes de codificarse como URI de datos para evitar problemas de renderizado en algunos navegadores.
  • MEJORA: Versión de estilo añadida a wp_register_style para un vaciado de caché fiable en las actualizaciones del plugin.
  • CORREGIDO: La selección del versículo diario usa ahora gmdate en lugar de date para una rotación correcta basada en UTC.
  • CORREGIDO: Añadida la declaración de servicio externo a la integración con API.Bible para cumplir con los requisitos de WordPress.org.

2.3.8

  • AÑADIDO: Aparece un versículo bíblico (NIV) en la cabecera del panel cada día. Se actualiza automáticamente sin necesidad de configuración.

2.3.7

  • AÑADIDO: Campo «Nombre del agente» en «Apariencia»: asigna un nombre a tu agente para identificar las conversaciones en el «Historial».
  • MEJORA: Los avisos de estado (advertencias de configuración, confirmaciones de guardado) se han trasladado a la barra de cabecera — diseño de página más limpio en todas las secciones del panel.
  • MEJORA: Etiquetas de navegación de la barra lateral actualizadas — «Schedules» «Availability», «GDPR» «Privacy», «History» «Conversations».
  • MEJORA: La insignia de versión en la cabecera se resalta cuando estás en la página «Acerca de».
  • MEJORA: Las etiquetas de las opciones de modo de visualización y skin reescritas para mayor claridad.
  • MEJORA: El changelog de la página «Acerca de» rediseñado como una línea de tiempo en dos columnas.

2.3.5

  • CORREGIDO: El botón de subida de imagen en Apariencia ahora abre correctamente la biblioteca multimedia de WordPress.

2.3.4

  • MEJORA: La burbuja del chat ahora es más pequeña en dispositivos móviles — el skin predeterminado se reduce a 48×48px, el skin Braves adopta una disposición compacta de avatar + botón.

2.3.3

  • CORREGIDO: Dominio de texto actualizado a braveschat en todos los archivos para coincidir con el slug asignado por WordPress.org. Resuelve todos los errores de dominio de texto de Plugin Check (PCP).

2.3.2

  • CORREGIDO: Discrepancia en el dominio de texto detectada por Plugin Check — el ZIP distribuido usa ahora el slug correcto del plugin (braves-chat) para que el dominio de texto se valide correctamente en WordPress.org.

2.3.1

  • MEJORA: El campo de texto permanece activo mientras el bot responde; los usuarios pueden escribir e interrumpir en cualquier momento.

2.3.0

  • AÑADIDO: El token de identificación de N8N ahora solo viaja en el servidor; nunca queda expuesto en el navegador.
  • AÑADIDO: Tres métodos de autenticación para N8N: encabezado personalizado, autenticación básica o ninguno.
  • MEJORA: JavaScript de la portada simplificado eliminando la lógica de streaming/NDJSON; toda la complejidad de la conexión con N8N se gestiona ahora en el servidor.
  • MEJORA: Las imágenes del plugin se han convertido a PNG para mayor compatibilidad con navegadores y WordPress.org.
  • MEJORA: Licencia actualizada a GPL-2.0-or-later, alineada con los requisitos de WordPress.org.
  • CORREGIDO: Eliminada la clase de detección de exportación ZIP que generaba falsos positivos.

2.2.3

  • AÑADIDO: Enlace «Ver detalles» en la lista de plugins con información completa del plugin.
  • MEJORA: Editor de texto enriquecido para mensajes de RGPD y mensajes fuera de horario.

2.2.2

  • AÑADIDO: La clase de protección detecta plugins de exportación ZIP instalados en el sitio y muestra un aviso de seguridad en el panel de administración.

2.2.1

  • CORREGIDO: Los avisos de otros complementos ya no aparecen dentro del panel de BravesChat. (Restituido)

2.2.0

  • AÑADIDO: Visor completo del historial de conversaciones con modal por sesión.
  • NUEVO: Exportación del historial a CSV con todos los campos relevantes.
  • MEJORA: Las conversaciones ahora se ordenan de la más reciente a la más antigua.

2.1.5

  • AÑADIDO: La página «Historial» sustituye a «Estadísticas» — abre cualquier sesión y lee el hilo completo de la conversación con burbujas de chat, marcas de tiempo y etiquetas de remitente.
  • AÑADIDO: Exportación a CSV con todos los campos: ID de sesión, nombre de cliente, fecha de actualización, historial completo en JSON.
  • MEJORA: Los mensajes se muestran en orden cronológico dentro de la ventana emergente de la sesión.
  • CORREGIDO: Las llamadas internas a herramientas de N8N y las respuestas JSON se filtran del visor de conversaciones.

2.1.4

  • AÑADIDO: Pestaña «Estadísticas» con el historial de conversaciones en tiempo real obtenido de tu webhook de N8N/Postgres.
  • AÑADIDO: Exportación a CSV con todos los campos: session_id, client_mail, last_message, updated_at, chat_history, metadata.

2.1.3

  • CORREGIDO: El flujo de publicación de GitHub Actions ahora se activa correctamente en etiquetas v* — generación automática de ZIP funcionando.

2.1.2

  • MEJORA: Sistema de aislamiento CSS para evitar conflictos con los temas.

2.1.1

  • MEJORA: Renderizado de Markdown incremental en tiempo real.

2.1.0

  • NUEVO: Control configurable de velocidad de escritura.
  • AÑADIDO: Compatibilidad con HTML/Markdown en el mensaje del banner de RGPD.
  • AÑADIDO: Montserrat se carga localmente (cumplimiento del RGPD).

2.0.0

  • PRINCIPAL: Reestructuración completa del sistema con el nuevo namespace BravesChat.
  • AÑADIDO: Botón de maximizar, aumento automático del tamaño del cuadro de texto, y otros estados como minimizado.

1.2.4

  • AÑADIDO: Las burbujas de información emergente se pueden personalizar desde el panel «Apariencia».
  • AÑADIDO: Detección automática y desactivación de versiones anteriores del plugin al activarlo.
  • MEJORA: Se ha actualizado el color por defecto del icono a #f2f2f2.

1.2.3

  • AÑADIDO: Personalización completa de color — colores de burbuja, primario, fondo y texto con selectores de color nativos.
  • AÑADIDO: Selector de iconos SVG con cuatro estilos (original, círculo, feliz, burbuja).
  • CORREGIDO: Eliminada la dependencia de la CDN de Lottie Player — sustituida por SVG estático.

1.2.2

  • CORREGIDO: Crítico — los campos de formulario no se muestran en «Ajustes», «Apariencia», «Programaciones» y «Páginas RGPD».
  • CORREGIDO: Los ajustes de otras pestañas se perdían al guardar un formulario parcial.
  • MEJORA: El aviso de administrador se oculta automáticamente después de 3 segundos con una animación de deslizamiento.

1.2.1

  • MEJORA: Rediseño completo del panel de administración con disposición de tarjetas Bentō.
  • AÑADIDO: Navegación de barra lateral compartida en todas las secciones de administración.
  • AÑADIDO: Arquitectura de componentes reutilizables: encabezado, barra lateral y contenido.

1.2.0

  • AÑADIDO: Nuevo sistema de administración con un escritorio moderno y diseño Bentō.

1.1.2

  • CAMBIO: Cambio de marca de Weblandia a BravesLab — actualizadas las URLs, el autor y el copyright.

1.1.1

  • AÑADIDO: Sistema de cookies con huella digital del dispositivo para la identificación de la sesión.

1.1.0

  • AÑADIDO: Horarios de disponibilidad con soporte de zona horaria y mensaje personalizado fuera de línea.
  • AÑADIDO: Páginas excluidas — configura en qué páginas no debe mostrarse el widget de chat.
  • AÑADIDO: Compatibilidad con token de identificación de N8N mediante la cabecera X-N8N-Auth.

1.0.0

  • Primera versión del plugin.