Saltar al contenido principal

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.

¿Puedo usar ChattyBox en WordPress sin su marca?​

Sí. El plugin oficial carga el widget alojado de ChattyBox en tu sitio de WordPress. Free mantiene el pie de página «Powered by ChattyBox». Starter, Pro y Business permiten quitarlo en Personalizar → Apariencia → Marca de ChattyBox, desactivando Mostrar la marca de ChattyBox. Consulta la personalización del widget para encontrar el ajuste y los precios para comparar los planes.

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 Probar chatbot. En Instalar → Claves y dominios, revisa las restricciones de origen de tu clave pública del widget o crea una. Una clave preparada para un sitio puede estar ya restringida al origen de ese sitio. En Instalar → Instalación en el sitio web, selecciona una clave adecuada y cópiala del fragmento de instalación.

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+ y PHP 7.4+, y los metadatos indican pruebas hasta WordPress 6.8. Prueba tus versiones reales de WordPress y PHP, además de tu tema; estos metadatos no garantizan la compatibilidad con todas las versiones posteriores.

  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 el fragmento de instalación.
  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
  • Anulación de idioma: vacía; el widget alojado sigue la política de idioma del proyecto (modo Auto de forma predeterminada)

En el código fuente actual del widget alojado, el modo Auto prueba primero un idioma admitido del atributo <html lang> de la página, después los idiomas admitidos del navegador, el idioma predeterminado configurado y el inglés. El modo Fixed usa el idioma predeterminado del proyecto. La anulación de idioma opcional del plugin se convierte en data-locale y solo prevalece si el proyecto permite que el script sobrescriba el idioma. Usa un código de idioma admitido en minúsculas; los textos personalizados del encabezado y de bienvenida no se traducen automáticamente. Si dependes de este comportamiento, comprueba la versión del cargador, que se despliega por separado.

El endpoint de API está integrado en esta versión del plugin y no se obtiene de la clave. Cambiar Widget script URL no cambia ese endpoint. Si el fragmento de instalación del sitio apunta a otro despliegue de API, usa en su lugar la integración manual del script. Las URL remotas del cargador deben usar HTTPS (HTTP solo se permite para hosts locales de desarrollo).

El plugin registra el widget en las solicitudes de puesta en cola del frontend de WordPress y omite explícitamente los feeds y las solicitudes REST y AJAX. Estas comprobaciones no inspeccionan todos los tipos de respuesta ni determinan si cada página del frontend es pública o privada: excluye explícitamente las páginas de pago, cuenta, protegidas con contraseña o para miembros cuando corresponda. Confirma también que el tema imprima los scripts del pie de página de WordPress. El plugin no rastrea ni sincroniza entradas; la indexación y las actualizaciones se gestionan en ChattyBox.

Las claves creadas sin restricciones funcionan desde todos los orígenes del navegador; una clave preparada para un sitio puede estar ya restringida al origen de ese sitio. Si activas las restricciones opcionales en Instalar → Claves y dominios, incluye el esquema, el host y el puerto de cada origen previsto. Para las claves restringidas, un origen efectivo de la solicitud ausente o no permitido devuelve HTTP 401 Invalid API key; si falta la cabecera Origin, el servidor puede obtener el origen de un Referer válido. Las restricciones de origen son una protección adicional, no un mecanismo de autenticación de visitantes. Prueba la página de producción, no solo el dashboard.

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.

Este filtro decide si el script se carga para la solicitud de WordPress actual; no elimina un widget ya inicializado durante la navegación del lado del cliente en una SPA.

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 que una respuesta respaldada cite páginas públicas de WordPress indexadas y que una pregunta sin respaldo muestre la respuesta de fallback, que puede no incluir fuentes.
  • Comprueba la consola del navegador en busca de data-api-key, data-api-url ausentes o errores de clave.
  • Prueba una ruta de pago, cuenta o privada si configuraste una exclusión.
  • Después de cambiar los ajustes o las exclusiones, purga las cachés pertinentes de WordPress/CDN y prueba una carga de página nueva.
  • Las exclusiones del servidor no eliminan un widget ya inicializado durante la navegación del lado del cliente en una SPA. En rutas sensibles o al retirar el consentimiento, desmonta activamente el widget mediante una integración compatible con la versión del cargador desplegada. Eliminar la etiqueta script u ocultar el widget con CSS no constituye un desmontaje completo. El desmontaje no puede deshacer una solicitud que el servidor ya haya procesado.
  • El cargador automático del plugin no comprueba el consentimiento del visitante antes de poner el widget en cola. Si se requiere consentimiento, usa una integración que impida la carga hasta que se otorgue y verifica el comportamiento al revocarlo con el cargador desplegado.

Continúa con la lista de comprobación del lanzamiento antes de anunciar el chatbot. Usa Conversaciones → Historial, disponible en todos los planes, para revisar las conversaciones. En los planes Pro o Business, usa Conversaciones → Analítica y Conversaciones → Preguntas sin responder para revisar áreas de mejora después de recibir preguntas reales.