---
title: Cómo instalar el agente en WordPress y WooCommerce
description: 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.
section: platforms
keywords: WordPress, WooCommerce, instalar agente WordPress, widget WordPress, chat para tienda online, chat IA para web, footer.php WordPress, plugin insertar código WordPress, agente de ventas IA, conectar chat carrito WooCommerce, integrar IA WooCommerce, cómo instalar agente AI WordPress
updated: 2026-09-06
---
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.

1.  Instale cualquier plugin para insertar scripts: WPCode, Insert Headers and Footers, Code Snippets.
2.  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)**.
3.  Pegue la línea de código de su panel de control y guarde.

## Método 2: Archivo del tema

1.  **Apariencia → Editor de archivos del tema**.
2.  Abra `footer.php`.
3.  Pegue el código antes de `</body>`.
4.  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:

```php
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:

1.  Borre la caché del plugin: WP Rocket, W3 Total Cache, LiteSpeed o el que tenga instalado.
2.  Borre la caché de la CDN, si usa Cloudflare.
3.  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.