Torna alla Dashboard

Documentazione

Scopri come usare Asyntai

Come aggiungere il chatbot IA Asyntai ad Adobe Commerce (Magento)

Guida passo passo per i siti web Magento

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.

Passaggio 2: Utilizzo di Page Builder (consigliato)

Il modo più semplice per aggiungere il chatbot è utilizzare il blocco HTML Code di Page Builder:

  1. Accedi al tuo pannello di amministrazione Magento
  2. Vai su Content → Pages
  3. Modifica la tua Home page (o qualsiasi pagina dove desideri il chatbot)
  4. Nel Page Builder, trascina un elemento "HTML Code" sulla pagina
  5. Incolla il tuo codice di incorporamento Asyntai
  6. Clicca su "Save"
  7. Svuota la cache: System → Cache Management → Flush Magento Cache

Importante: L'utilizzo di Page Builder aggiunge il codice solo alle singole pagine. Per un'installazione su tutto il sito, utilizza il metodo Layout XML descritto di seguito.

Alternativa: Utilizzo di Layout XML (tutte le pagine)

To add the chatbot to all pages, create a layout file in your theme:

  1. Naviga nella cartella del tuo tema: app/design/frontend/[Vendor]/[theme]/
  2. Crea la struttura delle cartelle se non esiste: Magento_Theme/layout/
  3. Crea o modifica il file default_head_blocks.xml
  4. Aggiungi il seguente codice:
    <?xml version="1.0"?>
    <page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <head>
    <script src="https://asyntai.com/static/js/chat-widget.js" src_type="url" async="true" data-asyntai-id="YOUR_WIDGET_ID"/>
    </head>
    </page>
  5. Sostituisci YOUR_WIDGET_ID con il tuo ID widget effettivo
  6. Esegui: bin/magento cache:flush
  7. Esegui: bin/magento setup:static-content:deploy -f (se in modalità produzione)

Alternativa: Utilizzo di un blocco CMS

Puoi anche creare un blocco CMS e includerlo nel tuo footer:

  1. Vai su Content → Blocks
  2. Clicca su "Add New Block"
  3. Imposta un titolo come "Asyntai Chatbot"
  4. Imposta l'identificatore su asyntai_chatbot
  5. In the content editor, switch to HTML mode and paste your embed code
  6. Clicca su "Save Block"
  7. Aggiungi il blocco al tuo template footer utilizzando: {{block id="asyntai_chatbot"}}
  8. Svuota la cache

Passaggio 3: verifica l'installazione

Dopo aver salvato le modifiche e svuotato la cache, visita il tuo negozio 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 tutte le cache: System → Cache Management → Flush Magento Cache. Prova anche a svuotare la cache del browser o a visualizzare in una finestra di navigazione in incognito. Se sei in modalità produzione, esegui bin/magento setup:static-content:deploy -f.