Anleitungen für Entwickler
Kavchat ist ein Support-Chat, der anhand Ihrer Skripte antwortet. Er nutzt kein Sprachmodell: Das veröffentlichte Skript läuft auf dem Gerät des Nutzers. Deshalb sind die Antworten schnell, vorhersehbar und auch offline verfügbar. Hier erfahren Sie, wie die einzelnen Teile zusammenspielen und wo Sie anfangen können.
So ist Kavchat aufgebaut
- Dashboard. Sie und Ihr Team melden sich unter app.kavchat.com an. Jeder Arbeitsbereich hat einen öffentlichen Schlüssel (
pk_live_...) und einen geheimen Schlüssel (sk_live_...). Beide finden Sie auf der Seite Installation. - Skripte. Im visuellen Editor erstellen Sie Skripte aus einzelnen Schritten. Jeder Schritt enthält eine Nachricht, Schaltflächen und Schlüsselwörter. Eine Schaltfläche führt zu einem anderen Schritt, einem anderen Skript, einem Link, einer Ansicht in Ihrer App oder zum Kontaktformular.
- Veröffentlichung. Jede Veröffentlichung wird als nummerierte Version gespeichert. Sie legen fest, wer den Bot sieht: niemand, nur Testnutzer (anhand ihrer Telefonnummer) oder alle. Sie können jederzeit eine frühere Version wiederherstellen, ohne die App zu aktualisieren.
- Widget oder SDK. Ihre Website lädt das Widget mit dem öffentlichen Schlüssel, Ihre App verwendet eines der mobilen SDKs. Diese laden die veröffentlichte Version herunter, speichern sie auf dem Gerät und führen dort das Gespräch.
- Identitätstoken (optional). Wenn ein Nutzer angemeldet ist, signiert Ihr Server ein kurzes JWT mit dem geheimen Schlüssel. So ordnet Kavchat dem Gespräch und dem Ticket Ihre Nutzer-ID zu und kann einen nur für Testnutzer freigegebenen Bot den richtigen Personen anzeigen.
- Tickets und webhook. Wenn das Skript das Problem nicht löst, erstellt das Kontaktformular ein Ticket mit dem vollständigen Gesprächsverlauf. Es erscheint im Ticket-Posteingang des Dashboards und wird im Premium-Tarif zusätzlich über einen signierten webhook an Ihr System gesendet. Ihr Server kann Tickets auch über die Server API lesen und schließen.
Zwei Schlüssel, zwei Einsatzorte
| Schlüssel | Einsatzort | Verwendungszweck |
|---|---|---|
Öffentlicher Schlüssel pk_live_... | Auf Ihren Webseiten und in Ihren Apps. Er darf öffentlich sichtbar sein. | Bot laden, Gesprächsverlauf melden und Tickets erstellen. |
Geheimer Schlüssel sk_live_... | Nur auf Ihrem Server. Niemals im Browser oder in der App. | Identitätstoken signieren, webhook verifizieren und Server API aufrufen. |
Schnellstart
Für Ihre Website reicht diese Zeile vor </body>. Kopieren Sie sie mit Ihrem eigenen Schlüssel von der Seite Installation im Dashboard:
<script src="https://cdn.kavchat.com/v1/kavchat.js" data-key="pk_live_..." async></script>Veröffentlichen Sie ein Skript, geben Sie den Bot für alle frei (oder für die Telefonnummern Ihrer Testnutzer) und laden Sie die Seite neu.
Anleitungen
Buttons und Fragen
Kurze Buttons und ausformulierte Fragen in jedem Schritt, mit Suche bei vielen Themen.
Website-Widget
Eine Codezeile, optionale JavaScript-Schnittstelle, Ereignisse und CSP.
React Native
Provider, Chatansicht und schwebender Button. Funktioniert in jeder React Native-App (ab Version 0.72), mit oder ohne Expo.
Flutter
Controller, schwebender Button und Chatansicht mit integrierter RTL-Unterstützung.
iOS
Swift-Paket mit SwiftUI- und UIKit-Komponenten. Ab iOS 15.
Android
Jetpack Compose-Komponenten und eine Activity für Views-Apps. Ab API 23.
Nutzer identifizieren
Kurzlebiges Token auf Ihrem Server signieren. Beispiele in 7 Sprachen.
webhook
Jedes neue Ticket kommt signiert in Ihrem System an. Mit Premium.
Server API
Tickets, Berichte, Zielgruppe und Versionen direkt von Ihrem Server.
Brauchen Sie Hilfe?
Schreiben Sie uns an support@kavchat.com. Die vollständige API ist in der Datei openapi.yaml beschrieben (OpenAPI 3.1).