Documentación

WordPress

Agrega tu agente a sitios web de WordPress.

Agrega tu agente de IA a sitios de WordPress mediante el código de incrustación. Funciona con cualquier tema de WordPress.

Primero, obtén el código de incrustación desde Chatbot > Publicar en el panel.

Método 1: pie de página del tema (recomendado)

Agrega el widget a todas las páginas mediante tu tema:

  1. Ve a Apariencia → Editor de temas (o Editor de archivos del tema)
  2. Busca footer.php en los archivos de tu tema
  3. Pega tu código de incrustación justo antes de </body>

Formato de ejemplo (obtén tu código real desde Chatbot > Publicar):

<script
  src="YOUR_WIDGET_URL"
  data-chatbot="YOUR_CHATBOT_ID"
  async
></script>
  1. Haz clic en Actualizar archivo

El widget ahora aparece en todas las páginas.

Método 2: bloque de HTML personalizado

Agrégalo a páginas específicas mediante el editor de bloques:

  1. Edita la página donde quieras el widget
  2. Agrega un bloque HTML personalizado
  3. Pega tu código de incrustación desde Chatbot > Publicar

Formato de ejemplo:

<script
  src="YOUR_WIDGET_URL"
  data-chatbot="YOUR_CHATBOT_ID"
  async
></script>
  1. Guarda la página

Método 3: plugin (scripts de encabezado/pie de página)

Usa un plugin para agregar scripts en todo el sitio:

  1. Instala un plugin como "Insert Headers and Footers" o "WPCode"
  2. Ve a la configuración del plugin
  3. Busca la sección "Footer Scripts"
  4. Pega tu código de incrustación desde Chatbot > Publicar
  5. Guarda los cambios

Este método no requiere editar archivos del tema.

Método 4: tema hijo

Para temas que se actualizan con frecuencia, usa un tema hijo:

  1. Crea un tema hijo para tu tema actual
  2. Agrega un archivo functions.php con lo siguiente (reemplaza YOUR_WIDGET_URL y YOUR_CHATBOT_ID por los valores de Chatbot > Publicar):
<?php
function add_chatbot_widget() {
    ?>
    <script
      src="YOUR_WIDGET_URL"
      data-chatbot="YOUR_CHATBOT_ID"
      async
    ></script>
    <?php
}
add_action('wp_footer', 'add_chatbot_widget');

Esto sobrevive a las actualizaciones del tema.

Sitios de WooCommerce

El widget funciona automáticamente en los sitios de WooCommerce. Ten en cuenta:

  • Agregarlo a las páginas de producto para preguntas sobre productos
  • Agregarlo al checkout para dar soporte de pedidos
  • Usarlo en páginas específicas mediante bloques de HTML personalizado

Constructores de páginas

Elementor

  1. Edita con Elementor
  2. Agrega un widget HTML
  3. Pega el código de incrustación
  4. Configúralo para mostrarse en todo el sitio (opcional)

Divi

  1. Agrega un Code Module
  2. Pega el código de incrustación
  3. Guarda los cambios

Beaver Builder

  1. Agrega un módulo HTML
  2. Pega el código de incrustación
  3. Publica los cambios

Multisite

Para WordPress Multisite:

  • Agrega el código a cada sitio individualmente, o
  • Usa un plugin activado a nivel de red para agregarlo a todos los sitios

Plugins de caché

Si usas plugins de caché (WP Super Cache, W3 Total Cache, etc.):

  1. Agrega el código del widget
  2. Borra todas las cachés
  3. Prueba el widget

El widget debería funcionar con todos los plugins de caché principales.

Solución de problemas

El widget no aparece

  • Borra la caché de WordPress
  • Revisa la consola del navegador en busca de errores
  • Verifica que el ID del agente sea correcto

El editor de temas no está disponible

  • Algunos hosts desactivan la edición de temas
  • Usa un método con plugin en su lugar
  • O edita los archivos mediante FTP

La posición del widget es incorrecta

  • Ajusta la posición en la configuración de Diseño de tu agente
  • Revisa si hay conflictos de CSS con el tema

Pruebas

Después de la instalación:

  1. Abre tu sitio de WordPress en una ventana de incógnito
  2. Busca la burbuja de chat
  3. Envía un mensaje de prueba
  4. Verifica la respuesta

Próximos pasos