Skip to main content
POST
Assistenten erstellen
Dieser Endpunkt ermöglicht es Ihnen, einen neuen KI-Assistenten mit umfassenden Konfigurationsoptionen zu erstellen.

Anfragekörper

Wichtige Pflichtfelder

string
erforderlich
Der Name des Assistenten (max. 255 Zeichen)
integer
erforderlich
Die Stimmen-ID, die für den Assistenten verwendet werden soll (muss in den verfügbaren Stimmen vorhanden sein)
string
erforderlich
Der Sprachname für den Assistenten (max. 100 Zeichen)
string
erforderlich
Der zu verwendende LLM-Modellname (max. 100 Zeichen)
string
erforderlich
Der Anrufrrichtungstyp. Optionen: receive, make
string
erforderlich
Der zu verwendende Engine-Typ. Optionen: pipeline, multimodal
string
erforderlich
Die Zeitzone für den Assistenten (z. B. “America/New_York”)
string
erforderlich
Die erste Nachricht, die der Assistent beim Start des Anrufs sprechen wird
string
erforderlich
Der System-Prompt, der das Verhalten und die Persönlichkeit des Assistenten definiert

Optionale Konfiguration

integer
Die ID einer Telefonnummer, die dem Assistenten zugewiesen werden soll (muss in den Telefonnummern des Benutzers vorhanden sein)
integer[]
Array von Mid-Call-Tool-IDs, die dem Assistenten zugeordnet werden sollen. Jedes Element muss eine gültige Tool-ID sein, die zu Ihrem Konto gehört.
string
Sprachaktivitätserkennungstyp. Optionen: vad, ai
number
Endpunkt-Empfindlichkeitsstufe (0-5)
number
Unterbrechungs-Empfindlichkeitsstufe (0-5)
number
Umgebungsgeräusch-Lautstärkepegel (0-1)
boolean
Ob die Post-Call-Bewertung aktiviert werden soll
boolean
Ob Webhooks nur bei abgeschlossenen Anrufen gesendet werden sollen
boolean
Ob die Aufzeichnungs-URL in die Webhook-Payload aufgenommen werden soll

Webhook-Konfiguration

boolean
Ob Webhook-Benachrichtigungen aktiviert sind
string
Die Webhook-URL für Post-Call-Benachrichtigungen (erforderlich, wenn is_webhook_active true ist)

Unterbrechungseinstellungen

boolean
Ob die Einstellung für minimale Unterbrechungswörter verwendet werden soll
integer
Mindestanzahl von Wörtern, bevor eine Unterbrechung erlaubt ist (0-10)

Variablen und Schema

object
Schlüssel-Wert-Paare von benutzerdefinierten Variablen für den Assistenten
array
Schemadefinition für die Post-Call-Datenextraktion

Anruf-Beenden-Tool

string
Beschreibung für die Anruf-Beenden-Tool-Funktionalität (max. 500 Zeichen)

Stimm- und Spracheinstellungen

number
LLM-Temperatureinstellung (0-1)
number
Stimmstabilitätseinstellung (0-1)
number
Stimmähnlichkeitseinstellung (0-1)
number
Sprechgeschwindigkeitsmultiplikator (0.7-1.2)

Anrufverhaltenseinstellungen

boolean
Ob Anruferunterbrechungen erlaubt werden sollen
boolean
Ob Fülllaute während der Verarbeitung verwendet werden sollen
integer
Intervall für erneuten Eingriff in Sekunden (7-600)
integer
Maximale Anrufdauer in Sekunden (20-1200)
integer
Maximale Stille-Dauer in Sekunden (1-120)
boolean
Ob der Anruf bei Voicemail-Erkennung beendet werden soll
boolean
Ob Geräuschunterdrückung aktiviert werden soll
boolean
Ob der Anruf aufgezeichnet werden soll
string
Wer zuerst im Anruf spricht. Optionen: AI assistant, Customer

Antwort

string
Erfolgsmeldung, die die Erstellung des Assistenten bestätigt
object

Fehlerantworten

Hinweise

  • Alle Pflichtfelder müssen für eine erfolgreiche Assistentenerstellung angegeben werden
  • Der Assistent wird mit Standardeinstellungen für alle nicht angegebenen optionalen Felder erstellt
  • Die Telefonnummernzuweisung ist optional, aber die Telefonnummer muss dem authentifizierten Benutzer gehören
  • Die Webhook-URL ist nur erforderlich, wenn is_webhook_active auf true gesetzt ist
  • Stimmen- und Sprachkennungen müssen den verfügbaren Optionen im System entsprechen