E-Mail wurde erfolgreich versandt.

KI-Telefonassistent: API-Integrationen einrichten

Mit API-Integrationen verbinden Sie Ihren KI-Telefonassistenten mit externen Systemen, zum Beispiel mit einem CRM, einem Helpdesk, Kalendern oder eigenen Fachanwendungen. So kann der Assistent während eines Gesprächs Daten abfragen (zum Beispiel Kundendaten oder den Status eines Tickets) oder Aktionen ausführen (zum Beispiel ein Ticket erstellen oder einen Lead anlegen). Zusätzlich können Sie MCP-Server verbinden und festlegen, ob eine Integration vor, während oder nach einem Anruf ausgeführt wird.

ℹ️ Info: Dieser Artikel gilt, wenn Sie den KI-Telefonassistenten gebucht haben. Die erweiterte API-Integration steht im Tarif Unlimited zur Verfügung, in den Tarifen Start und Pro ist sie nicht enthalten. Welchen Tarif Sie gebucht haben, sehen Sie im Kunden-Login unter Vertragsinformationen in der Tabelle Zusatzartikel. Einen Überblick finden Sie im Artikel KI Frontdesk: Überblick über alle Assistenten.
ℹ️ Info: Die Einrichtung von API-Integrationen erfordert technisches Fachwissen (REST, JSON, HTTP, API-Schlüssel). Binden Sie bitte Ihre IT-Abteilung oder eine erfahrene Entwicklerin bzw. einen erfahrenen Entwickler ein, wenn Sie mit diesen Begriffen nicht vertraut sind.


Inhaltsverzeichnis Inhaltsverzeichnis

Was sind API-Integrationen und wofür nutze ich sie?

Der Assistent kann während eines Anrufs über REST-Schnittstellen mit externen Systemen kommunizieren und wird damit von einem reinen Auskunftsassistenten zu einem aktiven Baustein Ihrer Geschäftsabläufe. Typische Einsatzszenarien:

AnwendungsfallBeispiel-SystemeTypischer Nutzen
Kundenmanagement (CRM)Salesforce, HubSpot, Pipedrive, ZohoKunde anhand der Rufnummer erkennen, Bestellstatus abfragen, Leads anlegen
Support & TicketingZendesk, Freshdesk, Jira Service DeskSupport-Tickets aus Anrufen erzeugen oder Status abfragen
Termin- & RessourcenplanungGoogle Calendar, Outlook, Cal.comTermine buchen, verschieben oder stornieren, Verfügbarkeiten prüfen
MarketingHubSpot, MailchimpLeads nach einem Anruf Mailinglisten zuordnen
Automatisierung / WebhooksZapier, Make, n8n, eigene WebhooksBeliebige Workflows anstoßen

Tipp: Nutzen Sie API-Integrationen zunächst für ein bis zwei klar umrissene Prozesse, zum Beispiel Ticket-Erstellung oder Lead-Anlage. Weitere Szenarien ergänzen Sie, wenn die Basis stabil läuft.

Für die Anbindung eines Kalenders oder Buchungstools gibt es eine eigene Einrichtung: siehe Terminbuchung einrichten.


Welche Voraussetzungen gelten?

  • Ihr Tarif enthält die erweiterte API-Integration (siehe oben).
  • Sie haben ein aktives Konto im Zielsystem (zum Beispiel CRM, Ticket-Tool oder Kalender) und dürfen dort API-Schlüssel oder Tokens erzeugen.
  • Sie kennen die Grundlagen von REST-APIs und HTTP-Methoden (GET, POST, PUT, DELETE), JSON und den Authentifizierungsverfahren des Zielsystems (API-Schlüssel, Bearer-Token, Basic Auth).
  • Das Zielsystem stellt eine öffentlich erreichbare REST-API bereit. Reine Intranet-APIs ohne Tunnel oder VPN sind nicht erreichbar.
⚠️ Warnung: Der Betrieb der angebundenen API (Erreichbarkeit, Sicherheit, Aktualität) liegt in Ihrer Verantwortung. Fehlerhafte oder nicht erreichbare Endpunkte können dazu führen, dass der Assistent Anfragen nicht ausführen oder Gespräche abbrechen muss.


