Viavitna
Documentación
Configure el contenido, el widget web y la conexión API
Del contenido al asistente en vivo
Cuatro pasos, sin herramientas de compilación, sin SDK. Si puede pegar una etiqueta de script, puede lanzar Viavitna.
Inicio rápido
1 · Subir → 2 · Probar → 3 · Publicar → 4 · Insertar
- Suba su contenido. En la consola, elija un nombre de cliente y suba sus archivos — Markdown, HTML o texto plano. Esto construye un borrador: consultable, versionado e invisible para los visitantes.
- Pruebe el borrador. Hágale las preguntas reales de sus clientes. Revise las citas. Vuelva a subir y probar cuanto quiera.
- Publique. Un clic promueve el borrador a producción y genera sus claves: una publicable
pub_…(para el widget) y una secretasec_…(para uso de servidor a servidor — guárdela; se muestra una sola vez). - Inserte. Pegue el fragmento antes de
</body>en su sitio:
<script src="https://viavitna.com/widget.js"
data-viau-tenant="su-empresa"
data-viau-key="pub_..." data-viau-lang="es" defer></script>
Luego restrinja la clave a su sitio con la lista de orígenes permitidos en la consola (o pídanos hacerlo).
Referencia
Atributos del widget
| Atributo | Requerido | Significado |
|---|---|---|
data-viau-tenant | sí | Su identificador de cliente. |
data-viau-key | sí | Su clave publicable (pub_…). Segura de insertar; protéjala con la lista de orígenes. |
data-viau-title | no | Título del panel (por defecto "Ask us"). |
data-viau-lang | no | en (por defecto) o es — idioma de la interfaz y de las respuestas. |
data-viau-host | no | Anular el host de la API (por defecto, el origen del script). |
La API de respuestas
POST https://viavitna.com/t/<cliente>/answer
Cabeceras: content-type: application/json
x-viau-public-key: pub_... (navegador) — o —
x-viau-key: sec_... (servidor a servidor)
Cuerpo: {"question": "¿Cómo funcionan las devoluciones?", "language": "es"}
| Resultado | Significado |
|---|---|
status: insufficient | Su contenido no cubre la pregunta; la respuesta lo dice con honestidad. |
mode: generated | Una respuesta verificada y citada, escrita desde sus pasajes. |
mode: extractive_fallback | Un pasaje relevante textual — cuando la generación no está disponible o no es verificable. Igual citado, igual verdadero. |
401 / 403 / 429 | Clave inválida / origen no permitido / límite de tasa. |
Consejos de contenido
- Escriba las respuestas en su contenido: el asistente solo puede decir lo que sus páginas dicen.
- Los encabezados importan — encabezados claros mejoran la recuperación y las citas.
- Use el vocabulario de sus clientes; el lenguaje sencillo gana.
- Vuelva a subir cuando quiera: los cambios quedan en el borrador hasta que los publique.