Guides pour les développeurs
Kavchat est un chat d’assistance qui répond à partir des scripts que vous écrivez. Il n’utilise aucun modèle de langage : le script publié s’exécute sur l’appareil de l’utilisateur. Les réponses sont donc rapides, prévisibles et restent disponibles hors ligne. Découvrez ici comment les différents éléments s’articulent et par où commencer.
Comment fonctionne Kavchat
- Le tableau de bord. Vous et votre équipe vous connectez sur app.kavchat.com. Chaque espace de travail dispose d’une clé publique (
pk_live_...) et d’une clé secrète (sk_live_...), toutes deux accessibles sur la page Installation. - Les scripts. Dans l’éditeur visuel, vous construisez vos scripts à partir d’étapes. Chaque étape contient un message, des boutons et des mots-clés. Un bouton mène à une autre étape, à un autre script, à un lien, à un écran de votre application ou au formulaire de contact.
- La publication. Chaque publication est enregistrée sous une version numérotée. Vous choisissez qui peut voir le bot : personne, uniquement les testeurs (par numéro de téléphone) ou tout le monde. Vous pouvez restaurer une version précédente à tout moment, sans mettre à jour l’application.
- Le widget ou un SDK. Votre site charge le widget à l’aide de la clé publique, et votre application utilise l’un des SDK mobiles. Le widget et les SDK téléchargent la version publiée, la conservent sur l’appareil et y gèrent la conversation.
- Un jeton d’identité (facultatif). Lorsqu’un utilisateur est connecté, votre serveur signe un JWT court avec la clé secrète. Kavchat associe ainsi l’identifiant de votre utilisateur à la conversation et au ticket, et peut afficher un bot réservé aux testeurs aux personnes concernées.
- Les tickets et le webhook. Lorsque le script ne résout pas le problème, le formulaire de contact crée un ticket contenant l’intégralité de la conversation. Ce ticket arrive dans la boîte de réception du tableau de bord et, avec Premium, est également envoyé à votre système par un webhook signé. Votre serveur peut aussi consulter et fermer des tickets via l’API serveur.
Deux clés, deux emplacements
| Clé | Où l’utiliser | À quoi elle sert |
|---|---|---|
Clé publique pk_live_... | Dans les pages de votre site et dans vos applications. Elle peut être exposée publiquement. | Charger le bot, transmettre le parcours de la conversation et créer des tickets. |
Clé secrète sk_live_... | Uniquement sur votre serveur. Jamais dans le navigateur ni dans l’application. | Signer un jeton d’identité, vérifier un webhook et appeler l’API serveur. |
Démarrage rapide
Pour un site web, cette ligne placée avant </body> suffit. Copiez-la avec votre clé depuis la page Installation du tableau de bord :
<script src="https://cdn.kavchat.com/v1/kavchat.js" data-key="pk_live_..." async></script>Publiez un script, rendez le bot accessible à tout le monde (ou aux numéros de téléphone des testeurs), puis actualisez la page.
Les guides
Boutons et questions
Des boutons courts et des questions complètes à chaque étape, avec une recherche quand les sujets sont nombreux.
Widget pour site web
Une ligne de code, une interface JavaScript facultative, des événements et CSP.
React Native
Provider, écran de chat et bouton flottant. Fonctionne dans toute application React Native (à partir de la version 0.72), avec ou sans Expo.
Flutter
Contrôleur, bouton flottant et écran de chat, avec prise en charge native du RTL.
iOS
Package Swift avec composants SwiftUI et UIKit. À partir d’iOS 15.
Android
Composants Jetpack Compose et Activity pour les applications Views. À partir de l’API 23.
Identification des utilisateurs
Signez un jeton à courte durée de validité sur votre serveur. Exemples en 7 langages.
Webhook
Chaque nouveau ticket arrive dans votre système, signé. Avec Premium.
Server API
Tickets, rapports, audience et versions, directement depuis votre serveur.
Besoin d’aide ?
Écrivez-nous à support@kavchat.com. L’API complète est décrite dans le fichier openapi.yaml (OpenAPI 3.1).