Die Voice-ID für den Assistenten. Verwenden Sie den Endpunkt Stimmen abrufen mit dem Query-Parameter mode, um kompatible Stimmen für Ihren Engine-Modus zu erhalten.
Die Multimodal-Model-ID. Erforderlich für die Modi multimodal und dualplex.Verwenden Sie den Endpunkt Modelle abrufen, um verfügbare Multimodal-Modelle zu erhalten.
Array integrierter Tools. Jedes Tool hat ein type-Feld und tool-spezifische Felder. Bei Assistent aktualisierenersetzt dies 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).
Benutzerdefinierte Füller-Profile pro Kategorie. Wenn nicht angegeben, werden sprachabhängige Standardwerte verwendet. Jede Kategorie ist ein Array kurzer Phrasen.
positive: Füller für zustimmende Antworten (z.B. “Super!”, “Perfekt!”)
negative: Füller für ablehnende/neutrale Antworten (z.B. “Hmm.”, “Mhm.”)
question: Füller beim Verarbeiten einer Frage (z.B. “Hmm.”, “Einen Moment.”)
neutral: Füller für neutrale Bestätigungen (z.B. “Ok.”, “Verstanden.”)
{ "name": "Sales Assistant", "voice_id": 1, "language_id": 1, "type": "outbound", "mode": "pipeline", "timezone": "Europe/Berlin", "initial_message": "Hallo! Wie kann ich Ihnen heute helfen?", "system_prompt": "Du bist ein professioneller Sales Assistant...", "llm_model_id": 2, "secondary_language_ids": [2, 3], "knowledgebase_id": 1, "knowledgebase_mode": "prompt", "fillers": true, "filler_config": { "positive": ["Super!", "Perfekt!", "Sehr gut!"], "negative": ["Hmm.", "Verstehe."], "question": ["Gute Frage.", "Einen Moment."], "neutral": ["Ok.", "Notiert.", "Verstanden."] }, "tool_ids": [1, 5], "tools": [ {"type": "dtmf_input", "description": "IVR bei Bedarf navigieren"}, { "type": "warm_call_transfer", "supervisor_phone": "+1234567891", "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 der Kunde zufrieden ist"} ], "reengagement_interval": 20, "reengagement_prompt": "Sind Sie noch dran?"}