Wie funktioniert eine API-Integration?

Der Assistent arbeitet bei API-Integrationen als HTTP-Client:

  1. Er führt das Gespräch und erfragt die benötigten Informationen, zum Beispiel Kundennummer, E-Mail-Adresse oder Ticket-ID.
  2. Er prüft diese Angaben anhand der von Ihnen definierten Parameter (JSON-Schema).
  3. Er baut die Anfrage gemäß Ihrer Anfrage-Definition (HAR-Format) auf und sendet sie an die externe API.
  4. Er nutzt die Antwort, um im Gespräch weiterzumachen, zum Beispiel: „Ich habe Ihr Ticket gefunden, der Status ist …".

Eine Integration besteht aus:

BestandteilBeschreibung
NameKurzer, eindeutiger Name, zum Beispiel crm_customer_lookup, ticket_create, get_appointments.
BeschreibungBeschreiben Sie, wann und wie die Integration verwendet werden soll, zum Beispiel: „Nutze dieses Tool, wenn der Anrufer nach dem Status seines Tickets fragt und eine Ticket-ID angibt."
ParameterWelche Angaben der Assistent vom Anrufer erfragen soll, als JSON-Schema.
AnfrageDie API-Anfrage im HAR-Format (JSON): Methode, URL, Header und Body. Mit {{ variableName }} verweisen Sie auf die oben definierten Parameter.


Wie füge ich eine API-Integration hinzu?

  1. Öffnen Sie im Kunden-Login Ihr Paket mit den KI-Assistenten. Klicken Sie auf der Seite Übersicht auf KI Frontdesk. Die Oberfläche öffnet sich in einem neuen Browser-Tab.
  2. Öffnen Sie in der Navigation links API-Integrationen.
  3. Klicken Sie auf Integration hinzufügen.
  4. Legen Sie oben im Fenster fest, wo und wann die Integration ausgeführt wird: Mit den Schaltern bei Telefon KI und Chat KI wählen Sie den Assistenten. Beim KI-Telefonassistenten wählen Sie zusätzlich den Zeitpunkt (siehe Wann soll die Integration ausgeführt werden?).
  5. Wählen Sie, wie Sie die Integration anlegen:
    • LLM-gestützt (Option A): Ein KI-Tool unterstützt Sie bei der Erstellung.
    • Experten-Modus (Option B): Sie definieren die Integration manuell. Mit Experten-Modus bzw. LLM-gestützt oben rechts im Fenster wechseln Sie zwischen beiden.
  6. Klicken Sie auf Übernehmen und danach oben rechts auf Speichern.
⚠️ Warnung: Änderungen werden nicht automatisch übernommen. Klicken Sie nach jeder Anpassung oben rechts auf Speichern, damit die Integration aktiv wird.


Wann soll die Integration ausgeführt werden?

Im Fenster Integration hinzufügen legen Sie fest, wo und wann die Integration ausgeführt wird. Dort gibt es für jeden Assistenten einen Schalter. Beim KI-Telefonassistenten wählen Sie zusätzlich den Zeitpunkt:

AssistentZeitpunktBedeutung
Telefon KIWährend des Anrufs (Standard)Der Assistent ruft die Integration auf, wenn er sie braucht.
Telefon KIVor dem AnrufDie Integration wird ausgeführt, bevor der Anruf beginnt.
Telefon KINach dem AnrufDie Integration wird ausgeführt, nachdem der Anruf beendet ist, zum Beispiel um ein Ticket in Ihrem Helpdesk anzulegen.
Chat KIWährend des ChatsDer Assistent ruft die Integration auf, wenn er sie braucht. Einen anderen Zeitpunkt können Sie nicht auswählen.
ℹ️ Info: Vor dem Anruf und Nach dem Anruf gibt es nur für den KI-Telefonassistenten, nicht für den KI-Chat-Assistenten.


