Referencia del SDK
Vatio.chat inicia o retoma una conversación y espera una suscripción antes de resolver. El SDK maneja reconexiones, resincronización del historial y fallback a polling. Los mensajes incluyen id, role y content. Deduplica el historial y la entrega de eventos por id.
| Método | Propósito |
|---|---|
Vatio.config({ workspace, token }) | Traer la configuración pública del agente y del widget |
Vatio.chat(options) | Iniciar, retomar o reabrir una conversación |
Vatio.conversations({ workspace, token, ... }) | Listar las conversaciones de este visitante, más nuevas primero |
Vatio.resumable({ workspace, ... }) | Revisar si hay una conversación guardada localmente y no expirada |
Vatio.reset({ workspace, ... }) | Olvidar la conversación guardada localmente; no borra el historial del servidor |
chat.send(text) | Enviar un mensaje |
chat.history({ limit }) | Traer mensajes |
chat.on(event, handler) | Suscribirse a message, typing, status o error |
chat.close() | Desconectar el cliente |
Opciones
Vatio.chat acepta workspace y token, más los opcionales baseUrl, fresh, scope, visitorToken, replyStyle y conversation. fresh: true empieza un chat nuevo. conversation reabre una entrada devuelta por Vatio.conversations.
Usa un scope distinto cuando las UIs de preview y live comparten origen. Pasa el mismo scope y visitorToken a chat, conversations, resumable y reset. El almacenamiento se separa por el token de visitante completo, así que emitir un token nuevo también cambia su scope local de conversación. No fusiona contactos entre dispositivos.
Almacenamiento
El SDK guarda la conversación actual por pestaña y una referencia de visitante en local storage. Las credenciales de chat duran 12 horas. Trata las referencias de visitante y las credenciales de chat como privadas: la referencia puede recuperar la lista de conversaciones de ese visitante y credenciales de chat frescas, así que guarda la referencia donde el usuario con sesión no pueda leer la de otro, y nunca la derives de un ID de usuario público o predecible. Emite una referencia nueva cuando cambie el usuario con sesión.