API-Connectors für Live-Chatbot-Daten

API Connectors

Mit API Connectors kann Ihr Chatbot während eines Gesprächs externe REST-APIs aufrufen, um Daten in Echtzeit abzurufen. Nutzen Sie sie, um Bestellungen nachzuschlagen, Bestände zu prüfen, Konten zu verifizieren oder Daten von jedem Dienst abzurufen, der eine API bereitstellt. Der Chatbot erfragt die erforderlichen Details beim Besucher, ruft Ihre API auf, validiert die Antwort und präsentiert das Ergebnis in natürlicher Sprache.

API Connectors sind ab dem Standard-Tarif verfügbar. Im Free- oder Basic-Tarif sind sie nicht enthalten.

API Connector hinzufügen

Öffnen Sie Ihren Assistenten im Dashboard und wechseln Sie in den Reiter Funktionen. Wählen Sie in der Liste unter Mehr wissen den Eintrag Andere Systeme anbinden. Auf der Karte heißt jeder API Connector Anbindung. Die Liste der Funktionen zeigt An, sobald der Chatbot mindestens eine Anbindung nutzt. Klicken Sie auf Anbindung hinzufügen.

Im Dialog startet sofort der KI-Assistent. Beschreiben Sie Ihr Ziel, zum Beispiel: Bestellstatus aus einem WooCommerce-Shop abfragen. Der KI-Assistent fragt Schritt für Schritt nach, recherchiert die Schnittstelle des Systems und füllt die Einstellungen selbst aus. Der Dialog richtet die Anbindung nur ein. Ob der Chatbot sie nutzt, auch bei Anrufen, stellen Sie in der Liste der Anbindungen ein.

Das technische Formular mit Adresse (URL), Methode, Headern, Feldern, Antwort-Validierung und Prompt ist eingeklappt. Sie öffnen es über Technische Details anzeigen unten im Dialog. Beim Anlegen einer neuen Anbindung finden Sie dort auch Vorlage auswählen mit vorgefertigten Vorlagen.

Um eine bestehende Anbindung zu ändern, klicken Sie auf das Stift-Symbol. Auch dann startet der KI-Assistent und fragt, was Sie ändern möchten. Gespeicherte Zugangsdaten bleiben erhalten. Der KI-Assistent bekommt sie nicht zu sehen.

In der Liste der Anbindungen hat jede Anbindung zwei Schalter:

  • Vom Chatbot genutzt: Bei einer neuen Anbindung an. Ist er aus, bleibt die Anbindung gespeichert, aber der Chatbot ruft darüber nichts mehr ab.
  • Auch bei Anrufen nutzen: Standardmäßig aus. Ist er an, nutzt auch der Telefon-Assistent die Anbindung während eines Anrufs. Solange Vom Chatbot genutzt aus ist, lässt sich dieser Schalter nicht ändern.

Unterhalb des Standard-Tarifs und außerhalb einer Testphase zeigt die Liste ein Schloss neben dem Eintrag, und die Karte zeigt statt Anbindung hinzufügen einen Upgrade-Hinweis. Bereits angelegte Anbindungen bleiben aufgelistet.

Konfigurationsfelder

Die folgenden Felder finden Sie unter Technische Details anzeigen. Der KI-Assistent füllt sie für Sie aus. Dort können Sie sie prüfen und anpassen.

Grundeinstellungen