Option A: LLM-gestützt

  1. Klicken Sie unter Schritt 1 auf In ChatGPT öffnen. Über das Pfeil-Symbol daneben können Sie stattdessen In Claude öffnen wählen oder mit Prompt kopieren den vorbereiteten Prompt in ein KI-Tool Ihrer Wahl einfügen (zum Beispiel Gemini).
  2. Beschreiben Sie dem KI-Tool die API, die Sie ansprechen möchten (URL, Endpunkt, Methode, benötigte Angaben).
  3. Lassen Sie sich die fertige Integration als JSON ausgeben.
  4. Kopieren Sie die JSON-Antwort und fügen Sie sie unter Schritt 2 in das Feld ein.
  5. Klicken Sie auf Übernehmen.
⚠️ Warnung: Geben Sie API-Schlüssel, Tokens, Passwörter oder andere vertrauliche Zugangsdaten niemals in ein externes KI-Tool ein. Nutzen Sie dort nur Platzhalter, zum Beispiel YOUR_API_KEY_HERE, und tragen Sie die echten Zugangsdaten anschließend ausschließlich in der Anfrage der Integration in KI Frontdesk ein.


Option B: Experten-Modus

  1. Klicken Sie oben rechts im Fenster auf Experten-Modus.
  2. Füllen Sie die Felder aus:
    • Name, zum Beispiel ticket_status
    • Beschreibung, wann der Assistent die Integration nutzen soll
    • Parameter im JSON-Format. Achten Sie auf korrekte Datentypen (string, number, boolean), sinnvolle Pflichtfelder (required) und gegebenenfalls Einschränkungen, zum Beispiel ein Muster für IDs.
    • Anfrage im HAR-Format. Mit {{ variableName }} verweisen Sie auf Parameter.
  3. Klicken Sie auf Übernehmen.

Beispiel: Ticketstatus abfragen

Parameter:

{
  "type": "object",
  "properties": {
    "ticketId": { "type": "string", "description": "Ticketnummer des Anrufers" }
  },
  "required": ["ticketId"]
}

Anfrage:

{
  "method": "GET",
  "url": "https://api.example.com/tickets/{{ ticketId }}"
}


Welche Systemvariablen kann ich nutzen?

Systemvariablen sind in jeder Anfrage verfügbar. Sie müssen sie nicht als Parameter deklarieren: Fügen Sie sie direkt in URL, Header oder Body Ihrer Anfrage ein. Im Fenster Integration hinzufügen finden Sie sie unter Systemvariablen.

VariableInhalt
{{ system_conversation_id }}Die Anruf- oder Chat-ID. Sie entspricht der ID, die in der Zusammenfassung des Gesprächs angegeben wird, und eignet sich, um jede Anfrage dem passenden Gespräch in Ihrem eigenen System zuzuordnen.
{{ system_caller_number }}Die Nummer des Anrufers. Hat der Anrufer seine Nummer unterdrückt, lautet der Wert „anonymous".
{{ system_agent_number }}Die angerufene Nummer, also die Nummer Ihres Assistenten.

Beispiel: Anrufer und Gespräch an ein externes System melden

{
  "method": "POST",
  "url": "https://api.example.com/calls",
  "headers": [{ "name": "Content-Type", "value": "application/json" }],
  "postData": {
    "mimeType": "application/json",
    "text": "{\"callId\": \"{{ system_conversation_id }}\", \"caller\": \"{{ system_caller_number }}\"}"
  }
}


Wie verbinde ich einen MCP-Server?

Ein MCP-Server (MCP steht für Model Context Protocol) ist die Schnittstelle einer Anwendung, über die ein Assistent deren Funktionen nutzen kann. Anders als bei einer API-Integration müssen Sie diese Funktionen nicht von Hand beschreiben: Sie verbinden den Server und schalten die Tools ein, die Ihr Assistent nutzen darf. MCP-Server stehen sowohl dem KI-Telefonassistenten als auch dem KI-Chat-Assistenten zur Verfügung. Ihre bisherigen API-Integrationen bleiben daneben unverändert nutzbar.

  1. Öffnen Sie in KI Frontdesk in der Navigation links API-Integrationen und scrollen Sie zum Bereich MCP-Server.
  2. Klicken Sie auf MCP-Server hinzufügen.
  3. Geben Sie im Feld Serveradresse die Adresse des MCP-Servers ein, zum Beispiel https://mcp.example.com/mcp.
  4. Klicken Sie auf Verbinden.
  5. Schalten Sie die Tools ein, die Ihr Assistent nutzen darf.
  6. Klicken Sie oben rechts auf Speichern.
