Skip to main content
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, outbound
string
Der Engine-Modus. Optionen: pipeline, multimodal, dualplex
Das Ändern des Modus setzt modusspezifische Einstellungen auf die Standardwerte für den neuen Modus zurück.
string
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.
Für inbound Assistenten kann die Telefonnummer kein Caller-ID-Typ sein und darf nicht bereits einem anderen Inbound-Assistenten zugewiesen sein.

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.
Kann für die Modi multimodal und dualplex nicht deaktiviert werden.
boolean
Ob Füller-Audio während der Verarbeitung verwendet werden soll.
Nur für den Modus pipeline verfügbar.
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 Antworten
  • negative: Füller für ablehnende/neutrale Antworten
  • question: Füller beim Verarbeiten einer Frage
  • neutral: 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, ai
number
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, nature
number
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_mode auf function_call gesetzt 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