Vai al contenuto
intoCHAT

Integrazione Drupal

Aggiungi un chatbot AI al tuo sito Drupal

Addestra un agente con i contenuti e i documenti del tuo sito Drupal, poi caricalo su ogni pagina tramite una libreria del tema. Nessun modulo da installare, e puoi provare l'agente prima di pubblicarlo.

Crea il tuo agente gratis

Ultimo aggiornamento:

Come funziona intoCHAT su Drupal

Drupal carica JavaScript tramite le librerie di asset dichiarate dal tema. intoCHAT si adatta a questo modello: una libreria che punta a uno script esterno aggiunge una bolla della chat nell'angolo di ogni pagina generata dal tema. L'agente risponde in base a ciò che gli fornisci, come le pagine pubblicate, i PDF e le coppie di domande e risposte, e lo dice chiaramente quando non conosce la risposta. Colori, posizione e messaggio di benvenuto si gestiscono in intoCHAT, quindi la modifica al tema si fa una volta sola.

Installare intoCHAT su Drupal

  1. Crea e addestra l'agente

    Registrati su intoCHAT, crea un agente e inserisci l'indirizzo del tuo sito Drupal nella scheda Knowledge. intoCHAT trova le pagine tramite sitemap e link, e puoi escludere percorsi come /user con dei pattern.

  2. Copia l'ID dell'agente

    Apri la scheda Share e copia l'ID dell'agente dal codice sotto Bubble Chat. Per la libreria serve solo l'ID.

  3. Dichiara la libreria

    Nel tuo tema o sottotema, aggiungi una voce chat_widget a THEME.libraries.yml che carica lo script come file esterno con l'attributo data-chatbot-id, come mostrato sotto.

  4. Collegala a ogni pagina

    Aggiungi THEME/chat_widget all'elenco libraries in THEME.info.yml. Drupal carica il JavaScript delle librerie nel footer per impostazione predefinita, ed è proprio lì che lo script deve girare.

  5. Svuota le cache e controlla

    Svuota tutte le cache da Configuration > Development > Performance oppure con drush cr. Ricarica il sito: la bolla della chat compare nell'angolo in basso, con i colori e la posizione della scheda Appearance.

La definizione della libreria

# 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: aggiungi all'elenco libraries esistente
libraries:
  - THEME/chat_widget

Sostituisci THEME con il nome macchina del tuo tema. Non aggiungere header: true: lo script aggiunge la bolla della chat al body della pagina appena viene eseguito, quindi deve caricarsi nel footer. Drupal scrive data-chatbot-id nel tag script, ed è lì che lo script legge l'ID del tuo agente.

Cosa fa l'agente sul tuo sito Drupal

  • Impara dalle tue pagine Drupal

    Incolla l'indirizzo del sito e intoCHAT trova fino a 500 pagine tramite sitemap e link. Escludi percorsi con dei pattern, così le pagine di amministrazione, login o ricerca restano fuori.

  • Legge i file che pubblichi

    Carica i PDF, i file Word e i fogli di calcolo a cui rimanda il sito, oppure aggiungi testi e coppie di domande e risposte. Le risposte Q&A hanno la priorità sulle altre fonti.

  • Mette prima le fonti chiave

    Aggiungi una stella a una fonte, come la pagina FAQ o dei prezzi, perché abbia più peso nelle risposte. Non serve riaddestrare.

  • Chiama i tuoi endpoint

    Con le azioni API personalizzate l'agente chiama un endpoint HTTP durante la chat, ad esempio una route REST o JSON:API che esponi. Scegli tu l'autenticazione e quali campi della risposta vede il modello.

  • Raccoglie lead in chat

    Un breve modulo nella conversazione chiede email o numero di telefono, secondo le regole che imposti. Ogni nuovo lead arriva via email a te e a un massimo di cinque colleghi.

  • Risponde nella lingua del visitatore

    L'agente risponde nella lingua in cui scrive il visitatore, una scelta adatta ai siti Drupal multilingue.

Domande frequenti

Esiste un modulo intoCHAT per Drupal?

No. intoCHAT si carica tramite una libreria del tuo tema, che richiede poche righe di YAML e nessun modulo aggiuntivo. Usa un tema tuo o un sottotema, così gli aggiornamenti di un tema di terze parti non sovrascrivono la modifica.

Perché la libreria deve caricarsi nel footer?

Lo script aggiunge la bolla della chat al body della pagina appena viene eseguito, quindi il body deve già esistere. Drupal carica il JavaScript delle librerie nel footer per impostazione predefinita e solo header: true lo sposterebbe nell'head, quindi non usare questa impostazione.

intoCHAT rallenta il mio sito Drupal?

Lo script è un singolo file esterno che Drupal inserisce alla fine della pagina, dopo i tuoi contenuti. La finestra della chat gira in un proprio iframe servito da intoCHAT, quindi il suo codice resta separato dal JavaScript di Drupal.

Il mio sito invia una Content Security Policy. Cosa devo consentire?

Consenti www.intochat.ai per script-src, connect-src e frame-src. Lo script si carica da quell'host, da lì recupera le impostazioni dell'agente e apre la chat in un iframe servito dallo stesso host.

Perché la bolla della chat non compare dopo aver aggiunto la libreria?

Svuota prima tutte le cache, perché Drupal memorizza le definizioni delle librerie e le informazioni del tema. Poi controlla che la libreria sia elencata nel file info del tema frontend attivo e che l'ID dell'agente corrisponda a quello della scheda Share.

Devo modificare il tema quando cambio l'agente?

No. La libreria contiene solo l'ID dell'agente. Colori, posizione, messaggio di benvenuto, domande suggerite e conoscenze vengono caricati da intoCHAT a ogni apertura di pagina, quindi le modifiche compaiono senza un nuovo rilascio.

Guardalo rispondere dal tuo sito

Incolla l’indirizzo del tuo sito e chatta con un agente creato dalle tue pagine. Ci vuole circa un minuto.

Crea il tuo agente gratis

Piano gratuito, nessuna carta di credito.