Title: BravesChat
Author: Carlos Vera
Published: <strong>12 de abril de 2026</strong>
Last modified: 23 de abril de 2026

---

Buscar plugins

![](https://ps.w.org/braveschat/assets/banner-772x250.png?rev=3504223)

![](https://ps.w.org/braveschat/assets/icon-256x256.png?rev=3504223)

# BravesChat

 Por [Carlos Vera](https://profiles.wordpress.org/carlosvera/)

[Descargar](https://downloads.wordpress.org/plugin/braveschat.2.4.6.zip)

 * [Detalles](https://es.wordpress.org/plugins/braveschat/#description)
 * [Valoraciones](https://es.wordpress.org/plugins/braveschat/#reviews)
 *  [Instalación](https://es.wordpress.org/plugins/braveschat/#installation)
 * [Desarrollo](https://es.wordpress.org/plugins/braveschat/#developers)

 [Soporte](https://wordpress.org/support/plugin/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

 *   [ Carlos Vera ](https://profiles.wordpress.org/carlosvera/)

«BravesChat» está traducido en 1 idioma. Gracias a [los traductores](https://translate.wordpress.org/projects/wp-plugins/braveschat/contributors)
por sus contribuciones.

[Traduce «BravesChat» a tu idioma.](https://translate.wordpress.org/projects/wp-plugins/braveschat)

### ¿Interesado en el desarrollo?

[Revisa el código](https://plugins.trac.wordpress.org/browser/braveschat/) , echa
un vistazo al [repositorio SVN](https://plugins.svn.wordpress.org/braveschat/) o
suscríbete al [registro de desarrollo](https://plugins.trac.wordpress.org/log/braveschat/)
por [RSS](https://plugins.trac.wordpress.org/log/braveschat/?limit=100&mode=stop_on_copy&format=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.

## Meta

 *  Versión **2.4.6**
 *  Última actualización **hace 2 semanas**
 *  Instalaciones activas **Menos de 10**
 *  Versión de WordPress ** 5.8 o superior **
 *  Probado hasta **6.9.4**
 *  Versión de PHP ** 7.4 o superior **
 *  Idiomas
 * [English (US)](https://wordpress.org/plugins/braveschat/) y [Spanish (Spain)](https://es.wordpress.org/plugins/braveschat/).
 *  [Traducir a tu idioma](https://translate.wordpress.org/projects/wp-plugins/braveschat)
 * Etiquetas:
 * [AI](https://es.wordpress.org/plugins/tags/ai/)[chat](https://es.wordpress.org/plugins/tags/chat/)
   [chatbot](https://es.wordpress.org/plugins/tags/chatbot/)[n8n](https://es.wordpress.org/plugins/tags/n8n/)
   [webhook](https://es.wordpress.org/plugins/tags/webhook/)
 *  [Vista avanzada](https://es.wordpress.org/plugins/braveschat/advanced/)

## Valoraciones

Aún no se han enviado valoraciones.

[Your review](https://wordpress.org/support/plugin/braveschat/reviews/#new-post)

[Ver todas las valoraciones](https://wordpress.org/support/plugin/braveschat/reviews/)

## Colaboradores

 *   [ Carlos Vera ](https://profiles.wordpress.org/carlosvera/)

## Soporte

¿Tienes algo que decir? ¿Necesitas ayuda?

 [Ver el foro de soporte](https://wordpress.org/support/plugin/braveschat/)