Guías para desarrolladores
Kavchat es un chat de atención al cliente que responde según los guiones que escribes. No usa ningún modelo de lenguaje: el guion publicado se ejecuta en el dispositivo del usuario, por lo que las respuestas son rápidas, predecibles y siguen funcionando sin conexión. Aquí verás cómo encajan las piezas y por dónde empezar.
Cómo funciona Kavchat
- El panel de control. Tú y tu equipo acceden a app.kavchat.com. Cada espacio de trabajo tiene una clave pública (
pk_live_...) y una clave secreta (sk_live_...), ambas en la página Instalación. - Guiones. En el editor visual creas guiones a partir de pasos. Cada paso tiene un mensaje, botones y palabras clave. Un botón lleva a otro paso, a otro guion, a un enlace, a una pantalla de tu aplicación o al formulario de contacto.
- Publicación. Cada publicación se guarda como una versión numerada. Tú decides quién ve el bot: nadie, solo los usuarios de prueba (según su número de teléfono) o todo el mundo. Puedes restaurar una versión anterior en cualquier momento, sin actualizar la aplicación.
- Widget o SDK. Tu sitio web carga el widget con la clave pública y tu aplicación usa uno de los SDK para móviles. Descargan la versión publicada, la guardan en el dispositivo y gestionan la conversación en él.
- Token de identidad (opcional). Cuando un usuario ha iniciado sesión, tu servidor firma un JWT corto con la clave secreta. Así, Kavchat asocia el identificador del usuario de tu sistema a la conversación y al ticket, y puede mostrar un bot reservado para usuarios de prueba a las personas correspondientes.
- Tickets y webhook. Cuando el guion no resuelve el problema, el formulario de contacto abre un ticket con la conversación completa. El ticket llega a la bandeja de tickets del panel de control y, en Premium, también se envía a tu sistema mediante un webhook firmado. Tu servidor también puede consultar y cerrar tickets a través de la Server API.
Dos claves, dos lugares
| Clave | Dónde se usa | Para qué sirve |
|---|---|---|
Clave pública pk_live_... | En las páginas de tu sitio web y en tus aplicaciones. Se puede exponer. | Cargar el bot, informar sobre el recorrido de la conversación y abrir tickets. |
Clave secreta sk_live_... | Solo en tu servidor. Nunca en el navegador ni en la aplicación. | Firmar tokens de identidad, verificar webhooks y hacer llamadas a la Server API. |
Inicio rápido
En un sitio web basta con añadir esta línea antes de </body>. Cópiala con tu clave desde la página Instalación del panel de control:
<script src="https://cdn.kavchat.com/v1/kavchat.js" data-key="pk_live_..." async></script>Publica un guion, habilita el bot para todo el mundo (o para los números de teléfono de los usuarios de prueba) y recarga la página.
Guías
Botones y preguntas
Botones breves y preguntas completas en cada paso, con búsqueda cuando hay muchos temas.
Widget para sitios web
Una línea de código, interfaz JavaScript opcional, eventos y CSP.
React Native
Provider, pantalla de chat y botón flotante. Funciona en cualquier app React Native (desde la versión 0.72), con o sin Expo.
Flutter
Controlador, botón flotante y pantalla de chat, con compatibilidad RTL integrada.
iOS
Paquete Swift con componentes SwiftUI y UIKit. Desde iOS 15.
Android
Componentes Jetpack Compose y Activity para apps Views. Desde API 23.
Identificar usuarios
Firma un token de corta duración en tu servidor. Ejemplos en 7 lenguajes.
Webhook
Cada ticket nuevo llega a tu sistema, firmado. En Premium.
Server API
Tickets, informes, público y versiones, directamente desde tu servidor.
¿Necesitas ayuda?
Escríbenos a support@kavchat.com. La API completa se describe en el archivo openapi.yaml (OpenAPI 3.1).