SDK de navegador

El SDK de navegador es un paquete npm sin dependencias y con tipos incluidos. Crea un token publicable y permite el origen de tu página como se describe en la guía del widget.

npm install @vatio-ai/sdk

import { Vatio } from "@vatio-ai/sdk";

const options = { workspace: "acme", token: "vatpub_REPLACE_ME" };
const chat = await Vatio.chat(options);
const messages = new Map();

function receive(message) {
  messages.set(message.id, message);
  // Renderiza los mensajes ordenados por ID, escapando contenido no confiable.
}

chat.on("message", receive);
chat.on("typing", (typing) => { /* Actualiza tu indicador de escritura. */ });
chat.on("status", (status) => { /* Actualiza tu indicador de conexión. */ });
chat.on("error", (error) => console.error(error.code, error.message));

for (const message of await chat.history()) receive(message);
await chat.send("What does Acme do?");
// Llama a chat.close() cuando esta vista se desmonte.

Sin bundler

Cualquier CDN de npm sirve el mismo módulo:

<script type="module">
  import { Vatio } from "https://cdn.jsdelivr.net/npm/@vatio-ai/sdk/+esm";
</script>

Fija el major de la forma habitual — "@vatio-ai/sdk": "^2.0.0". El SDK solía publicarse desde una URL versionada (cdn.vatio.ai/v1/sdk.js) por exactamente esta razón, y un rango semver lo dice mejor: un cambio incompatible es un major nuevo al que actualizas cuando decides, no una segunda URL de la que enterarte.

Sigue: la referencia de cada método y opción, y los límites que toda página encuentra.