> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Anrufwarteschlange ## Überblick Wenn ein Agent oder Workspace sein Parallelitätslimit erreicht, werden neue Anrufe normalerweise sofort abgewiesen. Mit aktivierter Anrufwarteschlange bleiben Anrufende, die eintreffen, während der Agent ausgelastet ist, mit Wartemusik in der Leitung und werden automatisch in der Reihenfolge ihres Eintreffens verbunden, sobald ein Platz frei wird. Die Anrufwarteschlange wird pro Agent konfiguriert und ist für neue Agenten standardmäßig aktiviert. > **Note** > > Die Anrufwarteschlange greift, sobald die gesamte verfügbare Kapazität genutzt wird, einschließlich der Burst-Kapazität, wenn für den Agenten [Burst- Preise](/docs/de/eleven-agents/guides/burst-pricing) aktiviert sind. ## So funktioniert die Anrufwarteschlange 1. **Kapazitätsprüfung**: Wenn ein Anruf eingeht, prüft ElevenAgents, ob der Agent und der Workspace einen freien Parallelitätsplatz haben. Wenn ja, wird der Anruf sofort verbunden. 2. **Warteschlange**: Ist kein Platz verfügbar, bleibt der Anrufende in der Warteschlange des Agenten und hört Wartemusik. Während der Wartezeit startet kein Gespräch und es entstehen keine Kosten. 3. **Zulassung**: Sobald ein Platz frei wird, wird der Anrufende am Anfang der Warteschlange verbunden und das Gespräch startet wie gewohnt. 4. **Zeitüberschreitung**: Wird innerhalb der **Maximalen Wartezeit in der Warteschlange** kein Platz frei, wird der Anruf getrennt. Telefonanrufe werden normal beendet. WebSocket-Clients erhalten ein `queue_status`-Ereignis mit dem Status `timed_out`, gefolgt von einer Schließung mit Code 4300. Anrufende werden für einen bestimmten Agenten strikt in der Reihenfolge ihres Eintreffens verbunden. Wenn mehrere Agenten den Parallelitätspool eines Workspaces teilen, werden Anrufende, die länger gewartet haben, in der Regel zuerst verbunden. ### Was Anrufende hören * Anrufende über Telefonnummern von Twilio und SIP-Trunks hören die Wartemusik über den Anruf. * Nutzer des Widgets und der Browser-SDKs hören die Wartemusik im Browser. Das Widget (Version 0.17.0 oder höher) zeigt außerdem eine Wartemeldung an und deaktiviert während der Wartezeit die Texteingabe. * Direkte WebSocket-API-Clients erhalten die Wartemusik als reguläre `audio`-Ereignisse sowie `queue_status`-Ereignisse, um in Ihrer eigenen UI einen Wartezustand zu steuern. Siehe [Warteschlangenereignisse verarbeiten](#handling-queue-events-in-a-custom-websocket-client). ### Abrechnung und Gesprächsdauer Die in der Warteschlange verbrachte Zeit wird **nicht berechnet**, zählt nicht zur **maximalen Gesprächsdauer** des Agenten und ist nicht in der angegebenen Gesprächsdauer enthalten. Die Gesprächsdetails im Dashboard zeigen, wie lange der Anrufende vor der Verbindung gewartet hat. ## Unterstützte Kanäle | Kanal | Anrufwarteschlange | | --------------------------------------------- | ------------------ | | Eingehende Twilio-Anrufe | Unterstützt | | Eingehende SIP-Trunk-Anrufe | Unterstützt | | Widget und Client-SDKs (WebSocket und WebRTC) | Unterstützt | | Direkte WebSocket-API | Unterstützt | | Ausgehende Anrufe und Batch-Anrufe | Nicht unterstützt | | Reine Text-Agenten | Nicht unterstützt | | Genesys, AudioCodes, Exotel, WhatsApp und SMS | Nicht unterstützt | > **Note** > > Das tägliche Anruflimit wird nicht in die Warteschlange aufgenommen. Ein Anruf, der das tägliche Limit des Agenten überschreitet, wird sofort abgewiesen, > da dieses Limit erst am nächsten Tag wieder frei wird. ## Konfiguration Die Anrufwarteschlange wird pro Agent im Abschnitt **Limits** des Tabs **Sicherheit** des Agenten konfiguriert. | Einstellung | Beschreibung | Standard | | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | | **Anrufwarteschlange aktivieren** | Anrufende in einer Warteschlange halten, wenn der Agent sein Parallelitätslimit erreicht. | Aktiv | | **Maximale Wartezeit in der Warteschlange** | Wie lange ein Anrufender warten kann, bevor der Anruf getrennt wird, in Sekunden. Zwischen 1 und 1.800 Sekunden (30 Minuten). | 180 Sekunden (3 Minuten) | | **Benutzerdefinierte Wartemusik** | Eine MP3- oder WAV-Datei, die für Anrufende in der Warteschlange in einer Schleife abgespielt wird. Bis zu 40 MB und 3 Minuten lang. Wenn keine Datei hochgeladen wird, hören Anrufende den Standard-Warteton. Laden Sie sie im Dashboard oder über die API hoch. | Standard-Warteton | #### Über das Dashboard aktualisieren #### Limit-Einstellungen öffnen Öffnen Sie Ihren Agenten im Dashboard, wechseln Sie zum Tab **Sicherheit** und scrollen Sie zu **Limits**. #### Anrufwarteschlange aktivieren Stellen Sie sicher, dass **Anrufwarteschlange aktivieren** eingeschaltet ist, und legen Sie die **maximale Wartezeit in der Warteschlange** fest. #### Wartemusik hochladen (optional) Laden Sie unter **Benutzerdefinierte Wartemusik** eine MP3- oder WAV-Datei hoch. Sie können den Standard-Warteton und Ihren hochgeladenen Clip vor der Veröffentlichung in der Vorschau anhören. #### Änderungen veröffentlichen Klicken Sie auf **Veröffentlichen**, um die neuen Einstellungen zu übernehmen. #### Über die CLI aktualisieren #### Agentenkonfiguration abrufen ```bash elevenlabs agents pull --agent "" ``` #### \`agent_configs/\.json\` bearbeiten Legen Sie `platform_settings.queueing_config` fest: ```json { "platform_settings": { "queueing_config": { "enabled": true, "wait_timeout_seconds": 300 } } } ``` #### Änderungen übertragen ```bash elevenlabs agents push --agent "" ``` #### Über die API aktualisieren ```python from dotenv import load_dotenv from elevenlabs import ElevenLabs import os load_dotenv() elevenlabs = ElevenLabs( api_key=os.getenv("ELEVENLABS_API_KEY"), ) elevenlabs.conversational_ai.agents.update( agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6", platform_settings={ "queueing_config": { "enabled": True, "wait_timeout_seconds": 300, }, }, ) ``` ```typescript import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js"; import "dotenv/config"; const elevenlabs = new ElevenLabsClient(); await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", { platformSettings: { queueingConfig: { enabled: true, waitTimeoutSeconds: 300, }, }, }); ``` Neue Agenten werden mit `queueing_config.enabled` auf `true` gesetzt erstellt. Um einen Agenten mit deaktivierter Anrufwarteschlange zu erstellen, setzen Sie `queueing_config.enabled` in der Erstellungsanfrage auf `false`. ### Wartemusik über die API verwalten Laden Sie eine MP3- oder WAV-Datei hoch, um die benutzerdefinierte Wartemusik des Agenten festzulegen. Das Hochladen einer neuen Datei ersetzt die vorherige. Die API akzeptiert die Content-Typen `audio/mpeg` und `audio/wav`, daher legen die Beispiele den Typ explizit fest. ```python from dotenv import load_dotenv from elevenlabs import ElevenLabs import os load_dotenv() elevenlabs = ElevenLabs( api_key=os.getenv("ELEVENLABS_API_KEY"), ) elevenlabs.conversational_ai.agents.hold_audio.create( agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6", hold_audio_file=("hold-music.mp3", open("hold-music.mp3", "rb"), "audio/mpeg"), ) ``` ```typescript import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js"; import fs from "node:fs"; import "dotenv/config"; const elevenlabs = new ElevenLabsClient(); const holdAudioFile = new File([fs.readFileSync("hold-music.mp3")], "hold-music.mp3", { type: "audio/mpeg", }); await elevenlabs.conversationalAi.agents.holdAudio.create("agent_7101k5zvyjhmfg983brhmhkd98n6", { holdAudioFile, }); ``` Entfernen Sie den benutzerdefinierten Clip, um zum Standard-Warteton zurückzukehren: ```python elevenlabs.conversational_ai.agents.hold_audio.delete( agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6", ) ``` ```typescript await elevenlabs.conversationalAi.agents.holdAudio.delete("agent_7101k5zvyjhmfg983brhmhkd98n6"); ``` Der aktuelle Clip wird schreibgeschützt als `platform_settings.queueing_config.hold_audio` für den Agenten zurückgegeben. Das Senden von `hold_audio` in einer Anfrage zum Erstellen oder Aktualisieren eines Agenten hat keine Wirkung. ## Warteschlangenereignisse in einem benutzerdefinierten WebSocket-Client verarbeiten Clients, die über die [WebSocket-API](/docs/de/eleven-agents/libraries/web-sockets) verbunden sind, erhalten während der Wartezeit `queue_status`-Ereignisse: ```json { "type": "queue_status", "queue_status_event": { "status": "waiting" } } ``` * `waiting` wird einmal gesendet, unmittelbar nach `conversation_initiation_metadata` und vor jeder Wartemusik. * `admitted` wird gesendet, wenn der Anrufende verbunden wird. Das Gespräch wird dann wie gewohnt fortgesetzt. * `timed_out` wird gesendet, wenn die Wartezeit die maximale Wartezeit in der Warteschlange überschreitet. Der Server schließt die Verbindung anschließend mit Code 4300. Anrufe, die sofort verbunden werden, erhalten nie `queue_status`-Ereignisse. Das Ereignis wird immer an Anrufende in der Warteschlange gesendet und muss nicht in den `client_events` des Agenten aktiviert werden. Wartemusik wird als reguläre `audio`-Ereignisse in Abschnitten von ungefähr einer Sekunde bereitgestellt, sofern die Client-Ereignisse des Agenten `audio` enthalten. Verwenden Sie `queue_status`, um einen Wartezustand anzuzeigen, statt die Wartemusik als Agentensprache zu behandeln. > **Info** > > Die SDKs `@elevenlabs/client` und `@elevenlabs/react` bieten noch keinen eigenen Callback für dieses > Ereignis. Verwenden Sie den Callback `onIncomingEvent`, um rohe Serverereignisse zu beobachten, einschließlich > `queue_status`. ## FAQ #### Zählt ein Anruf in der Warteschlange zu meinem Parallelitätslimit? Nein. Ein Anrufender in der Warteschlange belegt keinen Parallelitätsplatz, bis er mit dem Agenten verbunden wird. #### Können Anrufende ihre Position in der Warteschlange oder eine geschätzte Wartezeit hören? Derzeit nicht. Anrufende in der Warteschlange hören nur die Wartemusik. Positionen in der Warteschlange und Wartezeitschätzungen werden nicht angesagt. #### Was passiert, wenn der Anrufende während der Wartezeit auflegt? Der Anrufende verlässt die Warteschlange sofort und alle dahinter rücken einen Platz vor. Es werden keine Gesprächsminuten berechnet. #### Funktioniert die Anrufwarteschlange mit ausgehenden Anrufen? Nein. Ausgehende Anrufe und Batch-Anrufe werden nur getätigt, wenn Kapazität verfügbar ist. Sie werden daher nie in die Warteschlange aufgenommen.