InicioDocumentación

Complemento de WordPress

Agregue chatbots de IA de ChatReact, formularios de contacto y acordiones de FAQ a su sitio WordPress con nuestro complemento oficial.

Descarga

El complemento está disponible en el Directorio oficial de complementos de WordPress, o como descarga directa:

Download ChatReact Plugin v1.2.0

Instalación

Método 1: Directorio de complementos 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 en Activar

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

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

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

Después de la activación, abra el menú ChatReact en la barra lateral del administrador de WordPress para ajustes e instrucciones de uso.

Cómo encontrar su ID de Chatbot

  1. Inicie sesión en chatreact.ai
  2. Vaya al Dashboard de su chatbot
  3. Haga clic en el botón Copy junto al Chatbot ID (mostrado en la parte superior)

Cómo encontrar su ID de formulario

  1. Inicie sesión en chatreact.ai
  2. Vaya a Forms
  3. Haga clic en Copy embed code en su formulario (o abra el formulario y cambie a la pestaña Embed)
  4. Su Form ID es el valor de data-form-id en el código embed copiado

Opciones de uso

El complemento ofrece varias maneras de agregar ChatReact a su sitio:

1. Shortcodes

Agregue a cualquier página, entrada o área de widgets:

Chat Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Atributos opcionales: language

Contact Form:

[chatreact_form id="YOUR_FORM_ID"]

Atributos opcionales: language

FAQ Accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Atributos opcionales: categories, container, language

La configuración visual, como la posición, los colores y la apertura automática, se gestionan centralmente en su dashboard de ChatReact y se aplican a su sitio WordPress automáticamente. El atributo language es opcional en todos los shortcodes: si lo omite, se detecta automáticamente el idioma de la página actual (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. Ingrese su ID en la configuración del bloque

3. Elementor

Si utiliza 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 complemento)

Muestre un chatbot en páginas específicas — o en todo su sitio — sin editar ningún contenido:

  1. Abra el menú ChatReact en la barra lateral de su administrador
  2. En la pestaña Chat Widget, busque Widget Assignments
  3. Haga clic en Add Assignment, elija una página o entrada (o seleccione Everywhere) e ingrese su Chatbot ID
  4. Haga clic en Save Changes

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 proceso de pago.

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 entradas personalizados) sean buscables también.

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 el meta box "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

El mismo meta box también ofrece una opción Disable all widgets on this page si desea ocultar ChatReact completamente en ciertas páginas.

Ejemplos de Shortcode

Widget básico de chat

[chatreact id="abc123"]

Widget de chat 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 los asistentes de IA pueden leerlos sin ejecutar JavaScript.

llms.txt para rastreadores de IA

El complemento 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 cambiarlo o establecer un Chatbot ID específico para el archivo, vaya a ChatReact → FAQ Widget → Cache & SEO Settings.

Caché de FAQs

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 inmediatamente

La caché también se purga automáticamente cada vez que sus FAQs cambian en el dashboard de ChatReact.

Idiomas compatibles

El complemento soporta 24 idiomas de la UE:

  • Búlgaro, Croata, Checo, Danés, Neerlandés, Inglés
  • Estonio, Finlandé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 están incluidas con el complemento. El idioma del widget se detecta automáticamente desde 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

El widget no aparece

  1. Verifique que su Chatbot ID sea correcto
  2. Compruebe si el chatbot está activo en su dashboard de ChatReact
  3. Limpie cualquier plugin de caché de páginas (ver más abajo)
  4. Revise la consola del navegador en busca de errores de JavaScript

Compatibilidad con plugins de caché

El complemento es totalmente compatible con plugins populares de caché y optimización como WP Rocket, LiteSpeed Cache, Autoptimize y WP Super Cache. El complemento previene automáticamente que estas herramientas minimicen 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é de su plugin de caché
  2. Excluya chatreact de la minificación/combinación de JS en la configuración de su plugin de caché
  3. El complemento 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 dashboard de ChatReact.

Conflictos de estilo

Si el widget se ve dañado:

  • El widget usa CSS aislado
  • Compruebe si hay reglas CSS !important en su tema
  • Intente desactivar temporalmente otros plugins de chat

Múltiples 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 complemento de WordPress de ChatReact incluye una función Smart Sitemap que proporciona al rastreador de ChatReact metadatos de contenido estructurado directamente desde su sitio WordPress.

Cómo funciona

  1. Genere una Integration Key en el dashboard de ChatReact (Knowledge Base → Websites → CMS Integrations)
  2. Pegue la key en la configuración del complemento 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. Cuando rastree su sitio web, 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 conoce 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 el meta box

Niveles de prioridad

PriorityDefault forDescription
HighPagesContenido principal del negocio (About, Services, Contact)
MediumPostsArtículos de blog, actualizaciones de noticias
LowContenido 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.

Excluir entradas individuales

En el editor de WordPress, cada entrada/página tiene un meta box 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.0

  • NEW: Traducciones incluidas para los 24 idiomas oficiales de la UE

1.1.3

  • FIX: Los widgets de FAQ de categoría única ya no muestran un botón de filtro "All" y insignias de categoría innecesarias

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: Punto de acceso llms.txt para descubrimiento por rastreadores de IA
  • NEW: Purga automática de la caché de FAQ cuando el contenido cambia en el dashboard de ChatReact

1.1.1

  • FIX: Mejoras en las 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 la configuración del complemento
  • NEW: Selección de tipos de contenido con niveles de prioridad
  • NEW: Exclusión por entrada del sitemap mediante meta box
  • NEW: Endpoint REST API protegido para el smart sitemap
  • FIX: Compatibilidad completa 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

  • Asignaciones de Widget — asigne chatbots a páginas directamente desde la configuración del complemento
  • Soporte de bloques Gutenberg
  • Integración con Elementor
  • Traducciones en 24 idiomas
  • Asignación de widget a nivel de página
  • CHANGED: La configuración del widget ahora se gestiona centralmente en el dashboard de ChatReact — se eliminaron los atributos de shortcode position, primary_color y auto_open (language sigue siendo compatible)

Próximos pasos