Plugin de chatbot para WordPress

Usa el plugin oficial de WordPress de ChattyBox cuando quieras una instalación sin código que cargue el widget alojado sin editar los archivos del tema. Esta guía cubre la configuración operativa. La página del chatbot de IA para WordPress explica la estrategia de contenido y rastreo, mientras que la página de presentación del plugin de WordPress ofrece una visión general del producto.

Antes de instalar

Completa primero el flujo de Primeros pasos: conecta tu URL pública de WordPress, revisa las páginas indexadas y verifica respuestas representativas en Test Chat. Después, crea una clave pública segura para el navegador en Public Keys y cópiala desde la pestaña Embed del proyecto.

Instalar el plugin

El plugin no depende de Composer, npm ni de un paso de compilación. Actualmente se distribuye desde el repositorio público de ChattyBox en GitHub, no desde el directorio de plugins de WordPress.org, así que usa el flujo Upload Plugin de WordPress en lugar de buscarlo en el directorio. Las actualizaciones automáticas gestionadas por el directorio todavía no están disponibles.

El paquete fijado 0.2.0 declara WordPress 5.8+, PHP 7.4+ y pruebas hasta WordPress 6.8; pruebe su versión y tema reales.

1. Descarga el ZIP fijado del plugin de WordPress de ChattyBox 0.2.0 o consulta el repositorio público.
2. En WordPress, abre Plugins > Add New > Upload Plugin, sube el ZIP y activa ChattyBox AI Chatbot. Para una instalación manual en el servidor, copia primero el directorio del plugin en wp-content/plugins/.
3. Abre Settings > ChattyBox.
4. Pega la clave API pública del widget desde la pestaña Embed del proyecto.
5. Activa el chatbot y guarda la configuración.

El plugin almacena la clave pública del widget y la configuración de visualización en las opciones de WordPress. No pegues nunca una credencial de gestión de ChattyBox en el plugin.

Configurar la carga

Los valores predeterminados de producción son:

• Script del widget: https://chattybox.ai/widget.js
• Endpoint de API: configurado automáticamente por el plugin
• Activo: no, hasta habilitarlo con una clave pública no vacía
• Override de idioma: vacío; sigue la política del proyecto

El plugin carga el widget en las solicitudes del frontend público. Omite intencionadamente wp-admin, feeds y solicitudes REST y AJAX, de modo que las respuestas administrativas y las que no corresponden a páginas no reciben el script.

En auto, el idioma de página gana al navegador; fixed usa el predeterminado y el override del plugin requiere permiso. El endpoint está integrado: cambiar la URL del script no lo cambia. Las guardas de solicitudes no clasifican todas las páginas privadas; excluya explícitamente checkout, cuenta, contraseña o membresía.

Excluir rutas adicionales

Usa el filtro chattybox_load_widget desde un plugin específico del sitio o un tema hijo cuando una ruta pública no deba mostrar el widget:

add_filter(
    'chattybox_load_widget',
    static function ( $should_load ) {
        return $should_load && ! is_page( array( 'checkout', 'account' ) );
    }
);

Mantén primero activado el comportamiento predeterminado del plugin y añade después solo las exclusiones de rutas que necesite tu sitio. Después de cambiar el filtro, prueba tanto una ruta excluida como una página pública normal.

Alternativa de script manual

Usa el plugin como opción predeterminada. Si tu equipo de WordPress ya gestiona los scripts mediante un tema, un tema hijo, un plugin de scripts o Google Tag Manager, puedes cargar manualmente el widget alojado:

<script
  src="https://chattybox.ai/widget.js"
  data-api-key="YOUR_API_KEY"
  data-api-url="YOUR_WIDGET_API_URL"
  async
></script>

No actives el plugin y añadas el mismo fragmento del widget al mismo tiempo. Elige un solo cargador para que los visitantes no reciban lanzadores duplicados.

Verificar la instalación

Después de configurar el plugin:

• Abre una página pública de WordPress en una ventana de incógnito.
• Confirma que el lanzador aparece una sola vez.
• Haz una pregunta real de visitante.
• Verifica una respuesta compatible con citas y una no compatible con fallback, que puede no tener fuentes.
• Comprueba la consola del navegador en busca de data-api-key, data-api-url ausentes o errores de clave.
• Prueba una ruta checkout, account o privada si configuraste una exclusión.
• Purgue caché de WordPress/CDN tras cambios. Quitar el script u ocultar con CSS no es teardown ni revocación de consentimiento.

Continúa con la lista de comprobación del lanzamiento antes de anunciar el chatbot. Usa Analytics y Content Gaps para mejorar el contenido de WordPress después de recibir preguntas reales.