> 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. # Samtalskö ## Översikt När en agent eller arbetsyta når sin samtidighetsgräns avvisas nya samtal normalt direkt. När samtalskö är aktiverat hålls uppringare som ringer medan agenten har full kapacitet kvar i samtalet med vänteljud och kopplas automatiskt, i den ordning de kom, så snart en plats blir ledig. Samtalskö konfigureras per agent och är aktiverat som standard för nya agenter. > **Note** > > Samtalskö tillämpas när all tillgänglig kapacitet används, inklusive extrakapacitet när [prissättning för extrakapacitet](/docs/sv/eleven-agents/guides/burst-pricing) är aktiverad för agenten. ## Så fungerar samtalskö 1. **Kapacitetskontroll**: När ett samtal kommer kontrollerar ElevenAgents om agenten och arbetsytan har en ledig samtidighetsplats. Om de har det kopplas samtalet direkt. 2. **Köplacering**: Om ingen plats är tillgänglig placeras uppringaren i agentens kö och hör vänteljud. Ingen konversation startar och inget debiteras medan uppringaren väntar. 3. **Insläpp**: Så snart en plats blir ledig kopplas uppringaren längst fram i kön och konversationen startar som vanligt. 4. **Tidsgräns**: Om ingen plats blir ledig inom **Maximal väntetid i kö** kopplas samtalet ner. Telefonsamtal avslutas normalt. WebSocket-klienter får en `queue_status`-händelse med statusen `timed_out`, följt av en stängning med kod 4300. Uppringare kopplas i strikt ankomstordning för en viss agent. När flera agenter delar en arbetsytas samtidighetspool kopplas uppringare som har väntat längre i allmänhet först. ### Vad uppringaren hör * Telefonuppringare på Twilio- och SIP trunk-nummer hör vänteljudet i samtalet. * Användare av widgeten och webbläsar-SDK:er hör vänteljudet i webbläsaren. Widgeten (version 0.17.0 eller senare) visar även ett väntemeddelande och inaktiverar textinmatning medan användaren står i kö. * Direktanslutna WebSocket API-klienter får vänteljudet som vanliga `audio`-händelser, samt `queue_status`-händelser för att styra ett vänteläge i ditt eget gränssnitt. Se [Hantera köhändelser](#handling-queue-events-in-a-custom-websocket-client). ### Fakturering och konversationslängd Tid i kön **debiteras inte**, räknas inte mot agentens **Maximala konversationslängd** och inkluderas inte i konversationens rapporterade längd. Konversationsinformationen i dashboarden visar hur länge uppringaren väntade innan den kopplades. ## Kanaler som stöds | Kanal | Samtalskö | | ----------------------------------------------- | ---------- | | Inkommande Twilio-samtal | Stöds | | Inkommande SIP trunk-samtal | Stöds | | Widget och klient-SDK:er (WebSocket och WebRTC) | Stöds | | Direkt WebSocket API | Stöds | | Utgående samtal och batchsamtal | Stöds inte | | Endast text-agenter | Stöds inte | | Genesys, AudioCodes, Exotel, WhatsApp och SMS | Stöds inte | > **Note** > > Den dagliga samtalsgränsen köas inte. Ett samtal som överskrider agentens dagliga gräns avvisas > direkt, eftersom den gränsen inte frigörs förrän nästa dag. ## Konfiguration Samtalskö konfigureras per agent i avsnittet **Gränser** på agentens flik **Säkerhet**. | Inställning | Beskrivning | Standard | | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- | | **Aktivera samtalskö** | Placera uppringare i kö när agenten har nått sin samtidighetsgräns. | På | | **Maximal väntetid i kö** | Hur länge en uppringare kan vänta innan samtalet kopplas ner, i sekunder. Mellan 1 och 1 800 sekunder (30 minuter). | 180 sekunder (3 minuter) | | **Anpassat vänteljud** | En MP3- eller WAV-fil som spelas upp i loop för uppringare i kö. Upp till 40 MB och 3 minuter lång. När ingen fil har laddats upp hör uppringare standardtonen för vänteläge. Ladda upp den i dashboarden eller via API:et. | Standardton för vänteläge | #### Uppdatera via dashboarden #### Öppna inställningarna för gränser Öppna din agent i dashboarden, gå till fliken **Säkerhet** och rulla till **Gränser**. #### Aktivera samtalskö Kontrollera att **Aktivera samtalskö** är på och ställ in **Maximal väntetid i kö**. #### Ladda upp vänteljud (valfritt) Under **Anpassat vänteljud** laddar du upp en MP3- eller WAV-fil. Du kan förhandsgranska standardtonen för vänteläge och ditt uppladdade klipp innan du publicerar. #### Publicera dina ändringar Klicka på **Publicera** för att tillämpa de nya inställningarna. #### Uppdatera via CLI #### Hämta agentkonfigurationen ```bash elevenlabs agents pull --agent "" ``` #### Redigera \`agent\_configs/\.json\` Ange `platform_settings.queueing_config`: ```json { "platform_settings": { "queueing_config": { "enabled": true, "wait_timeout_seconds": 300 } } } ``` #### Skicka dina ändringar ```bash elevenlabs agents push --agent "" ``` #### Uppdatera via API:et ```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, }, }, }); ``` Nya agenter skapas med `queueing_config.enabled` inställt på `true`. Om du vill skapa en agent med samtalskö avstängd ställer du in `queueing_config.enabled` på `false` i skapa-begäran. ### Hantera vänteljud via API:et Ladda upp en MP3- eller WAV-fil för att ange agentens anpassade vänteljud. Om du laddar upp en ny fil ersätts den tidigare. API:et accepterar innehållstyperna `audio/mpeg` och `audio/wav`, så exemplen anger typen uttryckligen. ```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, }); ``` Ta bort det anpassade klippet för att återgå till standardtonen för vänteläge: ```python elevenlabs.conversational_ai.agents.hold_audio.delete( agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6", ) ``` ```typescript await elevenlabs.conversationalAi.agents.holdAudio.delete("agent_7101k5zvyjhmfg983brhmhkd98n6"); ``` Det aktuella klippet returneras skrivskyddat som `platform_settings.queueing_config.hold_audio` på agenten. Att skicka `hold_audio` i en begäran om att skapa eller uppdatera en agent har ingen effekt. ## Hantera köhändelser i en anpassad WebSocket-klient Klienter som ansluts via [WebSocket API](/docs/sv/eleven-agents/libraries/web-sockets) får `queue_status`-händelser medan de står i kö: ```json { "type": "queue_status", "queue_status_event": { "status": "waiting" } } ``` * `waiting` skickas en gång, direkt efter `conversation_initiation_metadata` och före allt vänteljud. * `admitted` skickas när uppringaren ansluts. Konversationen fortsätter sedan som vanligt. * `timed_out` skickas när väntan överskrider den maximala väntetiden i kön. Servern stänger sedan anslutningen med kod 4300. Samtal som ansluts direkt får aldrig `queue_status`-händelser. Händelsen skickas alltid till uppringare i kö och behöver inte aktiveras i agentens `client_events`. Vänteljud levereras som vanliga `audio`-händelser i delar på ungefär en sekund, förutsatt att agentens klienthändelser inkluderar `audio`. Använd `queue_status` för att visa ett vänteläge i stället för att behandla vänteljudet som agents tal. > **Info** > > SDK:erna `@elevenlabs/client` och `@elevenlabs/react` har ännu ingen särskild callback för den här > händelsen. Använd callbacken `onIncomingEvent` för att observera råa serverhändelser, inklusive > `queue_status`. ## Vanliga frågor #### Räknas ett samtal i kö mot min samtidighetsgräns? Nej. En uppringare i kö upptar inte en samtidighetsplats förrän den ansluts till agenten. #### Kan uppringare höra sin plats i kön eller en uppskattad väntetid? Inte för närvarande. Uppringare i kö hör endast vänteljudet. Köplats och uppskattad väntetid meddelas inte. #### Vad händer om uppringaren lägger på medan den väntar? Uppringaren lämnar kön direkt och alla bakom flyttas upp en plats. Inga konversationsminuter debiteras. #### Fungerar samtalskö med utgående samtal? Nej. Utgående samtal och batchsamtal rings endast upp när kapacitet är tillgänglig, så de placeras aldrig i kö.