Vai alla navigazione

Genesys

Integra ElevenLabs Agents con Genesys usando l'integrazione nativa Audio Connector.

Panoramica

Questa guida spiega come integrare ElevenLabs Agents con Genesys Cloud tramite l’integrazione Audio Connector. Questa integrazione abilita funzionalità vocali IA integrate nella tua infrastruttura esistente di contact center Genesys tramite websocket, senza richiedere trunk SIP.

Come funziona l’integrazione con Genesys

L’integrazione con Genesys utilizza una connessione WebSocket nativa tramite l’integrazione Audio Connector:

  1. Connessione WebSocket: Connessione diretta a ElevenLabs tramite l’integrazione Audio Connector in Genesys Cloud
  2. Audio in tempo reale: Streaming audio bidirezionale tra Genesys e gli agenti ElevenLabs
  3. Integrazione dei flussi: Integrazione fluida nei flussi Genesys Architect tramite azioni bot
  4. Variabili dinamiche: Supporto per il passaggio di contesto e dati tra Genesys ed ElevenLabs

Requisiti

Prima di configurare l’integrazione con Genesys, assicurati di avere:

  1. Una licenza Genesys Cloud CX con funzionalità di flusso bot
  2. Accesso amministratore all’organizzazione Genesys Cloud
  3. Un account ElevenLabs e un agente ElevenLabs configurati
  4. Una chiave API ElevenLabs

Configurazione dell’integrazione Audio Connector

1

Accedi a Genesys Cloud Admin

Accedi alla tua organizzazione Genesys Cloud con privilegi di amministratore.

2

Vai a Integrazioni

Nell’interfaccia di Genesys Cloud, vai a Admin → Integrations.

3

Crea l'integrazione Audio Connector

  1. Fai clic su “Add Integration”, cerca “Audio Connector” e fai clic su “Install”

  2. Seleziona il tipo di integrazione Audio Connector

  3. Inserisci un nome descrittivo per l’integrazione

4

Configura l'autenticazione

  1. Vai alla sezione Configuration della tua integrazione Audio Connector

  2. In Properties, nel campo Base Connection URI, inserisci l’URL appropriato per il tuo ambiente:

    AmbienteBase Connection URI
    Predefinito (USA/Internazionale)wss://api.elevenlabs.io/v1/convai/conversation/genesys
    Residenza dei datiwss://api.<region>.residency.elevenlabs.io/v1/convai/conversation/genesys

    Se il tuo account ElevenLabs è in un ambiente di residenza isolato, sostituisci <region> con il codice della tua regione. L’uso dell’URL errato causerà errori di autenticazione. Consulta la residenza dei dati per l’elenco delle regioni disponibili e dei relativi URL.

  3. In Credentials, inserisci la tua chiave API ElevenLabs nella configurazione di autenticazione

  4. Salva la configurazione dell’integrazione

5

Attiva l'integrazione

Imposta lo stato dell’integrazione su “Active” per abilitare la connessione.

Configurazione del flusso Genesys

1

Apri Architect

In Genesys Cloud, vai a Admin → Architect.
2

Crea o modifica un flusso

Apri un flusso di chiamate in entrata, in uscita o in coda esistente, oppure creane uno nuovo in cui desideri usare l’agente ElevenLabs.

3

Aggiungi un'azione bot

  1. Nel tuo flusso, aggiungi l’azione “Call Audio Connector” dalla categoria Bot

  2. Seleziona l’integrazione Audio Connector dal menu a discesa delle integrazioni

  3. Nel campo Connector ID, specifica l’ID del tuo agente ElevenLabs

4

Configura le variabili di sessione (facoltativo)

Se devi passare contesto al tuo agente ElevenLabs, configura le variabili di sessione di input nell’azione bot. Saranno disponibili come variabili dinamiche nel tuo agente ElevenLabs.

5

Pubblica il flusso

Salva e pubblica il flusso per attivare l’integrazione.

Requisiti di configurazione dell’agente

Il tuo agente ElevenLabs Agents deve essere configurato con impostazioni audio specifiche per essere compatibile con Genesys:

Requisiti del formato audio

  • Formato di output TTS: Imposta μ-law 8000 Hz in Agent Settings → Voice
  • Formato audio di input dell’utente: Imposta μ-law 8000 Hz in Agent Settings → Advanced

Eventi client supportati

L’integrazione con Genesys supporta solo i seguenti eventi client:

  • Eventi audio: Per elaborare l’input vocale dei chiamanti
  • Eventi di interruzione: Per gestire le interruzioni dei chiamanti durante il parlato dell’agente

Gli altri tipi di eventi client non sono supportati nell’integrazione con Genesys e verranno ignorati senza notifiche se configurati.

Variabili di sessione

