Dieser Endpunkt ermöglicht es Ihnen, 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.
Die zu verwendende Stimmen-ID für den Assistenten. Verwenden Sie den Endpunkt Stimmen abrufen mit dem Parameter mode, um kompatible Stimmen für Ihren Engine-Modus zu erhalten.
Die multimodale Modell-ID. Gilt nur für die Modi multimodal und dualplex.Verwenden Sie den Endpunkt Modelle abrufen, um verfügbare multimodale Modelle zu erhalten.
Array mit zusätzlichen Sprach-IDs, die der Assistent sprechen kann. Ersetzt bestehende Sekundärsprachen. Übergeben Sie ein leeres Array [], um alle Sekundärsprachen zu entfernen.
Array von benutzerdefinierten Mid-Call Tool-IDs zur Synchronisierung. Ersetzt alle bestehenden Tool-Zuweisungen. Übergeben Sie ein leeres Array [], um alle Tools zu entfernen. Jedes Tool muss zu Ihrem Konto gehören.
Array von integrierten Tools. Ersetzt alle bestehenden integrierten Tools. Übergeben Sie ein leeres Array [], um alle Tools zu entfernen.
Anzeigen Tool-Typen
call_transfer - Den Anruf an eine andere Telefonnummer weiterleiten
phone_number (erforderlich): Telefonnummer für die Weiterleitung
description: Wann der Anruf weitergeleitet werden soll
custom: Wenn true, kann die KI die Weiterleitungsnummer dynamisch bestimmen
timezone: Zeitzone für die Erreichbarkeit der Weiterleitung
warm_transfer: Nachricht an den Kunden vor der Weiterleitung senden (Standard: false)
warm_transfer_message: Prompt, was die KI vor der Weiterleitung sagen soll (z. B. „Sagen Sie dem Kunden, dass der Anruf weitergeleitet wird.“)
warm_call_transfer - Warm-Transfer mit Supervisor-Briefing
supervisor_phone (erforderlich): Telefonnummer für den Warm-Transfer (z. B. „+14155552001“). Bei aktiviertem custom_sip stattdessen SIP-Adresse oder interne Durchwahl.
outbound_phone_id (erforderlich): ID der Telefonnummer, mit der der Supervisor angerufen wird. Siehe Telefonnummern abrufen.
description (erforderlich): Wann transferieren — beschreibt, wann die KI den Warm-Transfer auslösen soll (z. B. „An einen menschlichen Supervisor weiterleiten, wenn der Kunde mit einer echten Person sprechen möchte.“)
custom_sip: Eigene SIP-Adresse oder interne Durchwahl statt Telefonnummer (Standard: false)
caller_id_mode: Welche Nummer der Supervisor beim Anruf sieht. Optionen: outbound_number (Standard — Outbound-Nummer), customer_number (Anrufernummer), custom (eigene Nummer)
custom_caller_id: Eigene Nummer für den Supervisor. Nur bei caller_id_mode: custom.
hold_music: Audio während des Wartens. Optionen: hold_music (Standard — Standard-Wartemusik), none (Stille)
hold_music_volume: Lautstärke der Wartemusik, 0–100 (Standard: 80)
hold_message: Ansage an den Anrufer vor dem Halten (Standard: „Bitte warten Sie, während ich Sie mit einem Supervisor verbinde.“)
summary_instructions: Anweisung, wie die KI den Supervisor briefen soll (Standard: „Stellen Sie das Gespräch aus Ihrer Sicht vor:\n- WER ruft an (Name, Firma falls erwähnt)\n- WARUM sie angerufen haben (Ziel oder Problem)\n- WARUM jetzt ein Mensch nötig ist\n\nHalten Sie es kurz (2-3 Sätze).“)
briefing_initial_message: Erste Nachricht der KI an den Supervisor (Standard: „Hallo! Ich habe einen Anrufer in der Leitung, der Ihre Hilfe braucht. Darf ich Sie kurz einweisen?“)
connected_message: Ansage an den Anrufer nach Verbindung mit dem Supervisor (Standard: „Sie sind jetzt mit einem Supervisor verbunden. Ich überlasse Sie ihm.“)
end_call - Den Anruf programmgesteuert beenden
description: Wann die KI den Anruf beenden soll
dtmf_input - DTMF-Töne senden (Tastatureingabe)
description: Wann DTMF-Eingabe verwendet werden soll (z. B. IVR-Navigation)
collect_keypad - Tastatureingabe vom Anrufer erfassen
timeout: Sekunden bis zur Eingabe, 1–30 (Standard: 5)
stop_key: Taste zum Beenden. Optionen: # (Standard), *
calendar_integration - Termine über Cal.com planen
calcom_api_key (erforderlich): Ihr Cal.com API-Schlüssel
calcom_event_slug (erforderlich): Event-Typ-Slug von Cal.com
calcom_team_slug: Team-Slug, wenn der Event zu einem Cal.com-Team gehört
calcom_endpoint: Cal.com API-Region. Optionen: us (Standard — https://api.cal.com), eu (https://api.cal.eu), custom (nutzt calcom_custom_endpoint)
calcom_custom_endpoint: Eigene Cal.com API-Basis-URL. Nur bei calcom_endpoint: custom (z. B. https://my-calcom-instance.com).
calcom_booking_fields: Array benutzerdefinierter Buchungsfelder. Pro Feld: slug (erforderlich), type (erforderlich, z. B. „text“, „email“, „phone“, „select“), label (erforderlich), required (Standard: false), options (Optionen für Select-Felder)
description: Wann Terminbuchung angeboten werden soll
assistant_transfer - Gespräch während des Anrufs an einen anderen KI-Assistenten übergeben (tauscht Stimme, LLM und STT zum Ziel-Assistenten)
assistant_id (erforderlich): ID des Ziel-Assistenten. Muss zu Ihrem Konto gehören und darf nicht der aktualisierte Assistent selbst sein (kein Self-Transfer).
description: Wann transferiert werden soll (max. 500 Zeichen, Standard: „Übergeben Sie das Gespräch an diesen Assistenten, wenn es passend ist.“)
message_before_transfer: Optionale Nachricht, die die KI vor dem Wechsel spricht (max. 500 Zeichen).
speak_transfer_greeting: Wenn true, spricht der Ziel-Assistent nach dem Transfer seine konfigurierte Erstnachricht (Standard: true)
"tools": [ { "type": "dtmf_input", "description": "IVR bei Bedarf navigieren" }, { "type": "warm_call_transfer", "supervisor_phone": "+1234567890", "outbound_phone_id": 7, "description": "An einen menschlichen Supervisor weiterleiten, wenn der Kunde mit einer echten Person sprechen möchte.", "custom_sip": false, "caller_id_mode": "outbound_number", "hold_music": "hold_music", "hold_music_volume": 80, "hold_message": "Bitte warten Sie, während ich Sie mit einem Supervisor verbinde.", "summary_instructions": "Stellen Sie das Gespräch aus Ihrer Sicht vor:\n- WER ruft an (Name, Firma falls erwähnt)\n- WARUM sie angerufen haben (Ziel oder Problem)\n- WARUM jetzt ein Mensch nötig ist\n\nHalten Sie es kurz (2-3 Sätze).", "briefing_initial_message": "Hallo! Ich habe einen Anrufer in der Leitung, der Ihre Hilfe braucht. Darf ich Sie kurz einweisen?", "connected_message": "Sie sind jetzt mit einem Supervisor verbunden. Ich überlasse Sie ihm." }, { "type": "collect_keypad", "timeout": 5, "stop_key": "#" }, { "type": "assistant_transfer", "assistant_id": 14765, "description": "An den Support-Assistenten übergeben, wenn der Kunde technische Hilfe braucht.", "message_before_transfer": "Gerne — ich verbinde Sie mit unserem Support-Spezialisten.", "speak_transfer_greeting": true }, { "type": "end_call", "description": "Anruf beenden wenn fertig" }]
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).
{ "reengagement_interval": 15, "reengagement_prompt": "Sind Sie noch da? Ich bin hier, um zu helfen.", "end_call_on_voicemail": true, "voice_mail_message": "Hallo, bitte rufen Sie uns bei Gelegenheit zurück."}