FieldBeschreibungPflichtfeld
NameEin aussagekräftiger Name für diesen Connector (z. B. "Bestellabfrage", "Bestandsprüfung").Ja
URLDie API-Endpunkt URL (z. B. https://api.example.com/orders).Ja
HTTP-MethodeHTTP-Methode: GET, POST, PUT, PATCH oder DELETE.Ja (Standard: GET)
Headers (JSON)Optionale HTTP-Header im JSON-Format (z. B. {"Authorization": "Bearer abc123", "Content-Type": "application/json"}). Muss gültiges JSON sein.Nein

Request-Body (nur POST/PUT/PATCH)

FieldBeschreibung
Body Content-TypFormat des Request-Bodys: JSON oder Form Data.
Request Body-VorlageVorlage für den Request-Body. Verwenden Sie Platzhalter wie {email}, {order_id}, die Ihren definierten Feldern entsprechen.

Beispiel für eine Body-Vorlage:

{
  "email": "{email}",
  "order_id": "{order_id}"
}

Felder

Felder definieren, welche Informationen der Chatbot vom Besucher erfassen muss, bevor er die API aufruft. Jedes Feld enthält:

EigenschaftBeschreibungPflichtfeld
FeldnameDie Feldkennung (z. B. order_id, email). Wird als Platzhalter im Request-Body verwendet.Ja
TypDatentyp: string, number, email oder boolean.Ja (Standard: string)
Beschreibung (für KI)Erklärt der KI, wozu dieses Feld dient und wie sie den Besucher danach fragen soll.Nein
PflichtfeldGibt an, ob der Besucher dieses Feld ausfüllen muss, bevor die API aufgerufen wird.Nein

Beispielfelder:

NameTypBeschreibungPflichtfeld
order_idstringDie Bestellnummer des Kunden, beginnt üblicherweise mit ORD-Ja
emailemailDie bei der Bestellung verwendete E-Mail-AdresseJa

Regeln für die Antwort-Validierung

Validierungsregeln stellen sicher, dass die API-Antwort mit den Angaben des Besuchers übereinstimmt. Dies verhindert, dass Daten für die falsche Person oder Bestellung ausgegeben werden.

Jede Regel enthält:

EigenschaftBeschreibung
EingabefeldDas vom Besucher bereitgestellte Feld, gegen das validiert werden soll (aus Ihren definierten Feldern).
Antwort-PfadPfad zum Wert in der API-Antwort (z. B. billing.email, data.order.status). Verwenden Sie die Punktnotation für verschachtelte Objekte.
VergleichArt des Abgleichs: equals, equals (ignore case), contains oder not empty.
FehlermeldungNachricht, die dem Besucher angezeigt wird, wenn die Validierung fehlschlägt (z. B. "Die E-Mail stimmt nicht mit unseren Einträgen überein").

Beispielvalidierung:

EingabefeldAntwort-PfadVergleichFehlermeldung
emailbilling.emailequals (ignore case)Die E-Mail-Adresse stimmt nicht mit der Bestellung überein. Bitte überprüfen und erneut versuchen.

Prompt

Anweisungen für die KI, wann und wie dieser Connector zu verwenden ist. Dies ist entscheidend, damit der Chatbot weiß, wann der API-Aufruf ausgelöst werden soll.

Beispiel-Prompt:

Use this connector when a customer asks about their order status, shipping 
information, or delivery date. Ask for their order ID and email address before 
making the API call. Present the order status, shipping method, and estimated 
delivery date in a friendly format.

So funktioniert's

  1. Der Besucher stellt eine Frage, die zum Prompt des Connectors passt (z. B. "Wo ist meine Bestellung?")
  2. Der Chatbot fragt nach den erforderlichen Pflichtfeldern (z. B. Bestellnummer, E-Mail)
  3. Der Besucher gibt die Informationen ein
  4. Der Chatbot ruft die API mit den erfassten Daten auf
  5. Die Validierungsregeln werden anhand der Antwort geprüft
  6. Ist die Validierung erfolgreich, gibt der Chatbot die Daten in natürlicher Sprache aus

Mehrere API Connectors verketten

Sie können mehrere API Connectors kombinieren, um komplexe Workflows abzubilden. Die KI verkettet diese bei Bedarf automatisch.

Beispiel: Authentifizierung + Datenabruf

  1. Connector 1: "Kunden authentifizieren": Ruft einen Login-Endpunkt mit der E-Mail-Adresse und dem Passwort des Besuchers auf und erhält ein Authentifizierungs-Token in der Antwort.
  2. Connector 2: "Bestelldetails abrufen": Verwendet das Token aus der ersten Anfrage, um einen geschützten API-Endpunkt aufzurufen und Bestelldaten abzurufen.

Die KI erledigt das selbst: Sie erkennt, dass der zweite Connector Daten aus dem ersten benötigt, führt die Aufrufe in der richtigen Reihenfolge aus und präsentiert dem Besucher das Endergebnis, alles innerhalb eines einzigen Gesprächsverlaufs.

Um dies einzurichten, konfigurieren Sie jeden Connector separat mit eigenem Endpunkt, Feldern und Prompt. Beschreiben Sie im Prompt des zweiten Connectors, dass er von Daten des ersten abhängt (z. B. "Verwende das Authentifizierungs-Token aus dem Connector 'Kunden authentifizieren', um diesen Endpunkt aufzurufen"). Die KI steuert den Ablauf automatisch.

Best Practices

  • Klare Prompts verfassen: Der Prompt ist das wichtigste Feld; er bestimmt, wann der Connector ausgelöst wird
  • Validierungsregeln hinzufügen: Validieren Sie vertrauliche Daten immer, um Datenlecks zu vermeiden
  • Aussagekräftige Feldbeschreibungen nutzen: Helfen Sie der KI, die richtigen Fragen auf natürliche Weise zu stellen
  • Mit echten API-Antworten testen: Stellen Sie sicher, dass der Antwort-Pfad mit Ihrer tatsächlichen API-Struktur übereinstimmt
  • Fehler sauber abfangen: Hinterlegen Sie verständliche Fehlermeldungen für fehlgeschlagene Validierungen
  • Authentifizierungs-Header verwenden: Sichern Sie Ihre API-Endpunkte stets mit einer geeigneten Authentifizierung ab