Genesys
Integrera ElevenLabs Agents med Genesys med den inbyggda Audio Connector-integrationen.
Översikt
Den här guiden förklarar hur du integrerar ElevenLabs Agents med Genesys Cloud via Audio Connector-integrationen. Integrationen ger smidiga AI-röstfunktioner i din befintliga Genesys-kontaktcenterinfrastruktur via WebSocket, utan att SIP-trunkning krävs.
Så fungerar Genesys-integrationen
Genesys-integrationen använder en inbyggd WebSocket-anslutning via Audio Connector-integrationen:
- WebSocket-anslutning: Direktanslutning till ElevenLabs via Audio Connector-integrationen i Genesys Cloud
- Ljud i realtid: Dubbelriktad ljudstreaming mellan Genesys och ElevenLabs-agenter
- Flödesintegration: Smidig integration i dina Genesys Architect-flöden med botåtgärder
- Dynamiska variabler: Stöd för att överföra kontext och data mellan Genesys och ElevenLabs
Krav
Innan du konfigurerar Genesys-integrationen behöver du ha:
- En Genesys Cloud CX-licens med stöd för botflöden
- Administratörsåtkomst till Genesys Cloud-organisationen
- Ett konfigurerat ElevenLabs-konto och en ElevenLabs-agent
- En ElevenLabs API-nyckel
Konfigurera Audio Connector-integrationen
Skapa en Audio Connector-integration
-
Klicka på “Add Integration”, sök efter “Audio Connector” och klicka på “Install”
-
Välj integrationstypen Audio Connector
-
Ange ett beskrivande namn för integrationen
Konfigurera autentisering
-
Gå till avsnittet Configuration i din Audio Connector-integration
-
Under Properties anger du rätt URL för din miljö i fältet Base Connection URI:
Om ditt ElevenLabs-konto finns i en isolerad residensmiljö ersätter du
<region>med din regionkod. Fel URL leder till autentiseringsfel. Se dataresidens för en lista över tillgängliga regioner och deras URL:er. -
Under Credentials anger du din ElevenLabs API-nyckel i autentiseringskonfigurationen
-
Spara integrationskonfigurationen
Konfigurera ditt Genesys-flöde
Skapa eller redigera ett flöde
Öppna ett befintligt inkommande, utgående eller köbaserat samtalsflöde, eller skapa ett nytt där du vill använda ElevenLabs-agenten.
Lägg till en botåtgärd
-
Lägg till åtgärden “Call Audio Connector” från kategorin Bot i ditt flöde
-
Välj din Audio Connector-integration i rullgardinsmenyn för integrationer
-
Ange ID:t för din ElevenLabs-agent i fältet Connector ID
Krav för agentkonfiguration
Din ElevenLabs Agents-agent måste konfigureras med specifika ljudinställningar för kompatibilitet med Genesys:
Krav på ljudformat
- TTS-utdataformat: Ställ in på μ-law 8000 Hz i Agent Settings → Voice
- Ljudformat för användarindata: Ställ in på μ-law 8000 Hz i Agent Settings → Advanced
Klienthändelser som stöds
Genesys-integrationen stöder endast följande klienthändelser:
- Ljudhändelser: För att bearbeta röstinmatning från uppringare
- Avbrottshändelser: För att hantera avbrott från uppringare medan agenten talar
Andra typer av klienthändelser stöds inte i Genesys-integrationen och ignoreras utan meddelande om de konfigureras.
Sessionsvariabler
Du kan skicka dynamisk kontext från ditt Genesys-flöde till din ElevenLabs-agent med sessionsvariabler för indata och få tillbaka data via sessionsvariabler för utdata. Sessionsvariabler kan också användas för att åsidosätta specifika inställningar för agentkonfiguration direkt från ditt Genesys-flöde.
Sessionsvariabler för indata
- I Genesys-flödet: Definiera sessionsvariabler för indata i åtgärden “Call Audio Connector”
- I ElevenLabs-agenten: Variabler är tillgängliga som dynamiska variabler och/eller åsidosätter konfigurationsinställningar
- Användning: Referera till dessa variabler i agentens konversationsflöde eller systemprompter
Läs mer om dynamiska variabler.
Konfigurationsåsidosättningar
Följande sessionsvariabler kan ändra agentens konfiguration vid körning:
system__override_system_prompt: Åsidosätter agentens systemprompt.system__override_first_message: Åsidosätter agentens första meddelande till användaren.system__override_language: Anger agentens språk för den här sessionen.system__override_voice_id: Anger agentens röst-ID för den här sessionen.
Exempel på användning
Sessionsvariabler för indata i Genesys-flödet:
customer_name = "John Smith"system__override_first_message = "Hello! Welcome to our support line."system__override_language = "en"
ElevenLabs-agentens prompt: Hej {{customer_name}}, hur kan jag hjälpa dig i dag?
Sessionsvariabler för utdata
Du kan nu ta emot data från din ElevenLabs-agent tillbaka till ditt Genesys-flöde via sessionsvariabler för utdata.
All data som samlas in via Datainsamling i din ElevenLabs-agent blir tillgänglig som sessionsvariabler för utdata i ditt Genesys-flöde när konversationen avslutas.
Exempel på användning
När konversationen med din ElevenLabs-agent är klar kan du använda utdatavariablerna i ditt Genesys-flöde:
- Beslutslogik: Använd utdatavariabler i beslutsnoder för att vidarekoppla samtal
- Databearbetning: Skicka konversationsdata till externa system
- Rapportering: Inkludera konversationsresultat i analyserna för ditt kontaktcenter
Funktion för överföring till nummer
ElevenLabs-integrationen stöder nu samtalsöverföringar tillbaka till Genesys för vidarekoppling till specifika nummer eller köer.
Konfigurera överföringar
Konfigurera ett datainsamlingsobjekt
Lägg till ett datainsamlingsobjekt i din ElevenLabs-agent med en detaljerad identifierare och beskrivning för att samla in vart användaren ska överföras.
Uppdatera agentens prompt
Lägg till instruktioner i agentens systemprompt om att använda verktyget end_call när en överföring begärs. Till exempel:
Konfigurera Genesys-flödeslogik
Lägg till beslutsnoder efter Audio Connector-åtgärden i ditt Genesys Architect-flöde för att kontrollera utdatavariabler och vidarekoppla samtalet därefter:
- Använd sessionsvariabler för utdata för att avgöra om en överföring begärdes
- Konfigurera vidarekopplingslogik utifrån överföringstyp eller destination
- Använd Genesys inbyggda överföringsfunktioner för att slutföra överföringen
Exempel på överföringsflöde
- Kundförfrågan: “Jag behöver prata med fakturering”
- Agentsvar: “Jag kopplar dig till vår faktureringsavdelning”
- Agentåtgärd: Använder verktyget end_call
- Datainsamling: Datainsamlingsfältet fylls i
- Genesys-flöde: Kontrollerar utdatavariabeln och vidarekopplar till faktureringskön
Begränsningar och funktioner som inte stöds
Följande verktyg och funktioner stöds inte i Genesys-integrationen:
Verktyg som inte stöds
- Klientverktyg: Inte kompatibelt med Genesys WebSocket-integration
Felsökning
WebSocket-anslutningen misslyckas
Kontrollera att din API-nyckel är korrekt konfigurerad i Audio Connector-integrationen och att ElevenLabs-agentens ID är korrekt konfigurerat i fältet Connector ID i ditt Architect-flöde. Om autentisering är aktiverad för din agent måste ägaren till API-nyckeln som används för anslutningen ha åtkomst till agenten. Se dela resurser för mer information. Om dynamiska variabler har definierats för din agent måste de skickas som sessionsvariabler för indata.
Sessionsvariabler fungerar inte
Kontrollera att sessionsvariabler för indata är korrekt definierade i Genesys-flödets åtgärd “Call Audio Connector” och att de refereras korrekt i din ElevenLabs-agent med syntaxen {{variable_name}}.