WordPress Plugin
Agregue chatbots de ChatReact AI, formularios de contacto y acordiones de FAQ a su sitio de WordPress con nuestro plugin oficial.
Descargar
El plugin está disponible en el Directorio de Plugins de WordPress oficial, o como descarga directa:
Descargar ChatReact Plugin v1.2.1
Instalación
Método 1: Directorio de Plugins de WordPress (Recomendado)
- Vaya a Plugins → Añadir nuevo en el administrador de WordPress
- Busque ChatReact
- Haga clic en Instalar ahora, luego Activar
Método 2: Subir vía administrador de WordPress
- Descargue el archivo ZIP del plugin arriba
- Vaya a Plugins → Añadir nuevo → Subir plugin
- Elija el archivo ZIP y haga clic en Instalar ahora
- Haga clic en Activar plugin
Método 3: Subida manual vía FTP
- Extraiga el archivo ZIP
- Suba la carpeta
chatreacta/wp-content/plugins/ - Vaya a Plugins en el administrador de WordPress
- Busque "ChatReact" y haga clic en Activar
Configuración
Tras la activación, abra el menú ChatReact en la barra lateral del administrador de WordPress para las opciones y las instrucciones de uso.
Cómo encontrar su ID de chatbot
- Inicie sesión en chatreact.ai
- Abra su chatbot y vaya a la pestaña Integración
- Haga clic en Copiar código para copiar el fragmento de incrustación, o lea el ID desde el atributo
data-chatbot-iden el código copiado
Cómo encontrar su ID de formulario
- Inicie sesión en chatreact.ai
- Vaya a Formularios
- Haga clic en Copiar código de inserción en su formulario (o abra el formulario y cambie a la pestaña Integración)
- Su ID de formulario es el valor de
data-form-iden el código de incrustación copiado
Opciones de uso
El plugin ofrece varias formas de añadir ChatReact a su sitio:
1. Shortcodes
Añádalo a cualquier página, entrada o área de widget:
Chat Widget:
[chatreact id="YOUR_CHATBOT_ID"]
Atributos opcionales: language
Formulario de contacto:
[chatreact_form id="YOUR_FORM_ID"]
Atributos opcionales: language
Acordión de FAQ:
[chatreact_faq id="YOUR_CHATBOT_ID"]
Atributos opcionales: categories, container, language
Los ajustes visuales como posición, colores y apertura automática se gestionan de forma centralizada en su panel de ChatReact y se aplican automáticamente en su sitio de WordPress. El atributo language es opcional en todos los shortcodes: si lo omite, el idioma de la página actual se detecta automáticamente (funciona con sitios multilingües).
2. Bloques de Gutenberg
En el editor de bloques:
- Haga clic en + para añadir un bloque
- Busque "ChatReact"
- Elija ChatReact Chat, ChatReact Form o ChatReact FAQ
- Introduzca su ID en la configuración del bloque
3. Elementor
Si usa Elementor:
- Edite su página con Elementor
- Busque "ChatReact" en los widgets
- Arrastre el widget a su página
- Configure en el panel izquierdo
4. Asignaciones de widget (Ajustes del plugin)
Muestre un chatbot en páginas específicas — o en todo su sitio — sin editar contenido:
- Abra el menú ChatReact en la barra lateral del administrador
- En la pestaña Chat Widget, encuentre Widget Assignments
- Haga clic en Add Assignment, elija una página o entrada (o seleccione Everywhere) y escriba su Chatbot ID
- Haga clic en Guardar cambios
Para asignaciones Everywhere puede excluir URLs específicas — una por línea, con soporte de comodines (p. ej. /blog/* o /checkout) — para ocultar el widget en páginas de aterrizaje o durante el checkout.
Por defecto solo las Páginas son buscables al asignar. Haga clic en el botón Post Types para que otros tipos de contenido (p. ej. Entradas o tipos de entrada personalizados) también sean buscables.
5. Asignación a nivel de página
Asigne un chatbot a una sola página directamente desde el editor:
- Edite cualquier página o entrada
- Encuentre la caja meta "ChatReact Widget"
- Marque Enable custom widget for this page
- Ingrese su Chatbot ID y opcionalmente elija una posición (Default, Bottom Right, Bottom Left)
- Guarde la página
La misma caja meta también ofrece la opción Disable all widgets on this page si desea ocultar ChatReact completamente en ciertas páginas.
Ejemplos de shortcodes
Chat Widget básico
[chatreact id="abc123"]
Chat Widget con idioma fijo
[chatreact id="abc123" language="de"]
FAQ con filtro por categoría
[chatreact_faq id="abc123" categories="shipping,returns"]
Formulario de contacto con estilo
[chatreact_form id="form123" language="en"]
Widget de FAQ: SEO y caché
FAQs amigables con SEO
Desde la versión 1.1.2, los widgets de FAQ se renderizan del lado del servidor: sus FAQs forman parte del HTML de la página e incluyen datos estructurados JSON-LD (esquema FAQPage). Los motores de búsqueda y asistentes de IA pueden leerlos sin ejecutar JavaScript.
llms.txt para rastreadores de IA
El plugin puede servir su contenido de FAQ en yoursite.com/llms.txt, un archivo de descubrimiento leído por rastreadores de IA. Está habilitado por defecto. Para activarlo/desactivarlo o establecer un Chatbot ID específico para el archivo, vaya a ChatReact → FAQ Widget → Cache & SEO Settings.
Cache de FAQ
Los datos de FAQ se almacenan en caché en su servidor para cargas de página rápidas. Bajo ChatReact → FAQ Widget → Cache & SEO Settings puede:
- Establecer la Cache Duration — 1, 3, 6 (recomendado), 12 o 24 horas, o desactivar la caché
- Hacer clic en Clear Cache para actualizar sus FAQs de inmediato
La caché también se purga automáticamente cada vez que sus FAQs cambian en el panel de ChatReact.
Idiomas compatibles
El plugin admite 24 idiomas de la UE:
- búlgaro, croata, checo, danés, neerlandés, inglés
- estonio, finés, francés, alemán, griego, húngaro
- irlandés, italiano, letón, lituano, maltés, polaco
- portugués, rumano, eslovaco, esloveno, español, sueco
Desde la versión 1.2.0, las traducciones para los 24 idiomas vienen incluidas con el plugin. El idioma del widget se detecta automáticamente según la página actual, por lo que los sitios multilingües funcionan de inmediato — use el atributo language del shortcode solo si desea forzar un idioma específico.
Solución de problemas
Widget que no aparece
- Verifique que su Chatbot ID sea correcto
- Compruebe si el chatbot está activo en su panel de ChatReact
- Limpie cualquier plugin de caché de página (ver más abajo)
- Revise la consola del navegador para errores de JavaScript
Compatibilidad con plugins de caché
El plugin es totalmente compatible con plugins populares de caché y optimización, incluyendo WP Rocket, LiteSpeed Cache, Autoptimize y WP Super Cache. El plugin previene automáticamente que estas herramientas minifiquen o cacheen los scripts de ChatReact.
Si aún experimenta problemas (p. ej., errores 404, widget que no carga para visitantes desconectados):
- Limpie la caché del plugin de caché
- Excluya
chatreactde la minificación/combinaión de JS en los ajustes de su plugin de caché - El plugin usa atributos
data-api-urlcomo respaldo para asegurar la comunicación correcta con la API
FAQs que no se actualizan
Si su sitio muestra FAQs desactualizadas, vaya a ChatReact → FAQ Widget y haga clic en Clear Cache. La caché también se limpia automáticamente cuando edita sus FAQs en el panel de ChatReact.
Conflictos de estilo
Si el widget se ve roto:
- El widget usa CSS aislado
- Compruebe si hay reglas CSS
!importanten su tema - Intente desactivar temporalmente otros plugins de chat
Varios widgets
Puede usar distintos chatbots en diferentes páginas especificando IDs únicos en cada shortcode o bloque.
Integración con CMS (Smart Sitemap)
A partir de la versión 1.1.0, el plugin de ChatReact para WordPress incluye una función Smart Sitemap que proporciona al rastreador de ChatReact metadatos de contenido estructurado directamente desde su sitio de WordPress.
Cómo funciona
- Genere una Integration Key en el panel de ChatReact (Knowledge Base → Websites → CMS Integrations)
- Pegue la key en los ajustes del plugin de WordPress bajo la pestaña Integration
- Seleccione los tipos de contenido que desea compartir (Pages, Posts, Custom Post Types)
- Establezca prioridades (High/Medium/Low) por tipo de contenido
- Al rastrear su sitio, ChatReact usará automáticamente el smart sitemap en lugar del descubrimiento basado en enlaces
Beneficios
- Rastreo más rápido – Lista directa de URLs en lugar de descubrimiento enlace por enlace
- Conocimiento del tipo de contenido – El rastreador sabe si una URL es una Page, Post o Custom Post Type
- Indexación basada en prioridades – El contenido importante (como Pages) puede tener mayor peso que las entradas del blog
- Compartición selectiva – Comparta solo los tipos de contenido que desee
- Exclusión por entrada – Excluya publicaciones/páginas individuales del sitemap mediante la caja meta
Niveles de prioridad
| Priority | Default for | Description |
|---|---|---|
| High | Pages | Contenido central del negocio (Acerca de, Servicios, Contacto) |
| Medium | Posts | Artículos de blog, noticias |
| Low | – | Contenido complementario |
Seguridad
El endpoint del smart sitemap (/wp-json/chatreact/v1/sitemap) está protegido por la Integration Key. No es visible para motores de búsqueda u otros rastreadores — solo ChatReact puede acceder con la key correcta.
Si un plugin de seguridad restringe la REST API de WordPress a usuarios autenticados, la versión 1.2.1 y posteriores todavía permiten que las solicitudes de ChatReact con una Integration Key válida lleguen a /wp-json/chatreact/v1/ — todas las demás rutas REST permanecen bloqueadas. Si un firewall bloquea el endpoint antes de que WordPress cargue, permita /wp-json/chatreact/v1/ allí. Siempre que el smart sitemap no pueda alcanzarse, la vista previa del escaneo en el panel de ChatReact muestra la razón y recurre al sitemap público, que ignora su selección de tipos de contenido.
Exclusión de entradas individuales
En el editor de WordPress, cada entrada/página tiene una caja meta ChatReact Widget con una opción para "Exclude from ChatReact Sitemap". Las entradas marcadas no aparecerán en el smart sitemap.
Requisitos
- WordPress 5.8 o superior
- PHP 7.4 o superior
- Una cuenta de ChatReact (sign up free)
Registro de cambios
1.2.1
- FIX: Smart sitemap accesible nuevamente en sitios que restringen la REST API a usuarios autenticados — las solicitudes con una Integration Key válida son permitidas, por lo que los tipos de contenido seleccionados se respetan al escanear
1.2.0
- NEW: Traducciones empaquetadas para los 24 idiomas oficiales de la UE
1.1.3
- FIX: Los widgets de FAQ de una sola categoría ya no muestran un botón de filtro "All" innecesario ni insignias de categoría
1.1.2
- NEW: Renderizado del lado del servidor para widgets de FAQ — las FAQs son visibles para motores de búsqueda y LLMs sin JavaScript
- NEW: Datos estructurados JSON-LD (esquema FAQPage) para mejorar el SEO y los resultados enriquecidos
- NEW: Endpoint llms.txt para descubrimiento por rastreadores de IA
- NEW: Purga automática de la caché de FAQ cuando el contenido cambia en el panel de ChatReact
1.1.1
- FIX: Mejoras en traducciones (rumano, neerlandés)
1.1.0
- NEW: Smart Sitemap (CMS Integration) — compartición de contenido estructurado con el rastreador de ChatReact
- NEW: Pestaña Integration en los ajustes del plugin
- NEW: Selección de tipos de contenido con niveles de prioridad
- NEW: Exclusión por entrada del sitemap mediante caja meta
- NEW: Endpoint REST API protegido para el smart sitemap
- FIX: Compatibilidad total con plugins de caché (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
- FIX: Problemas de carga del widget para visitantes desconectados con plugins de caché
1.0.24
- Widget Assignments — asigne chatbots a páginas directamente desde los ajustes del plugin
- Soporte de bloques de Gutenberg
- Integración con Elementor
- Traducciones a 24 idiomas
- Asignación de widget a nivel de página
- CHANGED: Los ajustes del widget ahora se gestionan de forma centralizada en el panel de ChatReact — se eliminaron los atributos de shortcode
position,primary_coloryauto_open(languagesigue siendo compatible)