Cómo instalar el agente en WordPress y WooCommerce
Tres maneras de insertar el código en WordPress, cómo el agente lee el catálogo de WooCommerce, qué hacer con los plugins de caché y cómo vincular el chat con el carrito de compra.
En WordPress, el código se inserta de tres maneras. La elección depende de su comodidad editando los archivos de su tema.
Método 1: Plugin de inserción de código (recomendado)#
La opción más segura: los cambios no se perderán al actualizar el tema.
- Instale cualquier plugin para insertar scripts: WPCode, Insert Headers and Footers, Code Snippets.
- Abra la configuración del plugin y busque el campo para el código en el pie de página; normalmente se llama Footer o Body (before closing tag).
- Pegue la línea de código de su panel de control y guarde.
Método 2: Archivo del tema#
- Apariencia → Editor de archivos del tema.
- Abra
footer.php. - Pegue el código antes de
</body>. - Actualice el archivo.
Importante: edite el tema hijo. Al actualizar el tema padre, el archivo se sobrescribirá junto con su código.
Método 3: A través de functions.php#
Para quienes prefieren el código. En el functions.php del tema hijo:
add_action('wp_footer', function () {
echo '<script src="https://comag.vibevox.pro/widget.js" data-slug="tu-slug" async></script>';
});Obtenga la línea de script exacta en su panel de control, con el botón «Copiar código».
Catálogo de WooCommerce#
Indique la dirección del sitio web en la configuración y ejecute el análisis. El rastreador lee los productos de WooCommerce a través de los datos estructurados de las páginas: nombre, precio, disponibilidad, descripción, fotografías, categorías.
Qué debe saber:
- Productos variables aparecen en la ficha con un rango de precios y características.
- Ocultos y borradores no se leen, y así debe ser.
- Productos solo para usuarios autorizados el agente no los verá: navega por el sitio como un visitante normal.
- Si tiene una exportación de productos en CSV, puede subirla en la sección «Catálogo»; a veces es más rápido y preciso que el rastreo.
Carrito y pago#
En WooCommerce, el pago en el chat no suele incluirse: la tienda ya tiene su propia caja con envío, impuestos y cupones.
Indique en la configuración el enlace al carrito, que suele ser https://su-dominio/cart o /carrito. El agente guiará al comprador hasta allí.
Para ver qué diálogos se convierten en pedidos, añada el fragmento del píxel de compra a la página «Gracias por su pedido». En WooCommerce, esto es la plantilla checkout/thankyou.php o el mismo plugin de inserción de código con una condición para la página de pedido.
El botón del chat añade el producto al carrito de WooCommerce#
Las fichas de productos en las respuestas del agente no son solo imágenes bonitas. Cada una tiene un enlace a la página del producto en su tienda, y el agente sabe cómo usar el mecanismo estándar de WooCommerce para añadir al carrito: una dirección del tipo ?add-to-cart=123.
El comprador pulsa el botón en el chat, el producto se añade al carrito, y su caja funciona con todos los plugins de envío, cupones e impuestos. No se necesitan integraciones ni claves para esto: el mecanismo está integrado en WooCommerce de serie.
Si el enlace lleva a una página de producto variable, el agente la abre; el comprador debe elegir la talla y el color por sí mismo, y esto es correcto: sustituir la opción por él es arriesgado.
Otra cosa que debe saber: el agente ve la página donde se abre el chat. Lee el marcado del producto —nombre, SKU, precio— y responde en contexto. Si un visitante está en la ficha de un producto y escribe «¿hay algo más barato?», el agente entiende con qué comparar y ofrece una alternativa de su catálogo, no un consejo abstracto.
La razón principal por la que «el widget no apareció» en WordPress es la caché. Después de insertar el código:
- Borre la caché del plugin: WP Rocket, W3 Total Cache, LiteSpeed o el que tenga instalado.
- Borre la caché de la CDN, si usa Cloudflare.
- Compruebe el sitio en modo incógnito.
Si en el plugin está activada la «combinación y carga diferida de scripts», añada nuestro script a las exclusiones: la fusión de scripts de terceros a veces interrumpe la carga.
Tema claro y oscuro#
El widget soporta ambos. En la configuración se elige el tema claro, oscuro o «como el del visitante»; este último sigue la configuración del sistema del dispositivo y es el predeterminado.
Esto es útil si su tema de WordPress tiene un selector de día y noche: deje «como el del visitante», y el chat coincidirá con lo que la persona ya haya elegido.
Plugins de caché#
Verificación#
- El botón de chat aparece en la esquina inferior derecha de cualquier página del sitio.
- Una pregunta sobre un producto muestra una ficha con el precio.
- El botón de compra lleva al carrito de WooCommerce.
- En móvil, el botón no superpone el menú ni el carrito.
Preguntas frecuentes#
¿Se necesita un plugin aparte de Commerce Agents?#
No. Basta con una línea de código; no se requiere ni se instala un plugin aparte.
El widget no apareció, ¿qué debo verificar primero?#
La caché: el plugin de caché y la CDN. Luego, que el código esté insertado en el pie de página y no en un widget arbitrario de la barra lateral, y que el tema realmente muestre wp_footer().
¿El agente sabrá sobre descuentos y cupones?#
Sobre los cupones, no: se aplican en el carrito de WooCommerce. El agente muestra los precios que había durante el rastreo, incluyendo el precio con descuento si se muestra en la página del producto.
¿Ralentizará esto el sitio web?#
El script es asíncrono, pesa poco y no bloquea la renderización de la página. El impacto en PageSpeed es mínimo.
¿Se puede mostrar el widget solo en la tienda y no en el blog?#
Sí, si se inserta el código a través de un plugin con condiciones de visualización o en functions.php con la comprobación is_woocommerce(). En el caso más simple, el agente en todas las páginas no molesta: también responde a preguntas sobre el envío desde el blog.