Hoppa till navigering

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:

  1. WebSocket-anslutning: Direktanslutning till ElevenLabs via Audio Connector-integrationen i Genesys Cloud
  2. Ljud i realtid: Dubbelriktad ljudstreaming mellan Genesys och ElevenLabs-agenter
  3. Flödesintegration: Smidig integration i dina Genesys Architect-flöden med botåtgärder
  4. 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:

  1. En Genesys Cloud CX-licens med stöd för botflöden
  2. Administratörsåtkomst till Genesys Cloud-organisationen
  3. Ett konfigurerat ElevenLabs-konto och en ElevenLabs-agent
  4. En ElevenLabs API-nyckel

Konfigurera Audio Connector-integrationen

1

Öppna Genesys Cloud Admin

Logga in på din Genesys Cloud-organisation med administratörsbehörighet.

2

Gå till Integrations

Gå till Admin → Integrations i Genesys Cloud-gränssnittet.

3

Skapa en Audio Connector-integration

  1. Klicka på “Add Integration”, sök efter “Audio Connector” och klicka på “Install”

  2. Välj integrationstypen Audio Connector

  3. Ange ett beskrivande namn för integrationen

4

Konfigurera autentisering

  1. Gå till avsnittet Configuration i din Audio Connector-integration

  2. Under Properties anger du rätt URL för din miljö i fältet Base Connection URI:

    MiljöBase Connection URI
    Standard (USA/internationellt)wss://api.elevenlabs.io/v1/convai/conversation/genesys
    Dataresidenswss://api.<region>.residency.elevenlabs.io/v1/convai/conversation/genesys

    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.

  3. Under Credentials anger du din ElevenLabs API-nyckel i autentiseringskonfigurationen

  4. Spara integrationskonfigurationen

5

Aktivera integrationen

Ställ in integrationsstatusen på “Active” för att aktivera anslutningen.

Konfigurera ditt Genesys-flöde

1

Öppna Architect

Gå till Admin → Architect i Genesys Cloud.
2

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.

3

Lägg till en botåtgärd

  1. Lägg till åtgärden “Call Audio Connector” från kategorin Bot i ditt flöde

  2. Välj din Audio Connector-integration i rullgardinsmenyn för integrationer

  3. Ange ID:t för din ElevenLabs-agent i fältet Connector ID

4

Konfigurera sessionsvariabler (valfritt)

Om du behöver skicka kontext till din ElevenLabs-agent konfigurerar du sessionsvariabler för indata i botåtgärden. De blir tillgängliga som dynamiska variabler i din ElevenLabs-agent.

5

Publicera ditt flöde

Spara och publicera ditt flöde för att aktivera integrationen.

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

  1. I Genesys-flödet: Definiera sessionsvariabler för indata i åtgärden “Call Audio Connector”
  2. I ElevenLabs-agenten: Variabler är tillgängliga som dynamiska variabler och/eller åsidosätter konfigurationsinställningar
  3. 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:

  1. Beslutslogik: Använd utdatavariabler i beslutsnoder för att vidarekoppla samtal
  2. Databearbetning: Skicka konversationsdata till externa system
  3. 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

1

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.

2

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:

If the caller requests to be transferred to a specific department or asks to
speak with a human agent, use the end_call tool to end the conversation.
3

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:

  1. Använd sessionsvariabler för utdata för att avgöra om en överföring begärdes
  2. Konfigurera vidarekopplingslogik utifrån överföringstyp eller destination
  3. Använd Genesys inbyggda överföringsfunktioner för att slutföra överföringen

Exempel på överföringsflöde

  1. Kundförfrågan: “Jag behöver prata med fakturering”
  2. Agentsvar: “Jag kopplar dig till vår faktureringsavdelning”
  3. Agentåtgärd: Använder verktyget end_call
  4. Datainsamling: Datainsamlingsfältet fylls i
  5. 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

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.

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}}.