Skip to main content
API-Verbindungen sind benutzerdefinierte HTTP-Funktionen, die Ihre Agenten während eines Gesprächs aufrufen können — eine Bestellung nachschlagen, ein Ticket erstellen oder den Kontostatus aus Ihrem eigenen Backend abrufen. Sie definieren den Endpunkt einmal unter Verbindungen → APIs (/dashboard/api-connections); Agenten, denen die Verbindung zugewiesen ist, können sie dann aufrufen, wenn das Gespräch es erfordert. Es gibt zwei Möglichkeiten, eine Verbindung zu erstellen: Fügen Sie etwas ein, das der Assistent analysieren kann, oder richten Sie die Verbindung manuell ein.

​
Der schnelle Weg: Einfügen und analysieren

1

Auf Neue API-Verbindung klicken

Der Dialog wird im Assistenten geöffnet. Fügen Sie einen Beispielbefehl cURL, eine OpenAPI/Swagger-Spezifikation, einen Postman-Export, ein TypeScript-Interface oder ein Zod-Schema in das Feld ein.
2

Auf Analysieren klicken

ThunderPhone leitet die gesamte Verbindung aus Ihrer Eingabe ab — URL, Methode, Header und ein Parameterschema, das aus den gefundenen Abfrageparametern und dem Request-Body erstellt wird. Die eingefügten Header (einschließlich Authentifizierungs-Header) werden in die Endpunktkonfiguration übernommen.
3

Die hervorgehobenen Felder bestätigen

Die abgeleitete Konfiguration wird mit den zur Überprüfung hervorgehobenen geschätzten Feldern geöffnet. Passen Sie Namen, Beschreibungen und Parametertypen an, damit der Agent versteht, wann und wie die Funktion aufgerufen werden soll — die Beschreibung liest das Modell.
4

Validieren & Speichern

Beim Speichern wird zunächst eine Live-Testanfrage an Ihren Endpunkt gesendet. Wenn die Anfrage fehlschlägt, wird die Verbindung nicht gespeichert — korrigieren Sie die URL, Authentifizierungs-Header oder den Body und versuchen Sie es erneut. Bei Erfolg wird die Verbindung mit einem Validiert-Badge gespeichert.
Wenn der Assistent in Ihrer Eingabe keine Request-URL finden kann, wird er Sie darauf hinweisen — fügen Sie einen vollständigen http(s)-Endpunkt ein und versuchen Sie es erneut.

​
Manuelle Einrichtung

Klicken Sie im Assistenten auf Manuell einrichten → (oder auf Soll die KI dies ableiten? Assistent ausprobieren →, um zurückzugehen). Der manuelle Builder enthält zwei Editoren:
  • Visuell — Formularfelder für den Anzeigenamen, Funktionsnamen, die Request- URL, die Methode (POST, GET, PUT, PATCH, DELETE), benutzerdefinierte Header und das Parameterschema (Eigenschaft hinzufügen für jedes Argument, das der Agent bereitstellen kann).
  • JSON — dieselbe Definition als Roh-JSON zum direkten Einfügen oder Feinabstimmen einer Toolspezifikation.
Ein Bereich Testanfrage (optional) ermöglicht es Ihnen, die konfigurierte Anfrage vor dem Speichern auszuführen, und zeigt Status, Latenz und eine Antwortvorschau an. Validieren & Speichern führt diesen Test immer aus und speichert nur bei Erfolg.
Geben Sie Parametern Beschreibungen in Alltagssprache („E-Mail-Adresse des Kunden, z. B. jane@example.com“). Der Agent wählt Argumente anhand dieser Beschreibungen in Echtzeit während des Anrufs aus.

​
Ihre Verbindungen verwalten

Jede Verbindungszeile zeigt ihren Validierungsstatus — Validiert, Nicht getestet oder Fehler — ihren Funktionsnamen und die Agenten, die sie verwenden. Über das Aktionsmenü der Zeile können Sie:
  • Bearbeiten — die Konfiguration erneut öffnen.
  • Klonen — sie als Ausgangspunkt duplizieren (die Kopie startet als Nicht getestet).
  • Versionsverlauf — frühere Versionen anzeigen und eine davon im Editor wiederherstellen.
  • Übertragen — die Verbindung in eine andere Organisation kopieren oder verschieben, der Sie angehören. Beim Verschieben wird sie hier entfernt; Agenten, die sie verwendet haben, müssen möglicherweise neu konfiguriert werden.
  • Löschen — dauerhaft; Agenten, die die Verbindung verwenden, müssen neu konfiguriert werden.

​
An einen Agenten anhängen

Fügen Sie die Verbindung in der API-Verbindungen-Sektion des Builders zu einem Agenten hinzu (Agenten erstellen). Die Liste zeigt, welche Agenten jede Verbindung verwenden, sodass Sie auf einen Blick erkennen können, welche Auswirkungen eine Änderung hat.

​
Nächste Schritte

Tool-Integrationen über die API

Erstellen und verwalten Sie dieselben Verbindungen programmgesteuert.

Apps verbinden

Vorgefertigte Verbindungen für Google, Slack, HubSpot, Salesforce und Cal.com.

Einen MCP-Server hinzufügen

Stellen Sie Ihren Agenten einen vollständigen Tool-Server zur Verfügung.

Referenz der Integrations-API

Jedes Feld der Integrationsressource.