Assistenten aktualisieren
Assistenten aktualisieren
Die Konfiguration eines bestehenden KI-Assistenten aktualisieren
PUT
Assistenten aktualisieren
Dieser Endpunkt ermöglicht es dir, die Konfiguration eines bestehenden KI-Assistenten zu aktualisieren. Alle Felder sind optional – es werden nur die angegebenen Felder aktualisiert. Für ausführliche Feldbeschreibungen und Optionen siehe Assistent erstellen.
Path Parameter
integer
erforderlich
Die eindeutige Kennung des zu aktualisierenden Assistenten
Request Body
Kernfelder
string
Der Name des Assistenten (max. 255 Zeichen)
integer
Die zu verwendende Stimmen-ID für den Assistenten. Verwende den Endpunkt Stimmen abrufen mit dem Parameter
mode, um kompatible Stimmen für deinen Engine-Modus zu erhalten.integer
Die Sprach-ID für den Assistenten. Verwende den Endpunkt Sprachen abrufen, um verfügbare Sprachen zu erhalten.
string
Der Assistenten-Typ. Optionen:
inbound, outboundstring
Der Engine-Modus. Optionen:
pipeline, multimodal, dualplexstring
Die Zeitzone für den Assistenten (z. B. “Europe/Berlin”, “America/New_York”)
string
Die erste Nachricht, die der Assistent beim Anrufstart sprechen wird (max. 200 Zeichen)
string
Der System-Prompt, der das Verhalten und die Persönlichkeit des Assistenten definiert
Modusspezifische Felder
integer
Die zu verwendende LLM-Modell-ID. Gilt nur für den Modus
pipeline.Verwende den Endpunkt Modelle abrufen, um verfügbare Modelle zu erhalten.integer
Die multimodale Modell-ID. Gilt nur für die Modi
multimodal und dualplex.Verwende den Endpunkt Modelle abrufen, um verfügbare multimodale Modelle zu erhalten.integer
Fallback-LLM-Modell-ID für Tool-Aufrufe in den Modi multimodal/dualplex. Auf
null setzen zum Entfernen.number
Empfindlichkeit der Sprecherwechselerkennung für multimodal/dualplex Modi (0-1). Auf
null setzen für Automatik.Sekundärsprachen
integer[]
Array mit zusätzlichen Sprach-IDs, die der Assistent sprechen kann. Ersetzt bestehende Sekundärsprachen. Übergib ein leeres Array
[], um alle Sekundärsprachen zu entfernen.Knowledgebase-Einstellungen
integer
Die ID der zu verknüpfenden Knowledgebase. Auf
null setzen zum Entfernen.string
Wie die Knowledgebase verwendet werden soll. Optionen:
function_call- KI ruft eine Funktion zur Suche auf (erforderlich für multimodal/dualplex)prompt- Wissen wird in den Prompt injiziert (nur pipeline)
Organisation
integer
ID eines Ordners, in den dieser Assistent verschoben werden soll. Muss zu deinem Konto gehören. Auf
null setzen, um ihn unkategorisiert zu machen. Weglassen, um den Ordner unverändert zu lassen.integer[]
Array von Label-IDs für diesen Assistenten. Jedes Label muss zu deinem Konto gehören. Wenn angegeben, ersetzt dies die aktuellen Labels des Assistenten. Weglassen, um Labels unverändert zu lassen;
[] senden, um alle Labels zu entfernen.Telefonnummer
integer
Die ID einer zuzuweisenden Telefonnummer. Auf
null setzen zum Aufheben der Zuweisung. Muss zu deinem Konto gehören.Benutzerdefinierte Mid-Call Tools
integer[]
Array von benutzerdefinierten Mid-Call Tool-IDs zur Synchronisierung. Ersetzt alle bestehenden Tool-Zuweisungen. Übergib ein leeres Array
[], um alle Tools zu entfernen. Jedes Tool muss zu deinem Konto gehören.Integrierte Tools
array
Array von integrierten Tools. Ersetzt alle bestehenden integrierten Tools. Übergib ein leeres Array
[], um alle Tools zu entfernen.In der Assistenten-Liste wird jedes konfigurierte Tool als
{ "type": "...", "data": { ... } } zurückgegeben — dieselben Feldnamen wie im Request, aber unter data verschachtelt (nicht top-level).Sprach- und TTS-Einstellungen
boolean
Ob emotionale Text-to-Speech-Synthese aktiviert werden soll
number
Stimm-Stabilität-Einstellung (0-1). Höher = konsistentere Stimme
number
Stimm-Ähnlichkeit-Einstellung (0-1). Höher = näher an der Originalstimme
number
Sprechgeschwindigkeits-Multiplikator (0.7-1.2)
number
LLM-Temperatur-Einstellung (0-1). Niedriger = deterministischer
integer
Benutzerdefinierte TTS-Provider-ID. Auf
null setzen, um den Sprachstandard zu verwenden. Siehe Synthesizer-Provider abrufen.integer
Benutzerdefinierte STT-Provider-ID. Nur Pipeline-Modus. Auf
null setzen, um den Sprachstandard zu verwenden. Siehe Transcriber-Provider abrufen.Anrufverhalten-Einstellungen
boolean
Ob Unterbrechungen durch den Anrufer erlaubt werden sollen.
boolean
Ob Füller-Audio während der Verarbeitung verwendet werden soll.
object
Benutzerdefinierte Füller-Profile pro Kategorie. Ersetzt die bestehende Füller-Konfiguration. Jede Kategorie ist ein Array kurzer Phrasen.
positive: Füller für zustimmende Antwortennegative: Füller für ablehnende/neutrale Antwortenquestion: Füller beim Verarbeiten einer Frageneutral: Füller für neutrale Bestätigungen
boolean
Ob der Anruf aufgezeichnet werden soll
boolean
Ob Geräuschunterdrückung aktiviert werden soll
boolean
Wenn wahr, wartet der Assistent darauf, dass der Kunde zuerst spricht
Timing-Einstellungen
integer
Maximale Anrufdauer in Sekunden (20-1200)
integer
Maximale Dauer der Stille vor erneutem Engagement in Sekunden (1-360)
integer
Maximale Stille zu Beginn des Anrufs vor dem Beenden (1-120 Sekunden). Auf
null setzen zum Deaktivieren.integer
Maximale Klingelzeit vor dem Abbruch (1-60 Sekunden)
Re-Engagement-Einstellungen
integer
Intervall für erneutes Engagement in Sekunden (7-600)
string
Benutzerdefinierter Prompt für Re-Engagement-Nachrichten (max. 1000 Zeichen). Auf
null setzen, um den Standard zu verwenden.Voicemail-Einstellungen
boolean
Ob der Anruf beendet werden soll, wenn eine Mailbox erkannt wird
string
Nachricht, die auf der Mailbox hinterlassen werden soll, bevor aufgelegt wird (max. 1000 Zeichen). Auf
null setzen zum Deaktivieren.Endpunkterkennung
string
Typ der Sprachaktivitätserkennung. Optionen:
vad, ainumber
Endpunkt-Sensibilitätslevel (0-5)
number
Unterbrechungs-Sensibilitätslevel (0-5)
integer
Mindestanzahl an Wörtern, bevor eine Unterbrechung zulässig ist (0-10). Auf
null setzen zum Deaktivieren.Ambiente-Sound
string
Hintergrund-Ambiente-Sound. Optionen:
off, office, city, forest, crowded_room, cafe, naturenumber
Lautstärke des Ambiente-Sounds (0-1)
Webhook-Konfiguration
boolean
Ob Webhook-Benachrichtigungen aktiviert sind
string
Die Webhook-URL für Post-Call-Benachrichtigungen. Auf
null setzen zum Entfernen.boolean
Ob Webhooks nur bei erfolgreich abgeschlossenen Anrufen gesendet werden sollen (nicht bei fehlgeschlagenen/keine-Antwort)
boolean
Ob die Aufzeichnungs-URL in der Webhook-Payload enthalten sein soll
Post-Call-Evaluation
boolean
Ob die KI-basierte Post-Call-Evaluation aktiviert werden soll
array
Schema-Definition für die Extraktion von Post-Call-Daten. Ersetzt das bestehende Schema.
Variablen
object
Schlüssel-Wert-Paare für benutzerdefinierte Variablen. Ersetzt alle bestehenden Variablen.
Beispiel-Requests
Grundlegende Einstellungen aktualisieren
In multimodalen Modus wechseln
Tools und Knowledgebase aktualisieren
Re-Engagement und Voicemail aktualisieren
Optionale Einstellungen entfernen
Antwort
string
Erfolgsmeldung zur Bestätigung der Assistenten-Aktualisierung
object
Hinweise
- Nur die Felder, die du im Request Body angibst, werden aktualisiert
- Um optionale Felder zu entfernen, setze diese explizit auf
null - Um Arrays zu leeren (Tools, Sekundärsprachen), übergib ein leeres Array
[] - Der Assistent muss dem authentifizierten Benutzer gehören
- Verwende den Endpunkt Stimmen abrufen mit dem Parameter
mode, um kompatible Stimmen zu erhalten - Für multimodal/dualplex Modi muss
knowledgebase_modeauffunction_callgesetzt sein - In den Modi multimodal/dualplex können Unterbrechungen (
allow_interruptions) nicht deaktiviert werden - Ein Moduswechsel setzt modusspezifische Einstellungen (LLM-Modell, multimodales Modell, Provider) zurück

