Saltar al contenido
intoCHAT

Integración con Drupal

Añade un chatbot con IA a tu web de Drupal

Entrena un agente con el contenido y los documentos de tu web de Drupal y cárgalo en todas las páginas con una librería de tu tema. Sin módulos que instalar, y puedes probar el agente antes de publicarlo.

Crea tu agente gratis

Última actualización:

Cómo funciona intoCHAT en Drupal

Drupal carga JavaScript mediante librerías de assets que declara tu tema. intoCHAT encaja en ese modelo: una librería que apunta a un script externo añade una burbuja de chat en la esquina de cada página que genera el tema. El agente responde con lo que le das, como tus páginas publicadas, PDF y pares de preguntas y respuestas, y lo dice cuando no sabe algo. Los colores, la posición y el mensaje de bienvenida se gestionan en intoCHAT, así que el cambio en el tema se hace una sola vez.

Instalar intoCHAT en Drupal

  1. Crea y entrena tu agente

    Regístrate en intoCHAT, crea un agente y añade la dirección de tu web de Drupal en la pestaña Knowledge. intoCHAT encuentra tus páginas a través del sitemap y los enlaces, y puedes excluir rutas como /user con patrones.

  2. Copia el ID de tu agente

    Abre la pestaña Share y copia el ID del agente del código de Bubble Chat. La librería solo necesita el ID.

  3. Declara la librería

    En tu propio tema o subtema, añade una entrada chat_widget a THEME.libraries.yml que cargue el script como archivo externo con el atributo data-chatbot-id, como se muestra abajo.

  4. Añádela a todas las páginas

    Añade THEME/chat_widget a la lista libraries de THEME.info.yml. Drupal carga el JavaScript de las librerías en el footer por defecto, que es justo donde el script tiene que ejecutarse.

  5. Vacía las cachés y comprueba

    Vacía todas las cachés en Configuration > Development > Performance o con drush cr. Recarga tu web: la burbuja de chat aparece en la esquina inferior, con los colores y la posición de la pestaña Appearance.

La definición de la librería

# THEME.libraries.yml
chat_widget:
  js:
    https://www.intochat.ai/api/embed.js:
      type: external
      attributes:
        data-chatbot-id: 'YOUR_AGENT_ID'

# THEME.info.yml: añadir a la lista libraries existente
libraries:
  - THEME/chat_widget

Sustituye THEME por el nombre de máquina de tu tema. No añadas header: true: el script añade la burbuja de chat al body de la página en cuanto se ejecuta, así que tiene que cargarse en el footer. Drupal escribe data-chatbot-id en la etiqueta script, que es donde el script lee el ID de tu agente.

Qué hace el agente en tu web de Drupal

  • Aprende de tus páginas de Drupal

    Pega la dirección de tu web e intoCHAT encuentra hasta 500 páginas a través del sitemap y los enlaces. Excluye rutas con patrones para dejar fuera las páginas de administración, acceso o búsqueda.

  • Lee los archivos que publicas

    Sube los PDF, archivos de Word y hojas de cálculo que enlaza tu web, o añade textos y pares de preguntas y respuestas. Las respuestas de preguntas y respuestas tienen prioridad sobre otras fuentes.

  • Prioriza las fuentes clave

    Marca con una estrella una fuente, como tu página de preguntas frecuentes o de precios, para que pese más en las respuestas. Sin volver a entrenar.

  • Llama a tus endpoints

    Con las acciones de API personalizadas, el agente llama a un endpoint HTTP durante el chat, por ejemplo una ruta REST o JSON:API que expongas. Tú eliges la autenticación y qué campos de la respuesta ve el modelo.

  • Capta leads en el chat

    Un formulario breve dentro de la conversación pide un email o un teléfono, según las reglas que tú definas. Cada lead nuevo te llega por email a ti y hasta a cinco compañeros más.

  • Responde en el idioma del visitante

    El agente responde en el idioma en el que escribe el visitante, algo útil en webs de Drupal multilingües.

Preguntas frecuentes

¿Hay un módulo de intoCHAT para Drupal?

No. intoCHAT se carga con una librería de tu tema, que solo requiere unas líneas de YAML y ningún módulo contribuido. Usa tu propio tema o un subtema, para que las actualizaciones de un tema contribuido no sobrescriban el cambio.

¿Por qué la librería tiene que cargarse en el footer?

El script añade la burbuja de chat al body de la página en cuanto se ejecuta, así que el body ya tiene que existir. Drupal carga el JavaScript de las librerías en el footer por defecto y solo header: true lo movería al head, así que no uses ese ajuste.

¿intoCHAT ralentiza mi web de Drupal?

El script es un único archivo externo que Drupal coloca al final de la página, después de tu contenido. La ventana del chat funciona en su propio iframe servido por intoCHAT, así que su código queda separado del JavaScript de Drupal.

Mi web envía una Content Security Policy. ¿Qué tengo que permitir?

Permite www.intochat.ai en script-src, connect-src y frame-src. El script se carga desde ese host, obtiene de él los ajustes de tu agente y abre el chat en un iframe servido desde allí.

¿Por qué no aparece la burbuja de chat después de añadir la librería?

Vacía primero todas las cachés, porque Drupal guarda en caché las definiciones de librerías y la información del tema. Después comprueba que la librería aparece en el archivo info del tema frontend activo y que el ID del agente coincide con el de la pestaña Share.

¿Tengo que cambiar el tema cuando modifico el agente?

No. La librería solo lleva el ID de tu agente. Los colores, la posición, el mensaje de bienvenida, las preguntas sugeridas y el conocimiento se cargan desde intoCHAT cada vez que se abre una página, así que los cambios aparecen sin un nuevo despliegue.

Míralo responder con tu propia web

Pega la dirección de tu web y chatea con un agente creado a partir de tus páginas. Tarda alrededor de un minuto.

Crea tu agente gratis

Plan gratuito, sin tarjeta de crédito.