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

# Genesys

## Panoramica

Integra l'IA conversazionale di ElevenLabs con Genesys Cloud per dotare il tuo contact center di agenti vocali e testuali dal suono naturale. Questa integrazione supporta sia le interazioni vocali tramite Audio Connector sia le conversazioni testuali tramite Bot Connector, offrendo un'esperienza cliente fluida su più canali.

Con questa integrazione puoi distribuire agenti IA che gestiscono chiamate in entrata, conversazioni in chat e interazioni di messaggistica nel tuo ambiente Genesys Cloud.

## Funzionalità

| Funzionalità                  | Supporto                                                        |
| ----------------------------- | --------------------------------------------------------------- |
| Modalità zero-retention (ZRM) | Non supportata                                                  |
| Allegati nelle conversazioni  | Non supportati — le conversazioni contengono solo audio e testo |
| Allegati negli strumenti      | Non supportati — gli strumenti operano solo sul testo           |

## Configurazione

Questa integrazione usa le **OAuth 2.0 Client Credentials** per l'autenticazione.

#### Crea un client OAuth in Genesys Cloud

Nel Centro amministrativo di Genesys Cloud, vai a **Admin > Integrations > OAuth** e fai clic su **Add Client**.

#### Configura il client OAuth

* Imposta **Grant Type** su **Client Credentials**
* Assegna il ruolo di amministratore per le tue Division(s)
* Salva la configurazione del client

#### Copia le credenziali del client

Dopo aver creato il client OAuth, copia subito **Client ID** e **Client Secret**: il secret non verrà più mostrato.

#### Seleziona la regione

Identifica la tua regione Genesys Cloud, ad esempio `mypurecloud.com` per gli Stati Uniti, `mypurecloud.de` per l'Europa, ecc.

#### Connettiti a ElevenLabs

Nella dashboard ElevenLabs, vai a **Agents > Integrations**, fai clic su **Add Integration** e seleziona **Genesys**.
Nella scheda **Configure**, inserisci **region**, **Client ID** e **Client Secret**.

## Trigger

### Audio Connector

Per gli agenti vocali, configura Genesys Audio Connector per collegare i numeri di telefono ai tuoi agenti IA conversazionali ElevenLabs.

Per istruzioni di configurazione dettagliate, inclusi autenticazione, configurazione dei numeri di telefono e instradamento delle chiamate, consulta la [documentazione di Genesys Audio Connector](https://elevenlabs.io/docs/eleven-agents/phone-numbers/c-caa-s-integrations/genesys).

### Bot Connector

Per gli agenti testuali, usa il trigger Genesys Bot Connector per abilitare interazioni in chat e tramite messaggistica. Bot Connector crea e configura automaticamente l'integrazione nel tuo ambiente Genesys Cloud.

#### Configura il trigger

#### Aggiungi un trigger Bot Connector

Nella pagina Integrations della dashboard ElevenAgents, apri l'integrazione Genesys e vai alla scheda **Triggers**. Seleziona **Genesys Bot Connector**.

#### Configura i campi del trigger

Compila i campi obbligatori:

* **Agente**: l'agente ElevenLabs che gestirà le conversazioni in entrata.
* **Nome integrazione**: nome dell'integrazione Bot Connector da creare in Genesys Cloud, ad esempio "ElevenLabs Support Bot". Questo nome viene usato per derivare l'integrazione e il nome del bot a cui si fa riferimento nei flussi Architect.

#### Attiva il trigger

Salva e attiva il trigger. ElevenLabs crea automaticamente un'integrazione Bot Connector nel tuo ambiente Genesys Cloud con gli intent `success` e `escalate`. Disattivando il trigger, l'integrazione viene rimossa da Genesys Cloud.

#### Configura il flusso dei messaggi in entrata

In Architect, apri l'Inbound Message Flow che vuoi usare.

1. Aggiungi un nodo **Call Bot Connector** e indirizzalo all'integrazione e al nome del tuo bot, entrambi derivati dall'**Integration Name** impostato nella configurazione del trigger.
2. Gestisci gli intent restituiti:
   * **success** → invia la risposta dell'agente all'utente
   * **escalate** → trasferisci a una coda di assistenza
   * **failure** → trasferisci a una coda di fallback

![Configurazione del flusso Genesys Bot Connector](/docs/_fern-img/49cf1993f9e6978e75af83e28ac8de1256198630f3c06b9e850c1ce3f4486cb2.webp)

#### Configura l'escalation

Per consentire al tuo agente di inoltrare le conversazioni all'assistenza umana, configura quanto segue in ElevenLabs:

#### Aggiungi lo strumento Update state

Nella configurazione del tuo agente, aggiungi lo strumento di sistema **Update state**. Configuralo per impostare la variabile dinamica `genesys_should_escalate` su `true`.

#### Configura il prompt di sistema

Aggiungi istruzioni di escalation al prompt di sistema del tuo agente:

```text
### Escalation

When escalating, ALWAYS ask first if the user would like to talk to another client services team member. If they say yes, use the update_state tool to set the genesys_should_escalate dynamic variable to true.
```

#### Aggiungi regole aziendali

Includi scenari di escalation nelle regole aziendali del tuo agente. Ad esempio:

```text
- If a question is partially covered, answer what you can and then escalate
- If a question is not covered in the knowledge base, respond: "I'm not able to help with that here". Then escalate to a client services team member.
```

Quando l'agente imposta `genesys_should_escalate` su `true`, Bot Connector restituisce l'intent `escalate`, attivando il flusso di escalation configurato in Architect.

## FAQ

### Perché la configurazione del mio trigger Bot Connector non è riuscita?

La configurazione di un Bot Connector comprende più passaggi che devono propagarsi nei sistemi interni di Genesys. Se la propagazione è lenta, la configurazione può non riuscire. In genere, riprovando dopo un paio di minuti la procedura riesce. Se il problema persiste, contatta l'assistenza ElevenLabs.

### Gli operatori vedranno la cronologia delle conversazioni dopo l'escalation?

Sì, i messaggi precedenti verranno visualizzati come messaggi del bot nell'interfaccia Genesys, quindi l'operatore potrà vedere l'intera cronologia della conversazione.

### Il mio Bot Connector non funziona, come posso eseguire il debug?

In ElevenLabs, cerca le conversazioni precedenti del tuo agente che provengono da Genesys. Avranno ID conversazione con il suffisso `gn_xxxxxx`, in cui gli ultimi sei caratteri sono i primi caratteri della conversazione Genesys connessa.
Se nella trascrizione sono presenti errori, ad esempio chiamate di strumenti non riuscite, risolvili.

Verifica anche se l'agente impiega più di 10 secondi per rispondere, poiché Genesys gli assegna un timeout di soli 10 secondi.

Se non ci sono conversazioni precedenti, l'errore potrebbe essere lato Genesys.
In Genesys Architect, controlla la cronologia di esecuzione del tuo flusso. La trovi nel menu a discesa del pulsante di salvataggio.

## Link utili

* [Documentazione OAuth Genesys Cloud](https://developer.genesys.cloud/authorization/platform-auth/use-client-credentials)
* [Panoramica di Genesys Architect](https://help.mypurecloud.com/articles/architect-overview/)
* [Documentazione Genesys Bot Connector](https://help.genesys.cloud/articles/about-genesys-bot-connector/)
* [ElevenLabs Audio Connector per Genesys](https://elevenlabs.io/docs/eleven-agents/phone-numbers/c-caa-s-integrations/genesys)