Mid-call Action erstellen
Mid-call Action erstellen
Erstelle eine neue Mid-call Action in Famulor per API. Gib deinen KI-Telefonassistenten neue Aktionen wie Buchung, CRM-Abfrage oder Webhook-Trigger.
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 DELETEstring
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

