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.
- Descarga el ZIP del plugin de WordPress de ChattyBox o clona el repositorio público.
- 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/. - Abre Settings > ChattyBox.
- Pega la clave API pública del widget desde la pestaña Embed del proyecto.
- 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
- Idioma: detectado a partir del idioma de la página y del navegador del visitante
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.
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 que la respuesta incluye citas de fuentes que enlazan a páginas públicas de WordPress.
- Comprueba la consola del navegador en busca de
data-api-key,data-api-urlausentes o errores de clave. - Prueba una ruta checkout, account o privada si configuraste una exclusión.
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.