Hilfe-Center
Home Office KI-Telefonassistent

KI-Telefonassistent: API-Integrationen einrichten

Für den KI-Telefonassistenten

Die API-Funktionalität des KI-Telefonassistenten ermöglicht die Anbindung von Drittsystemen über REST-Schnittstellen. Dadurch ist ein bidirektionaler Datenaustausch (z. B. CRM-Abfragen, Ticket-Erstellung) während eines aktiven Anrufs möglich.

Hinweis

Die Einrichtung von API-Integrationen erfordert fortgeschrittene Programmierkenntnisse (REST, JSON). Wenn Sie mit diesen Begriffen nicht vertraut sind, empfehlen wir, die Einrichtung gemeinsam mit Ihrem IT-Administrator oder Web-Entwickler vorzunehmen.

Voraussetzungen

  • Sie sind IONOS-Kunde und verfügen über einen der folgenden Verträge:
    KI-Telefonassistent L
    KI-Telefonassistent All-Flat Advanced

Anwendungsbeispiele und Nutzen

Durch API-Integrationen kann Ihr KI-gestützter Telefonassistent Aktionen in Echtzeit ausführen und Gespräche auf Grundlage aktueller Daten personalisieren. Dadurch wird er von einem reinen Informationsgeber zu einem aktiven Mitarbeiter in Ihren Geschäftsprozessen.

Anwendungsfall Beispiel-Systeme Ihr Nutzen
Kundenmanagement (CRM) Salesforce, HubSpot, Pipedrive Der Assistent kann Anrufer anhand ihrer Telefonnummer sofort identifizieren, Kundendaten abfragen (z.B. Bestellstatus) und personalisierten Support bieten.
Kalender- & Buchungstools Google Calendar, Calendly, Outlook Der Assistent kann Termine buchen, verschieben oder stornieren, indem er die Verfügbarkeit in Echtzeit prüft.
Marketing HubSpot (Mailings), Mailchimp Nach einem Anruf kann der Assistent den Anrufer automatisch zu einer Mailingliste hinzufügen (z. B. für einen Newsletter) oder einen Lead in Ihrem System erstellen.
Support & Ticketing Zendesk, Freshdesk Der Assistent kann bei Support-Anfragen automatisch ein neues Ticket erstellen oder den Status eines bestehenden Tickets abfragen.

Voraussetzungen und technische Anforderungen

Für die Einrichtung ist technisches Fachwissen sowie Zugriff auf das Zielsystem erforderlich. Bitte prüfen Sie vorab die folgenden Punkte:

  • API-Endpunkt: Sie benötigen Zugriff auf ein externes System, das Anfragen über eine öffentliche REST-API entgegennehmen kann.
  • Authentifizierung: Halten Sie Ihre Zugangsdaten bereit (z. B. API-Key, Bearer-Token, Basic Auth). Hinweis: Interaktive OAuth-Flows (Login-Fenster) werden derzeit nicht unterstützt.
  • API-Kenntnisse: Ein grundlegendes Verständnis von REST-APIs, HTTP-Methoden (GET, POST) und JSON-Formaten ist für die Konfiguration notwendig.
  • Verantwortung: Sie sind selbst für die Verwaltung, Sicherheit und Verfügbarkeit (Uptime) der angebundenen API verantwortlich. Fehlerhafte Endpunkte können dazu führen, dass der Assistent das Gespräch abbricht.

Technische Funktionsweise

Der KI-Assistent fungiert als HTTP-Client. Seine Konfiguration besteht aus zwei Hauptkomponenten:

  • „Parameters” (JSON Schema): Legt fest, welche Informationen der Assistent vom Anrufer erfragen muss, bevor die Anfrage gesendet wird (z. B. Kundennummer, Datum).
  • „Request Definition” (HAR JSON): Hier wird der eigentliche API-Call definiert. Hier werden die gesammelten Parameter in die URL, den Header oder den Body der Anfrage injiziert.

Konfiguration der Schnittstelle

  • Loggen Sie sich in Ihr IONOS Konto ein.
  • Klicken Sie in der Titelleiste auf Menü > KI-Telefonassistent.
  • Öffnen Sie den Bereich API-Integrationen und klicken Sie auf + Integration hinzufügen. Ein Pop-up-Fenster öffnet sich.

Sie haben nun zwei Optionen, die Definition zu erstellen:

Option A: LLM-gestützte Einrichtung

Um Zeit bei der Erstellung der Syntax des HAR-Formats zu sparen, können Sie den bereitgestellten Prompt nutzen, um den Code durch ein externes Large Language Model (LLM) generieren zu lassen (z. B. ChatGPT, Claude), oder fragen Sie einfach Dora, die Code-Spezialistin von IONOS Momentum Team)

Achtung

Geben Sie in externen KI-Tools keine geheimen Zugangsdaten preis. Tragen Sie Keys oder Tokens ausschließlich im IONOS-Dialog ein.

  • Klicken Sie auf Prompt für externes LLM kopieren. Der Prompt wird in der Zwischenablage gespeichert.
  • Öffnen Sie ein externes KI‑Tool Ihrer Wahl und fügen Sie den Prompt aus der Zwischenablage ein. Beantworten Sie die Rückfragen zur gewünschten API.
  • Kopieren Sie den von der KI erzeugten JSON‑Block und fügen Sie ihn im IONOS-Dialog in das dafür vorgesehene Textfeld (Schritt 2) ein.
  • Klicken Sie auf Übernehmen und danach oben auf Änderungen speichern.

Option B: Experten-Modus (Manuell)

Dies ist der direkte Weg für Entwickler, die den benötigten Code (JSON-Format) bereits vorliegen haben.

  • Klicken Sie oben rechts im Pop-up-Fenster auf Experten-Modus.Ein weiteres Pop-up-Fenster öffnet sich.
  • Füllen Sie die erforderlichen Felder aus:
    • Name: Vergeben Sie einen eindeutigen Namen.
    • Beschreibung: Instruieren Sie das LLM, wann dieses Tool ausgelöst werden soll.
    • Parameter: Definieren Sie die Parameter, die der Assistent vom Anrufer erfragen soll. Die Eingabe muss im JSON-Format erfolgen.
    • Anfrage: Definieren Sie Ihre API-Anfrage im HAR-Format. Verwenden Sie {{ variableName }}, um auf oben definierte Parameter zu verweisen. Die Eingabe muss im JSON-Format erfolgen.
  • Klicken Sie auf Übernehmen und danach oben auf Änderungen speichern.

Inhalt