Tutorial: integra un assistente in un sito web
Porta online un assistente su qualsiasi pagina HTML. Due prerequisiti, uno snippet, fatto.
Passaggi
- Aggiungi il dominio del sito alle origini consentite dell’assistente: finché non lo fai, l’assistente si rifiuta di caricarsi lì.
- Genera una chiave API se la modalità di sicurezza è API (un assistente in modalità None non ne ha bisogno).
- Incolla questo snippet nella tua pagina, sostituendo i tuoi valori:
<div id="seekdown-assistant-root"></div>
<script src="https://saas.seekdown.ai/js/seekdown-assistant.js"></script>
<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>
Lo snippet ha tre parti: lo script di runtime, il contenitore e la chiamata di inizializzazione:
- Pubblica la pagina e aprila: l’assistente dovrebbe comparire e rispondere.
Risoluzione dei problemi
- Se il widget non compare, controlla l’URL dello script, il contenitore, l’ID dell’assistente e la console del browser.
- Se l’accesso è bloccato, verifica che il dominio della pagina sia tra le origini consentite.