Guide per sviluppatori

Kavchat è una chat di assistenza che risponde seguendo gli script che scrivi. Non usa un modello linguistico: lo script pubblicato viene eseguito sul dispositivo dell'utente, quindi le risposte sono rapide, prevedibili e continuano a funzionare anche offline. Qui trovi come si collegano i vari componenti e da dove iniziare.

Come funziona Kavchat

1. La dashboard. Tu e il tuo team accedete a app.kavchat.com. Ogni spazio di lavoro ha una chiave pubblica (pk_live_...) e una chiave segreta (sk_live_...), entrambe nella pagina Installazione.
2. Gli script. Nell'editor visuale crei script composti da passaggi. Ogni passaggio contiene un messaggio, pulsanti e parole chiave. Un pulsante porta a un altro passaggio, a un altro script, a un link, a una schermata della tua app o al modulo di contatto.
3. La pubblicazione. Ogni pubblicazione viene salvata come versione numerata. Scegli tu chi vede il bot: nessuno, solo gli utenti di test (in base al numero di telefono) o tutti. Puoi ripristinare una versione precedente in qualsiasi momento, senza aggiornare l'app.
4. Il widget o un SDK. Il sito carica il widget con la chiave pubblica, mentre l'app usa uno degli SDK per dispositivi mobili. Questi scaricano la versione pubblicata, la salvano sul dispositivo e gestiscono la conversazione direttamente lì.
5. Un token di identità (facoltativo). Quando un utente ha effettuato l'accesso, il tuo server firma un JWT breve con la chiave segreta. In questo modo Kavchat associa alla conversazione e al ticket l'identificativo utente del tuo sistema e può mostrare un bot riservato agli utenti di test alle persone giuste.
6. I ticket e il webhook. Quando lo script non risolve il problema, il modulo di contatto apre un ticket con l'intera conversazione. Il ticket arriva nella casella dei ticket della dashboard e, con Premium, viene inviato anche al tuo sistema tramite un webhook firmato. Il tuo server può anche leggere e chiudere i ticket tramite la Server API.

Due chiavi, due posti diversi

Avvio rapido

Per il sito basta questa riga prima di </body>. Copiala con la tua chiave dalla pagina Installazione della dashboard:

<script src="https://cdn.kavchat.com/v1/kavchat.js" data-key="pk_live_..." async></script>

Pubblica uno script, rendi il bot visibile a tutti (o ai numeri di telefono degli utenti di test) e ricarica la pagina.

Le guide

Ti serve aiuto?

Scrivici a support@kavchat.com. L'API completa è descritta nel file openapi.yaml (OpenAPI 3.1).