Torna alla Dashboard

Documentazione

Scopri come usare Asyntai

Come aggiungere il chatbot IA Asyntai a Drupal

Guida passo passo per i siti web Drupal

Ottieni il codice di incorporamento

Passaggio 1: ottieni il tuo codice di incorporamento

Per prima cosa, vai alla tua Dashboard Asyntai e scorri fino alla sezione "Codice di incorporamento". Copia il tuo codice di incorporamento univoco che apparirà così:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Nota: Il codice sopra è solo un esempio. Devi copiare il tuo codice di incorporamento univoco dalla tua Dashboard poiché contiene il tuo ID widget personale.

Step 2: Using Header and Footer Scripts Module (Recommended)

Il modo più semplice per aggiungere il chatbot è utilizzare il modulo "Header and Footer Scripts":

  1. Accedi al tuo pannello di amministrazione Drupal
  2. Vai su Extend e clicca su "Install new module"
  3. Cerca "Header and Footer Scripts" o scaricalo da Drupal.org
  4. Installa e abilita il modulo
  5. Vai su Configuration → Development → Header and Footer Scripts
  6. Clicca sulla scheda "Footer"
  7. Paste your Asyntai embed code in the footer scripts text area
  8. Fai clic su "Salva configurazione"

Suggerimento: Aggiungere il codice nella sezione footer garantisce che venga caricato dopo il contenuto della pagina, come consigliato per i widget di chat.

Alternativa: Modifica il template del tema

Puoi aggiungere il codice direttamente nel file template del tuo tema:

  1. Naviga nella cartella del tuo tema: themes/your_theme/
  2. Apri il file html.html.twig (o creane uno se non esiste)
  3. Trova il tag di chiusura </body>
  4. Incolla il codice di incorporamento Asyntai appena prima del tag </body>
  5. Salva il file
  6. Svuota la cache di Drupal: Configuration → Performance → Clear all caches

Importante: Le modifiche ai file del tema potrebbero essere sovrascritte durante l'aggiornamento del tema. Considera l'utilizzo di un tema figlio o del modulo Header and Footer Scripts per una soluzione più permanente.

Alternativa: Utilizzo delle librerie (per sviluppatori)

For developers who prefer using Drupal's asset library system:

  1. Crea o modifica il file *.libraries.yml del tuo tema
  2. Aggiungi una nuova voce di libreria:
    asyntai-chatbot:
    js:
    https://asyntai.com/static/js/chat-widget.js: { type: external, attributes: { async: true, data-asyntai-id: YOUR_WIDGET_ID } }
  3. Collega la libreria nel file *.info.yml del tuo tema:
    libraries:
    - your_theme/asyntai-chatbot
  4. Svuota la cache di Drupal

Passaggio 3: verifica l'installazione

Dopo aver salvato le modifiche e svuotato la cache, visita il tuo sito web in una nuova scheda del browser o in una finestra di navigazione in incognito. Dovresti vedere il pulsante del widget chat nell'angolo in basso a destra. Cliccaci sopra per assicurarti che si apra e funzioni correttamente.

Non vedi il widget? Assicurati di svuotare la cache di Drupal andando su Configuration → Performance → Clear all caches. Prova anche a svuotare la cache del browser o a visualizzare in una finestra di navigazione in incognito.