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.

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

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/.

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 della lingua per seguire la lingua della pagina o del browser, oppure inserisci un codice di due lettere come en, fr o de.
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.

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.