Salta ai contenuti

SDK dell'assistente sullo schermo

Installare l'SDK e inizializzarlo

Aggiungi lo script dell’SDK subito sotto lo snippet del tuo widget (manuale 06), e chiama initCopilot con il tuo manifesto:

<script src="https://widget.example.com/v1/copilot-sdk.js"></script>
<script>
window.Copilot.initCopilot({
manifest: ilMioManifesto, // il tuo oggetto v1, vedi paragrafo 5
allowedWidgetOrigins: ["https://widget.example.com"], // obbligatorio
confirmOnFill: false, // opzionale: chiede conferma anche al riempimento
locale: "it", // opzionale: "es" | "en" | "it"
theme: "light", // opzionale: "light" | "dark"
});
</script>

Nota — Il nome e il dominio di questo esempio sono illustrativi

Lo script reale che il tuo fornitore serve, e il nome globale che espone, non si personalizzano per marca bianca in questa versione del prodotto — copialo esattamente come appare nella tua sezione «Copilota» (manuale 58, paragrafo 2), non scriverlo a mano da questo esempio.

allowedWidgetOrigins è obbligatorio: senza di esso, l’SDK non parte nemmeno (lancia un errore). È l’elenco delle origini da cui il tuo widget può inviare piani all’SDK — qualsiasi messaggio da un’altra origine viene scartato in silenzio (con un avviso in console).

Avviso — Prova prima di pubblicare

L’SDK arriva con un sito di prova di fabbrica: un modulo reale con un manifesto di esempio e un widget simulato che invia piani con lo stesso identico contratto che userebbe il tuo widget reale. Chiedi al tuo fornitore il link a quel sito di prova — serve a provare le tue ancore e il tuo manifesto senza toccare la produzione, prima di registrare qualsiasi cosa.