Aggiungi il tuo assistente al tuo sito web

Quando funziona nella sandbox, andare online è in gran parte un copia-incolla. La modalità di visualizzazione scelta nella procedura guidata è esattamente l’aspetto che avrà sulla tua pagina: non ricostruisci nulla, lo posizioni e basta.

Prima di iniziare

• Origini consentite: aggiungi l’indirizzo del tuo sito all’elenco delle origini consentite dell’assistente, così la tua pagina è autorizzata a caricarlo. Finché non lo fai, l’assistente si rifiuta di avviarsi su quel dominio.
• Chiave di accesso: se la modalità di sicurezza è API, copia la chiave dalla scheda Keys dell’assistente. Un assistente in modalità None (pubblico) non ha bisogno di chiave.
• ID dell’assistente: lo incollerai nello snippet. Si trova nella pagina dell’assistente.

Inserisci lo snippet

Aggiungi tre elementi alla tua pagina: lo script runtime di Seekdown, un elemento contenitore e un breve snippet di inizializzazione. Questa è esattamente la forma che genera il prodotto: sostituisci il tuo assistantId (e accessToken se il tuo assistente ne ha bisogno):

<div id="seekdown-assistant-root"></div>

<!-- Include the public Seekdown runtime -->
<script src="https://saas.seekdown.ai/js/seekdown-assistant.js"></script>

<!-- Initialize the assistant with your assistantId and accessToken -->
<script>
  document.addEventListener('DOMContentLoaded', function () {
    if (window.skdwn?.startAssistant) {
      let seekdownAssistantOptions = {
        assistantId: 'your-assistant-id',
        accessToken: 'your-api-key-or-identity-access-token',
      };

      skdwn.startAssistant(seekdownAssistantOptions);
    } else {
      console.error('skdwn.startAssistant is not available.');
    }
  });
</script>

Usi una piattaforma invece di HTML puro?

Non sempre devi toccare il codice. Esiste una guida breve e dedicata per ciascuna delle piattaforme più comuni:

• WordPress: installa il plugin ufficiale di Seekdown, incolla l’ID del tuo assistente e mostralo su tutto il sito o con lo shortcode [seekdown]. Vedi Integrare un assistente in WordPress.
• Shopify: aggiungi gli stessi tre snippet al file theme.liquid del tuo tema, subito prima di </body>. Vedi Integrare un assistente in Shopify.
• ChatGPT (Custom GPT): collega il tuo assistente come Action, così un Custom GPT può rispondere a partire dai tuoi contenuti. Vedi Creare una Action per un Custom GPT.

Verifica che sia online

Apri la pagina (fuori da qualsiasi area di amministrazione) e controlla che l’assistente compaia e risponda. Se non succede, i soliti colpevoli sono un’origine consentita mancante, un ID dell’assistente errato o un token che l’assistente si aspettava ma non ha ricevuto: la console del browser di solito ti dice quale.

Documenti correlati

• Integrare un assistente in un sito web
• Configurare le origini consentite
• Risolvere i problemi di un assistente integrato