Für Entwickler
Was Sie heute aus dem Code mit Kallina verbinden können
Kallina hat noch keine dokumentierte öffentliche REST-API. Es gibt vier funktionierende Verbindungspunkte: Webhook-Tools, die der Agent während des Gesprächs aufruft, Adressen, die Flows starten, das Skript für den Sprachbutton und einen MCP-Server. Zugang zur API für Sonderfälle besprechen wir auf Anfrage.
Verbindungspunkte
Webhook-Tools während des Anrufs
In der Agentenkarte definieren Sie ein Tool: Name, Beschreibung, Adresse, Methode, Feldschema und maximale Wartezeit. Der Agent ruft es auf, wenn das Gespräch es verlangt, und verwendet die Antwort im Satz.
Adressen, die Flows starten
Ein Flow aus dem Builder kann eine eigene Auslöseadresse haben. Ihr System sendet eine Anfrage, und der Flow startet mit den empfangenen Daten.
Sprachbutton auf der Website
Ein einziges Skript auf der Seite. Die Sprachsitzung erhält eine temporäre Adresse, sodass die Agenten-ID im Seitencode nicht erscheint.
MCP-Server
MCP-kompatible Assistenten können sich per OAuth-Autorisierung mit dem Kallina-Konto verbinden, um Agents, Anrufe und Leads zu lesen oder Anrufe zu starten.
Sprachbutton: einzufügender Code
Das Skript wird einfach geladen, nicht als Modul und nicht über einen Bundler.
<script src="https://app.kallina.info/embed.js" data-widget="WIDGET_ID"></script>
<script>
window.KallinaVoice.on("state", (s) => console.log(s)); // idle | connecting | listening | speaking
window.KallinaVoice.on("message", (m) => console.log(m.source, m.text));
// window.KallinaVoice.start() / window.KallinaVoice.stop()
</script>| Attribut | Was es macht |
|---|---|
| data-widget | Die öffentliche Widget-ID. Erforderlich. |
| data-mode | „button“ zeigt den Button an; „inline“ zeigt nichts an und Sie überlassen den Start Ihrem Code. |
| data-position | Ecke des Buttons: unten rechts oder unten links. |
| data-color | Die Farbe der Schaltfläche. |
| data-label | Die zugängliche Beschriftung der Schaltfläche. |
Authentifizierung von Flow-Adressen
| Methode | Wann Sie sie verwenden |
|---|---|
| Keine Authentifizierung | Nur für Tests, bei Flows, die keine personenbezogenen Daten berühren. |
| Basic | Benutzername und Passwort, für Systeme, die nichts anderes kennen. |
| Eigener Header | Ein Header mit einem geheimen Wert, den Sie festlegen. |
| Bearer | Ein Token im Authorization-Header. |
Verfügbare MCP-Werkzeuge
Die unten aufgeführten Namen sind die auf dem Server. Der Zugriff wird pro Konto nach der Autorisierung gewährt.
- list_agents
- get_agent
- update_agent_prompt
- list_phone_numbers
- list_calls
- get_call_transcript
- list_leads
- export_leads
- start_outbound_call
- list_campaigns
- start_campaign
- account_status
Häufig gestellte Fragen
Haben Sie eine REST-API mit Schlüsseln?
Nicht öffentlich. Wenn Sie Anrufe starten oder Ergebnisse aus Ihrem System lesen müssen, schreiben Sie uns den Anwendungsfall und wir legen den Zugriff und seine Form fest.
Bekomme ich nach jedem Anruf einen Webhook mit dem Ergebnis?
Nicht als Standarddienst. Das Ergebnis wird über Flows oder über die bestehenden Integrationen übermittelt; für ein festes Format besprechen wir es im Projekt.
Gibt es Dokumentation?
Für die Sprachschaltfläche und die Webhook-Werkzeuge gibt es die Beschreibung auf dieser Seite und die Hilfe in der App. Für jeden zusätzlichen Zugriff erhalten Sie die Dokumentation beim Projektstart.
Müssen Webhook-Tools schnell antworten?
Ja. Jedes Tool hat eine maximale Wartezeit; eine langsame Antwort bedeutet eine Pause im Gespräch, also halten Sie die Anfragen kurz.
Beschreiben Sie uns, was Sie verbinden möchten
Sagen Sie, welches System, welche Daten und in welchem Moment des Anrufs. Wir sagen Ihnen, was sich mit dem Vorhandenen machen lässt und was gebaut werden muss.