Modulo chatbot Drupal

Usa il modulo Drupal ufficiale di ChattyBox quando vuoi un'installazione gestita da Composer per un sito Drupal 10 o Drupal 11. Carica il widget ospitato sulle route HTML pubbliche e mantiene configurato automaticamente l'endpoint API di produzione. Questa guida illustra la configurazione operativa. La pagina del modulo chatbot AI per Drupal riassume il prodotto e il flusso di valutazione.

Prima dell'installazione

Completa prima il flusso Per iniziare: collega il tuo URL Drupal pubblico, esamina le pagine indicizzate e verifica risposte rappresentative in Test Chat. Poi crea una chiave pubblica sicura per il browser in Public Keys e copiala dalla scheda Embed del progetto.

Installazione con Composer

Il modulo è attualmente distribuito come pacchetto con tag nel repository GitHub pubblico. Non è ancora elencato su Drupal.org o Packagist, quindi Composer ha bisogno della dichiarazione del repository VCS riportata di seguito prima che composer require possa risolverlo.

Aggiungi il repository GitHub pubblico al composer.json principale del progetto Drupal che lo utilizza:

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

Se il progetto ha già una sezione repositories, unisci a essa la voce chattybox-drupal. Poi installa il modulo contrassegnato:

composer require openstaticfish/chattybox-drupal:^0.1

Il pacchetto è dichiarato come drupal-module e richiede Drupal ^10 || ^11. I percorsi standard dell'installer Drupal Composer lo collocano in web/modules/contrib/.

Prima di eseguire un aggiornamento, consulta il codice sorgente pubblico del modulo Drupal e le modifiche contrassegnate dai tag. Gli aggiornamenti gestiti da Drupal.org non sono ancora disponibili.

Per provare invece l'attuale branch di sviluppo:

composer require openstaticfish/chattybox-drupal:dev-main

Abilitazione e configurazione

1. Abilita ChattyBox da Extend oppure esegui drush en chattybox.
2. Apri Configuration > Web services > ChattyBox.
3. Incolla solo la chiave API pubblica del widget dalla scheda Embed del progetto.
4. Lascia l'URL dello script del widget ospitato, a meno che ChattyBox non ti abbia fornito un URL del loader di anteprima o self-hosted.
5. Lascia vuoto l’override per seguire la policy del progetto o usa un codice supportato minuscolo. In auto vince la lingua pagina; fixed usa il default e l’override richiede autorizzazione.
6. Abilita il chatbot e salva la configurazione.

Il modulo non viene caricato sulle route amministrative o nelle risposte non HTML. Aggiunge la chiave pubblica, l'endpoint di produzione gestito, la lingua opzionale e il loader del widget tramite la libreria dichiarata di Drupal e drupalSettings.

L’endpoint è integrato: cambiare URL loader non lo cambia. Le route amministrative non sono un controllo di privacy per tutto il frontend; escludi account/checkout quando serve e usa un solo loader (non modulo più snippet/GTM/SDK).

Esclusione di altre route

Il modulo salta automaticamente le route amministrative. Un modulo personalizzato può disabilitare il widget su altre route pubbliche 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 manuale

Composer è il percorso di installazione consigliato. Se il tuo deployment Drupal non può usare Composer, copia il modulo in web/modules/custom/chattybox o in un'altra directory per moduli personalizzati, abilitalo e configuralo da Configuration > Web services > ChattyBox.

Non inserire credenziali di gestione nel modulo. La chiave API pubblica del widget è destinata al markup frontend.

Verifica

Dopo aver configurato il modulo:

• Apri una pagina Drupal pubblica in una finestra in incognito.
• Verifica che il launcher del widget compaia una sola volta.
• Poni una domanda reale di un visitatore.
• Verifica che la risposta includa citazioni delle fonti verso pagine Drupal pubbliche.
• Controlla la console del browser per data-api-key, data-api-url mancanti o errori della chiave.

Continua con la checklist di lancio prima di annunciare il chatbot.