Skip to main content
POST
Mid-call Action erstellen
Dieser Endpunkt ermöglicht es dir, eine neue Mid-call Action zu erstellen, die von deinen KI-Assistenten verwendet werden kann, um während Anrufen mit externen APIs zu interagieren.

Body-Parameter

Die öffentliche API erstellt HTTP-Mid-call Actions. Automation-Platform-Mid-call Actions (die einen verknüpften Flow erzeugen) werden im Dashboard erstellt. Mid-call-Action-Werte unterstützen dynamische Variablen — verwende {param} für KI-extrahierte Parameter in der URL und {{variable}} (z. B. {{customer_phone}}) in der URL, in Header-Werten und in statischen Feld-Werten.
string
erforderlich
Name der Mid-call Action — Buchstaben, Zahlen und Unterstriche, beginnend mit einem Buchstaben oder Unterstrich (max. 64 Zeichen, z. B. get_weather, book_appointment)
string
erforderlich
Detaillierte Erklärung, wann und wie die KI diese Mid-call Action verwenden soll (max. 255 Zeichen)
string
erforderlich
Gültige URL des aufzurufenden API-Endpunkts (max. 2048 Zeichen)
string
erforderlich
HTTP-Methode: GET, POST, PUT, PATCH oder DELETE
string
Kodierung des Request-Bodys für Schreibmethoden (POST/PUT/PATCH): json (Standard) oder form (application/x-www-form-urlencoded)
integer
Request-Timeout in Sekunden (1-30, Standard: 10)
array
HTTP-Header, die mit der Anfrage gesendet werden
array
Feste Schlüssel/Wert-Paare, die immer mit der Anfrage gesendet werden (die KI ändert sie nie)
array
Parameter, die die KI aus der Unterhaltung extrahiert und an den Endpunkt sendet

Antwortfelder

string
Erfolgsmeldung
object
Das erstellte Mid-call-Action-Objekt

Mid-call Actions Assistenten hinzufügen

Nach dem Erstellen einer Mid-call Action musst du sie einem Assistenten zuweisen, um sie während Anrufen zu verwenden. Zuweisungen werden über die Assistenten-API verwaltet:
  • Assistent erstellen — Verwende den tool_ids-Parameter, um Mid-call Actions beim Erstellen eines Assistenten zuzuweisen
  • Assistent aktualisieren — Verwende den tool_ids-Parameter, um Mid-call Actions bei einem bestehenden Assistenten hinzuzufügen, zu entfernen oder zu ersetzen
Statt einzelner HTTP-Aktionen ein ganzes Toolset auf einmal? Externen MCP-Server verbinden — Tools werden automatisch erkannt. Siehe MCP-Server.