InicioDocumentación

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)

  1. Vaya a Plugins → Añadir nuevo en el administrador de WordPress
  2. Busque ChatReact
  3. Haga clic en Instalar ahora, luego Activar

Método 2: Subir vía administrador de WordPress

  1. Descargue el archivo ZIP del plugin arriba
  2. Vaya a Plugins → Añadir nuevo → Subir plugin
  3. Elija el archivo ZIP y haga clic en Instalar ahora
  4. Haga clic en Activar plugin

Método 3: Subida manual vía FTP

  1. Extraiga el archivo ZIP
  2. Suba la carpeta chatreact a /wp-content/plugins/
  3. Vaya a Plugins en el administrador de WordPress
  4. 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

  1. Inicie sesión en chatreact.ai
  2. Abra su chatbot y vaya a la pestaña Integración
  3. Haga clic en Copiar código para copiar el fragmento de incrustación, o lea el ID desde el atributo data-chatbot-id en el código copiado

Cómo encontrar su ID de formulario

  1. Inicie sesión en chatreact.ai
  2. Vaya a Formularios
  3. Haga clic en Copiar código de inserción en su formulario (o abra el formulario y cambie a la pestaña Integración)
  4. Su ID de formulario es el valor de data-form-id en 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:

  1. Haga clic en + para añadir un bloque
  2. Busque "ChatReact"
  3. Elija ChatReact Chat, ChatReact Form o ChatReact FAQ
  4. Introduzca su ID en la configuración del bloque

3. Elementor

Si usa Elementor:

  1. Edite su página con Elementor
  2. Busque "ChatReact" en los widgets
  3. Arrastre el widget a su página
  4. 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:

  1. Abra el menú ChatReact en la barra lateral del administrador
  2. En la pestaña Chat Widget, encuentre Widget Assignments
  3. Haga clic en Add Assignment, elija una página o entrada (o seleccione Everywhere) y escriba su Chatbot ID
  4. 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:

  1. Edite cualquier página o entrada
  2. Encuentre la caja meta "ChatReact Widget"
  3. Marque Enable custom widget for this page
  4. Ingrese su Chatbot ID y opcionalmente elija una posición (Default, Bottom Right, Bottom Left)
  5. 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

  1. Verifique que su Chatbot ID sea correcto
  2. Compruebe si el chatbot está activo en su panel de ChatReact
  3. Limpie cualquier plugin de caché de página (ver más abajo)
  4. 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):

  1. Limpie la caché del plugin de caché
  2. Excluya chatreact de la minificación/combinaión de JS en los ajustes de su plugin de caché
  3. El plugin usa atributos data-api-url como 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 !important en 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

  1. Genere una Integration Key en el panel de ChatReact (Knowledge Base → Websites → CMS Integrations)
  2. Pegue la key en los ajustes del plugin de WordPress bajo la pestaña Integration
  3. Seleccione los tipos de contenido que desea compartir (Pages, Posts, Custom Post Types)
  4. Establezca prioridades (High/Medium/Low) por tipo de contenido
  5. 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

PriorityDefault forDescription
HighPagesContenido central del negocio (Acerca de, Servicios, Contacto)
MediumPostsArtí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_color y auto_open (language sigue siendo compatible)

Próximos pasos