Puoi passare contesto dinamico dal tuo flusso Genesys al tuo agente ElevenLabs usando le variabili di sessione di input e ricevere dati tramite le variabili di sessione di output. Le variabili di sessione possono anche essere usate per sovrascrivere impostazioni specifiche della configurazione dell’agente direttamente dal tuo flusso Genesys.

Variabili di sessione di input

  1. Nel flusso Genesys: Definisci le variabili di sessione di input nell’azione “Call Audio Connector”
  2. Nell’agente ElevenLabs: Le variabili sono disponibili come variabili dinamiche e/o impostazioni di configurazione sovrascrivibili
  3. Utilizzo: Fai riferimento a queste variabili nel flusso di conversazione o nei prompt di sistema dell’agente

Scopri di più sulle variabili dinamiche.

Sovrascritture della configurazione

Le seguenti variabili di sessione possono modificare la configurazione dell’agente in fase di esecuzione:

  • system__override_system_prompt: Sovrascrive il prompt di sistema dell’agente.
  • system__override_first_message: Sovrascrive il primo messaggio dell’agente all’utente.
  • system__override_language: Imposta la lingua dell’agente per questa sessione.
  • system__override_voice_id: Imposta l’ID della voce dell’agente per questa sessione.

Esempio di utilizzo

Variabili di sessione di input del flusso Genesys:

  • customer_name = "John Smith"
  • system__override_first_message = "Hello! Welcome to our support line."
  • system__override_language = "en"

Prompt dell’agente ElevenLabs: Ciao {{customer_name}}, come posso aiutarti oggi?

Variabili di sessione di output

Ora puoi ricevere dati dal tuo agente ElevenLabs nel tuo flusso Genesys usando le variabili di sessione di output.

Tutti i dati raccolti tramite la raccolta dati nel tuo agente ElevenLabs saranno disponibili come variabili di sessione di output nel tuo flusso Genesys al termine della conversazione.

Esempio di utilizzo

Dopo il termine della conversazione con il tuo agente ElevenLabs, puoi usare le variabili di output nel flusso Genesys:

  1. Logica decisionale: Usa le variabili di output nei nodi decisionali per instradare le chiamate
  2. Elaborazione dei dati: Passa i dati della conversazione a sistemi esterni
  3. Reportistica: Includi gli esiti delle conversazioni nelle analisi del tuo contact center

Funzionalità di trasferimento a un numero

L’integrazione ElevenLabs ora supporta il trasferimento delle chiamate a Genesys per instradarle verso numeri o code specifici.

Configurazione dei trasferimenti

1

Configura un elemento di raccolta dati

Nel tuo agente ElevenLabs, aggiungi un elemento di raccolta dati con un identificatore e una descrizione dettagliati per raccogliere la destinazione a cui trasferire l’utente.

2

Aggiorna il prompt dell'agente

Aggiungi istruzioni al prompt di sistema dell’agente affinché usi lo strumento end_call quando viene richiesto un trasferimento. Ad esempio:

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

Configura la logica del flusso Genesys

Nel flusso Genesys Architect, aggiungi nodi decisionali dopo l’azione Audio Connector per controllare le variabili di output e instradare la chiamata di conseguenza:

  1. Usa le variabili di sessione di output per determinare se è stato richiesto un trasferimento
  2. Configura la logica di instradamento in base al tipo o alla destinazione del trasferimento
  3. Usa le funzionalità di trasferimento native di Genesys per completare il trasferimento

Esempio di flusso di trasferimento

  1. Richiesta del cliente: “Devo parlare con la fatturazione”
  2. Risposta dell’agente: “Ti trasferirò al nostro reparto fatturazione”
  3. Azione dell’agente: Usa lo strumento end_call
  4. Raccolta dati: Il campo di raccolta dati viene compilato
  5. Flusso Genesys: Controlla la variabile di output e instrada alla coda della fatturazione

Limitazioni e funzionalità non supportate

I seguenti strumenti e funzionalità non sono supportati nell’integrazione con Genesys:

Strumenti non supportati

  • Strumento client: Non compatibile con l’integrazione WebSocket di Genesys

Risoluzione dei problemi

Verifica che la chiave API sia configurata correttamente nell’integrazione Audio Connector e che l’ID dell’agente ElevenLabs sia configurato correttamente nel campo Connector ID del flusso Architect. Se l’autenticazione è abilitata per il tuo agente, il proprietario della chiave API usata per la connessione deve avere accesso all’agente. Consulta la condivisione delle risorse per maggiori informazioni. Se nel tuo agente sono definite variabili dinamiche, devono essere passate come variabili di sessione di input.

Verifica che le variabili di sessione di input siano definite correttamente nell’azione “Call Audio Connector” del flusso Genesys e che vi si faccia riferimento correttamente nel tuo agente ElevenLabs usando la sintassi {{variable_name}}.