API-Referenz

1. API-Key erstellen

Öffnen Sie in der App den Bereich Developer Access. Dort erstellen und verwalten Sie Ihre API-Keys. Behandeln Sie einen Key wie ein Passwort: geheim halten, nur serverseitig verwenden und bei Verdacht sofort widerrufen und neu ausstellen.

2. Mit einem Bearer-Key authentifizieren

Requests authentifizieren Sie über den Standard-Mechanismus Bearer-Token: Sie senden Ihren API-Key im Authorization-Header mit. Konzeptionell sieht das so aus:

Authorization: Bearer IHR_API_KEY

Genaue Endpunkte, Felder und Beispiel-Payloads finden Sie stets in der App neben Ihrem Key — dort ist die Referenz an die tatsächlich freigeschaltete Version gebunden und damit verlässlicher als jede statische Kopie.

3. Was programmatischer Zugriff bedeutet

Auf hoher Ebene erlaubt Ihnen die API, Kyros aus Ihren eigenen Systemen heraus anzusprechen, statt nur über das eingebettete Widget. Das ist die Grundlage für maßgeschneiderte Integrationen: einen Assistenten aus einem Backend heraus konsultieren, Ergebnisse in ein internes Tool zurückspielen oder Kyros in einen bestehenden Workflow einbinden.

4. Aktionen aus interaktiven Cards

Für viele Integrationen brauchen Sie gar keinen eigenen API-Client. Die Aktionen einer interaktiven Card können Ihre eigene API aufrufen oder den Code Ihrer App ausführen, den Bildschirm wechseln, eine Chat-Nachricht senden oder einen Link öffnen. So verbinden Sie Kyros mit Ihren Systemen — für Lead-Erfassung, Produktkacheln oder Freigaben — direkt aus dem Gespräch heraus, ohne separaten Backend-Aufwand.

Möchten Sie eine bestimmte Plattform anbinden, sehen Sie sich die Integrationen an. Für die reine Einbettung genügt bereits die Einbetten-Anleitung.