Módulo de chatbot de Drupal

Usa el módulo oficial de Drupal de ChattyBox cuando quieras una instalación gestionada por Composer para un sitio Drupal 10 o Drupal 11. Carga el widget alojado en rutas HTML públicas y mantiene configurado automáticamente el endpoint de producción. Esta guía cubre la configuración operativa. La página del módulo de chatbot de IA para Drupal resume el producto y el flujo de evaluación.

Antes de instalar

Completa primero el flujo de Primeros pasos: conecta tu URL pública de Drupal, 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.

Instalación con Composer

El módulo se distribuye actualmente como un paquete etiquetado en el repositorio público de GitHub. Todavía no aparece listado en Drupal.org ni Packagist, por lo que Composer necesita la declaración del repositorio VCS que se muestra a continuación antes de que composer require pueda resolverlo.

Añade el repositorio público de GitHub al composer.json raíz del proyecto Drupal que lo consuma:

{
  "repositories": {
    "chattybox-drupal": {
      "type": "vcs",
      "url": "https://github.com/OpenStaticFish/chattybox-drupal.git"
    }
  }
}

Si el proyecto ya tiene una sección repositories, combina con ella la entrada chattybox-drupal. Después, instala el módulo etiquetado:

composer require openstaticfish/chattybox-drupal:^0.1

El paquete está declarado como drupal-module y requiere Drupal ^10 || ^11. Las rutas estándar del instalador Composer de Drupal lo colocan en web/modules/contrib/.

Revisa el código fuente público del módulo de Drupal y los cambios etiquetados antes de actualizar. Las actualizaciones de Drupal.org gestionadas por el directorio todavía no están disponibles.

Para probar en su lugar la rama de desarrollo actual:

composer require openstaticfish/chattybox-drupal:dev-main

Activar y configurar

1. Activa ChattyBox desde Extend o ejecuta drush en chattybox.
2. Abre Configuration > Web services > ChattyBox.
3. Pega solo la clave API pública del widget desde la pestaña Embed del proyecto.
4. Deja la URL del script del widget alojado, a menos que ChattyBox te haya proporcionado una URL de loader de vista previa o autoalojada.
5. Deja vacío el override para seguir la política del proyecto o usa un código admitido en minúsculas. En auto gana el idioma de página; fixed usa el predeterminado y el override solo funciona si está permitido.
6. Activa el chatbot y guarda la configuración.

El módulo no se carga en rutas administrativas ni en respuestas que no sean HTML. Añade la clave pública, el endpoint de producción gestionado, el idioma opcional y el loader del widget mediante la biblioteca declarada de Drupal y drupalSettings.

Una instalación nueva empieza desactivada. El endpoint está integrado: cambiar la URL del loader no lo cambia. Las claves funcionan en orígenes por defecto; si activa una restricción opcional, enumere esquema, host y puerto exactos. Las rutas administrativas no son un control de privacidad para todo frontend: excluya cuenta o checkout según proceda.

Excluir rutas adicionales

El módulo omite automáticamente las rutas administrativas. Un módulo personalizado puede desactivar el widget en otras rutas públicas con hook_chattybox_load_widget_alter():

/**
 * Implements hook_chattybox_load_widget_alter().
 */
function mymodule_chattybox_load_widget_alter(&$should_load, $config, $route_match) {
  if ('commerce_checkout.form' === $route_match->getRouteName()) {
    $should_load = FALSE;
  }
}

Alternativa manual

Composer es la ruta de instalación recomendada. Si tu despliegue de Drupal no puede usar Composer, copia el módulo en web/modules/custom/chattybox o en otro directorio de módulos personalizados, actívalo y configúralo desde Configuration > Web services > ChattyBox.

No pegues credenciales de administración en el módulo. La clave API pública del widget está pensada para el marcado del frontend.

Elija un solo loader: no combine módulo, snippet, GTM o SDK. Reutilizar un script marcado no actualiza su configuración.

Verificación

Después de configurar el módulo:

• Abre una página pública de Drupal en una ventana de incógnito.
• Confirma que el lanzador del widget aparece una sola vez.
• Haz una pregunta real de visitante.
• Verifica una respuesta compatible con citas y otra no compatible con fallback, que puede no incluir fuentes.
• Prueba rutas incluidas y excluidas con cachés frías y calientes; una exclusión de servidor no desmonta un widget ya cargado tras navegación SPA.
• Comprueba la consola del navegador en busca de data-api-key, data-api-url ausentes o errores de clave.

Continúa con la lista de comprobación de lanzamiento antes de anunciar el chatbot.