Skip to main content
PUT
Assistenten aktualisieren
Dieser Endpunkt ermöglicht es Ihnen, die Konfiguration eines vorhandenen KI-Assistenten zu aktualisieren. Alle Felder sind optional - geben Sie nur die Felder an, die Sie aktualisieren möchten.

Pfad-Parameter

integer
erforderlich
Die eindeutige Kennung des zu aktualisierenden Assistenten

Anfragekörper

Hauptfelder

string
Der Name des Assistenten (max. 255 Zeichen)
integer
Die Stimmen-ID, die für den Assistenten verwendet werden soll (muss in den verfügbaren Stimmen vorhanden sein)
string
Der Sprachname für den Assistenten (max. 100 Zeichen)
string
Der zu verwendende LLM-Modellname (max. 100 Zeichen)
string
Der Anrufrichtungstyp. Optionen: receive, make
string
Der zu verwendende Engine-Typ. Optionen: pipeline, multimodal
string
Die Zeitzone für den Assistenten (z. B. “America/New_York”)
string
Die erste Nachricht, die der Assistent beim Start des Anrufs sprechen wird
string
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 (auf null setzen, um die Zuweisung aufzuheben)
integer[]
Array von Mid-Call-Tool-IDs, die mit dem Assistenten synchronisiert werden sollen. Ersetzt alle vorhandenen Tool-Zuweisungen. Übergeben Sie ein leeres Array, um alle Tools zu entfernen. 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 (kann auf null gesetzt werden, um sie zu entfernen)

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 Aktualisierung des Assistenten bestätigt
object

Fehlerantworten

Hinweise

  • Nur die Felder, die Sie im Anfragekörper angeben, werden aktualisiert
  • Alle Validierungsregeln gelten genauso wie beim Erstellen eines Assistenten
  • Um eine Telefonnummernzuweisung zu entfernen, setzen Sie phone_number_id auf null
  • Um den Webhook zu deaktivieren, setzen Sie webhook_url auf null oder is_webhook_active auf false
  • Der Assistent muss dem authentifizierten Benutzer gehören, um aktualisiert werden zu können