⚠️ Warnung: Der Betrieb des MCP-Servers (Erreichbarkeit, Sicherheit, Aktualität) liegt in Ihrer Verantwortung. Schalten Sie nur die Tools ein, die der Assistent wirklich braucht.
ℹ️ Info: Wir können nicht zusichern, dass bestimmte Tools von Drittanbietern unterstützt werden oder wie sich der MCP-Server Ihrer Anwendung verhält.


Wie teste ich die Integration und behebe Fehler?

  1. Klicken Sie oben rechts auf Testanruf und simulieren Sie ein typisches Gespräch, in dem die Integration ausgelöst werden soll, zum Beispiel: „Ich möchte den Status meines Tickets mit der ID 12345 wissen."
  2. Prüfen Sie, ob der Assistent sinnvoll auf die Antwort der API reagiert und Fehler wie „Ticket nicht gefunden" freundlich kommuniziert.
  3. Nutzen Sie die Protokolle Ihres Zielsystems (CRM, Helpdesk), um zu prüfen, ob die Anfragen ankommen. Werten Sie bei Fehlern Statuscodes (4xx/5xx), Fehlermeldungen und die gesendeten Daten aus.

Typische Fehlerquellen:

  • falsche oder abgelaufene API-Schlüssel oder Tokens
  • Tippfehler in URLs oder Endpunkten
  • Feldnamen, die nicht zwischen Parametern und Anfrage übereinstimmen
  • fehlende Pflichtparameter oder falsche Datentypen


Wie gehe ich sicher mit API-Schlüsseln um?

API-Schlüssel und Tokens sind sensible Zugangsdaten, mit denen Dritte auf Ihre Systeme zugreifen könnten.

  • Geben Sie geheime Daten nie in externe KI-Tools oder öffentliche Foren ein.
  • Hinterlegen Sie API-Schlüssel nur in den dafür vorgesehenen Feldern, also in der Anfrage Ihrer Integration.
  • Erneuern Sie API-Schlüssel regelmäßig und nutzen Sie sie nicht länger als nötig.
  • Beschränken Sie die Zugriffsrechte im Zielsystem auf das notwendige Minimum.
  • Verwenden Sie für alle Aufrufe HTTPS (TLS).
  • Bei Verdacht auf Missbrauch: Sperren oder löschen Sie den Schlüssel sofort im Zielsystem, erzeugen Sie einen neuen und aktualisieren Sie die Anfrage Ihrer Integration.


Welche Best Practices gelten für stabile Integrationen?

  • Klein anfangen: Starten Sie mit einem klar abgegrenzten Anwendungsfall und erweitern Sie später.
  • Fehlerfälle bewusst gestalten: Legen Sie fest, wie der Assistent auf Fehler reagieren soll, zum Beispiel „Ticket nicht gefunden", „Verbindungsfehler" oder „Zeitüberschreitung".
  • Grenzen der API beachten: Prüfen Sie Rate Limits und erlaubte Aufrufmengen Ihres Zielsystems.
  • Datenqualität sichern: Validieren Sie Eingaben über das JSON-Schema und bitten Sie Anrufer gegebenenfalls um Bestätigung, zum Beispiel „Habe ich Ihre Kundennummer richtig verstanden?".
  • Regelmäßig prüfen: Haben sich Endpunkte oder Authentifizierung im Zielsystem geändert? Müssen neue Felder berücksichtigt werden?
  • Datenschutz beachten: Prüfen Sie, ob die Weitergabe von Gesprächsdaten an externe Systeme datenschutzrechtlich abgedeckt ist (Auftragsverarbeitungsvertrag, Datenschutzerklärung, Löschkonzept).


Weiterführende Artikel

War dieser Text hilfreich für Sie?