Ir al contenido

SDK del asistente en pantalla

Instalar el SDK e inicializarlo

Ver como Markdown

Añade el script del SDK justo debajo del snippet de tu widget (manual 06), y llama a initCopilot con tu manifiesto:

<script src="https://widget.example.com/v1/copilot-sdk.js"></script>
<script>
window.Copilot.initCopilot({
manifest: miManifiesto, // tu objeto v1, ver apartado 5
allowedWidgetOrigins: ["https://widget.example.com"], // obligatorio
confirmOnFill: false, // opcional: exige confirmar también al rellenar
locale: "es", // opcional: "es" | "en" | "it"
theme: "light", // opcional: "light" | "dark"
});
</script>

Nota — El nombre y el dominio de este ejemplo son ilustrativos

El script real que sirve tu proveedor y el nombre global que expone no se personalizan por marca blanca en esta versión del producto — cópialo tal cual aparece en tu propia sección «Copiloto» (manual 58, apartado 2), no lo escribas a mano a partir de este ejemplo.

allowedWidgetOrigins es obligatorio: sin él, el SDK ni siquiera arranca (lanza un error). Es la lista de orígenes desde los que tu widget puede enviar planes al SDK — cualquier mensaje de otro origen se descarta en silencio (con un aviso en la consola).

Aviso — Prueba antes de publicar

El SDK trae una web de prueba de fábrica: un formulario real con un manifiesto de ejemplo y un widget simulado que envía planes por el mismo contrato exacto que usaría tu widget real. Pide a tu proveedor el enlace a esa web de prueba — sirve para probar tus anclas y tu manifiesto sin tocar producción, antes de registrar nada.