Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Blocco di flusso in Amazon Connect: Riproduci prompt
Questo argomento definisce il blocco di flusso per la riproduzione di istruzioni audio, text-to-speech messaggi o risposte in chat a clienti e agenti.
## Description
Usa questo blocco di flusso per riprodurre un messaggio o un text-to-speech messaggio audio o per inviare una risposta in chat.
È possibile riprodurre i prompt ai clienti (chiamanti o clienti che utilizzano la chat) e agli agenti.
Per le chiamate, sono disponibili le seguenti opzioni:
+ **Usa prompt preregistrati**: Amazon Connect offre una libreria di opzioni già pronte.
+ **Registra i tuoi prompt**. Sono disponibili le seguenti opzioni:
+ Utilizza la libreria Amazon Connect. Carica le tue registrazioni direttamente dal sito web di amministrazione di Connect Customer .
+ Utilizza Amazon S3. Archivia i prompt su S3 e accedi ad essi dinamicamente durante le chiamate.
+ **ext-to-speechT.** Fornisci testo semplice o SSML (Speech Synthesis Markup Language) per farlo parlare come audio.
Per le chat, sono disponibili le seguenti opzioni:
+ **Solo prompt di testo**. Invia messaggi di testo semplice a clienti e agenti. Le opzioni audio, come i prompt preregistrati, non sono disponibili per la chat.
## Casi d’uso per questo blocco
Questo blocco di flusso è progettato per l’utilizzo nei seguenti scenari:
+ Salutare i clienti. Ad esempio, “Ti diamo il benvenuto nella nostra linea di assistenza clienti”.
+ Fornire le informazioni recuperate da un database ai clienti o agli agenti. Ad esempio, “Il saldo del tuo conto è 123,45 euro”.
+ Riprodurre un audio preregistrato mentre un cliente è in coda o in attesa.
+ Riprodurre un audio preregistrato con la tua voce dai bucket S3.
+ In un flusso in entrata, riprodurre contemporaneamente un messaggio audio o un messaggio di testo a clienti e agenti.
## Requisiti per i prompt
+ **Formati supportati**: Amazon Connect supporta i file.wav da utilizzare per la richiesta. È necessario utilizzare file.wav di 8 KHz canali e audio a canale mono con codifica U-Law. In caso contrario, il prompt non verrà riprodotto correttamente. Puoi utilizzare strumenti di terze parti disponibili pubblicamente per convertire i file.wav nella codifica U-Law. Dopo aver convertito i file, caricali su Amazon Connect.
+ **Dimensione**: Amazon Connect supporta prompt con una dimensione inferiore a 50 MB e una durata inferiore a 5 minuti.
+ **Archiviazione di prompt in un bucket S3**: per le Regioni AWS che sono disabilitate per impostazione predefinita (chiamate anche Regioni con [adesione](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html)) come Africa (Città del Capo), il bucket deve trovarsi nella stessa Regione.
## Tipi di contatto
| Tipo di contatto | Supportato? |
| --- | --- |
| Voce | Sì |
| Chat | Sì
Se un contatto di chat viene instradato a questo blocco, ma il blocco è configurato per le chiamate, il contatto viene instradato lungo il ramo **Errore**. |
| Operazione | Sì
Se un contatto di attività viene instradato a questo blocco, ma il blocco è configurato per le chiamate, il contatto viene instradato lungo il ramo **Errore**. |
| Email | No - Segue il ramo **Operazione riuscita**, ma non ha alcun effetto |
Se un contatto di callback senza un agente o un cliente viene instradato a questo blocco, il contatto viene instradato lungo il ramo **Errore**.
## Tipi di flusso
È possibile utilizzare questo blocco nei seguenti [tipi di flusso](create-contact-flow.md#contact-flow-types):
| Tipo di flusso | Supportato? |
| --- | --- |
| Flusso in entrata | Sì |
| Customer queue flow (Flusso di coda del cliente) | Sì. Puoi riprodurre i prompt dalla libreria Amazon Connect ma non i prompt archiviati in Amazon S3. |
| Customer hold flow (Flusso di attesa del cliente) | No, utilizza invece il blocco di flusso [Prompt dei loop](loop-prompts.md) |
| Customer whisper flow (Flusso di messaggi vocali del cliente) | Sì. Puoi riprodurre i prompt dalla libreria Amazon Connect ma non i prompt archiviati in Amazon S3. |
| Outbound whisper flow (Flusso di messaggi vocali in uscita) | Sì. Puoi riprodurre i prompt dalla libreria Amazon Connect ma non i prompt archiviati in Amazon S3. |
| Agent hold flow (Flusso di attesa dell'agente) | No, utilizza invece il blocco di flusso [Prompt dei loop](loop-prompts.md) |
| Agent whisper flow (Flusso di messaggi vocali dell'agente) | Sì. Puoi riprodurre i prompt dalla libreria Amazon Connect ma non i prompt archiviati in Amazon S3. |
| Transfer to agent flow (Flusso di trasferimento all'agente) | Sì |
| Transfer to queue flow (Flusso di trasferimento alla coda) | Sì |
## Come effettuare la configurazione di questo blocco
Puoi configurare il blocco **Play prompt** utilizzando il sito Web di Connect Customer amministrazione o utilizzando l'[MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html)azione nel linguaggio Amazon Connect Flow.
**Topics**
+ [Prompt archiviati nella libreria dei prompt di Amazon Connect](#play-properties-library)
+ [Prompt archiviati in Amazon S3](#play-properties-s3)
+ [Text-to-speech o testo della chat](#play-properties-text-to-speech)
+ [Rami dei blocchi di flusso](#play-branches)
+ [Suggerimenti per configurazioni aggiuntive](#play-tips)
+ [Buffering dei toni tattili](#play-touchtone-buffering)
+ [Dati generati da questo blocco](#play-data)
### Prompt archiviati nella libreria dei prompt di Amazon Connect
1. Nel designer di flusso, apri il riquadro di configurazione per il blocco **Riproduci prompt**.
1. Scegli **Seleziona dalla libreria dei prompt (audio)**.
1. Scegli uno dei prompt preregistrati inclusi in Amazon Connect oppure utilizza il sito Web di Connect Customer amministrazione per [registrare e caricare](prompts.md) i tuoi prompt. Non è possibile caricare i prompt in blocco.
L'immagine seguente mostra la pagina delle **proprietà** del blocco **Riproduci prompt** configurato per riprodurre un prompt audio dalla libreria dei prompt.
Il seguente esempio di codice mostra come questa stessa configurazione sarebbe rappresentata dall'[MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html)azione nel linguaggio Flow:
```
{
"Identifier": "12345678-1234-1234-1234-123456789012",
"Type": "MessageParticipant",
"Parameters": {
"PromptId": "arn:aws:connect:us-west-2:1111111111:instance/aaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/prompt/abcdef-abcd-abcd-abcd-abcdefghijkl"
},
"Transitions": {
"NextAction": "a625f619-81b0-46c3-a855-89151600bdb1",
"Errors": [
{
"NextAction": "a625f619-81b0-46c3-a855-89151600bdb1",
"ErrorType": "NoMatchingError"
}
]
}
}
```
### Prompt archiviati in Amazon S3
Memorizza tutti i prompt di cui hai bisogno in un bucket S3 e poi consultali specificando il percorso del bucket. Per prestazioni ottimali, consigliamo di creare il bucket S3 nella stessa AWS regione dell'istanza Amazon Connect.
**Per specificare un file audio da un bucket S3**
1. Nel designer di flusso, apri il riquadro di configurazione per il blocco **Riproduci prompt**.
1. Scegli **Specifica un file audio da un bucket S3**.
1. Scegli **Imposta manualmente**, quindi specifica il percorso del file S3 che punta al prompt audio in S3. Ad esempio, `https://u1.s3.amazonaws.com/en.lob1/welcome.wav`.
L'immagine seguente mostra la pagina delle **proprietà** del blocco **Riproduci prompt** configurato per impostare manualmente il percorso del file S3.
Il seguente esempio di codice mostra come questa stessa configurazione verrebbe rappresentata dall'[MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html)azione nel linguaggio Flow:
```
{
"Identifier": "UniqueIdentifier",
"Type": "MessageParticipant",
"Parameters": {
"Media": {
"Uri": "https://u1.s3.amazonaws.com/en.lob1/welcome.wav",
"SourceType": "S3",
"MediaType": "Audio"
}
},
"Transitions": {
"NextAction": "Next action identifier on success",
"Errors": [
{
"NextAction": "Next action identifier on failure",
"ErrorType": "NoMatchingError"
}
]
}
}
```
**Come utilizzare gli attributi per specificare il percorso di un file audio da un bucket S3**
+ Puoi specificare il percorso del bucket S3 utilizzando gli attributi, come mostrato nell’immagine seguente:
- OPPURE -
+ È possibile fornire il percorso S3 con concatenazione, come illustrato nell'esempio seguente: Ciò consente di personalizzare il prompt, ad esempio, per linea di business e lingua. Ad esempio: `https://example.s3.amazon.aws.com/$['Attributes']['Language']/$['Attributes']['LOB']/1.wav`
Il seguente esempio di codice mostra come la stessa configurazione verrebbe rappresentata dall'[MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html)azione nel linguaggio Flow:
```
{
"Identifier": "UniqueIdentifier",
"Type": "MessageParticipant",
"Parameters": {
"Media": {
"Uri": "https://u1.s3.amazonaws.com/$['Attributes']['Language']/$['Attributes']['LOB']/1.wav",
"SourceType": "S3",
"MediaType": "Audio"
}
},
"Transitions": {
"NextAction": "Next action identifier on success",
"Errors": [
{
"NextAction": "Next action identifier on failure",
"ErrorType": "NoMatchingError"
}
]
}
}
```
**Come specificare il percorso S3 dinamicamente utilizzando gli attributi di contatto definiti dall’utente**
1. L’immagine seguente mostra un attributo definito dall’utente denominato **S3filepath**.
Il seguente esempio di codice mostra come la stessa configurazione verrebbe rappresentata dall'[MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html)azione nel linguaggio Flow:
```
{
"Parameters": {
"Media": {
"Uri": "$.Attributes.MyFile",
"SourceType": "S3",
"MediaType": "Audio"
}
},
"Identifier": "9ab5c4ee-7da8-44b3-b6c9-07f24e1846dc",
"Type": "MessageParticipant",
"Transitions": {
"NextAction": "a625f619-81b0-46c3-a855-89151600bdb1",
"Errors": [
{
"NextAction": "a625f619-81b0-46c3-a855-89151600bdb1",
"ErrorType": "NoMatchingError"
}
]
}
}
```
L’immagine seguente mostra l’aspetto di questo blocco quando il percorso S3 è impostato dinamicamente. Mostra il percorso S3 e presenta due rami: **Operazione riuscita** ed **Errore**.
### Text-to-speech o testo della chat
È possibile inserire un prompt in testo normale o SSML. Questi prompt basati su testo vengono riprodotti come prompt audio ai clienti che utilizzano Amazon Polly.
Ad esempio, l’immagine seguente mostra un blocco **Riproduci prompt** configurato per riprodurre il messaggio **Grazie per aver chiamato** al cliente.
Il seguente esempio di codice mostra come questa stessa configurazione verrebbe rappresentata dall'[MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html)azione nel linguaggio Flow:
```
{
"Parameters": {
"Text": "Thank you for calling"
},
"Identifier": "9ab5c4ee-7da8-44b3-b6c9-07f24e1846dc",
"Type": "MessageParticipant",
"Transitions": {
"NextAction": "a625f619-81b0-46c3-a855-89151600bdb1",
"Errors": [
{
"NextAction": "a625f619-81b0-46c3-a855-89151600bdb1",
"ErrorType": "NoMatchingError"
}
]
}
}
```
L'utilizzo di testo di input ottimizzato per SSML fornisce un ulteriore controllo sul modo in cui Amazon Connect genera la sintesi vocale dal testo fornito. Puoi personalizzare e controllare diversi aspetti del discorso restituito, ad esempio pronuncia, volume e velocità.
Per un elenco di tag SSML che è possibile usare con Amazon Connect, consulta [Tag SSML supportati da Amazon Connect](supported-ssml-tags.md).
Per ulteriori informazioni, consulta [Aggiungi text-to-speech ai prompt nei blocchi di flusso in Amazon Polly](text-to-speech.md).
L'immagine seguente mostra l'aspetto di un blocco di **prompt di riproduzione** quando è configurato per text-to-speech. Mostra il testo da riprodurre e presenta due rami: **Successo** ed **Errore**.
### Rami dei blocchi di flusso
Questo blocco supporta i seguenti rami di output:
+ **Operazione riuscita**: indica che l’audio o il messaggio di testo fornito sono stati riprodotti correttamente.
+ **Errore**: indica una mancata riproduzione dell’audio o del messaggio di testo fornito.
+ **Okay**: alcuni flussi esistenti hanno una versione del blocco **Riproduci prompt** che non dispone di un ramo **Errore**. In questo caso, il ramo **Ok** verrà sempre utilizzato in fase di runtime. Se aggiorni la configurazione di un blocco **Riproduci prompt** che non ha un ramo **Errore**, un ramo **Errore** verrà aggiunto automaticamente al blocco nell'editor.
### Suggerimenti per configurazioni aggiuntive
+ Per step-by-step istruzioni su come configurare un prompt dinamico utilizzando gli attributi dei contatti, consulta. [Selezione dinamica dei prompt da riprodurre in Amazon Connect](dynamically-select-prompts.md)
+ Quando riproduci le istruzioni da un bucket S3, per ottenere prestazioni ottimali, ti consigliamo di creare il bucket nella stessa regione dell'istanza Amazon AWS Connect.
+ Quando usi un testo, sia per uso personale che per text-to-speech chat, puoi utilizzare un massimo di 3.000 caratteri fatturati, per un totale di 6.000 caratteri. Puoi inoltre specificare il testo in un flusso utilizzando un attributo di contatto.
### Buffering dei toni tattili
Il blocco **Play prompt** include una casella di controllo: **Salta o interrompi questo prompt quando il buffering dei toni tattili** è abilitato.
+ Quando la casella di controllo è selezionata e il buffering dei toni tattili è attivo:
+ Se il buffer contiene già cifre, la richiesta viene completamente ignorata e il contatto passa al blocco successivo.
+ Se il buffer è vuoto, inizia la riproduzione del prompt. Se il cliente preme un tasto durante la riproduzione, la richiesta viene interrotta, la cifra viene aggiunta al buffer e il contatto prosegue.
+ Quando la casella di controllo non è selezionata, il prompt viene riprodotto normalmente indipendentemente dallo stato del buffer. Questo è il comportamento che segue di default.
Nel linguaggio del flusso, questo è rappresentato dal `SkipWhenDTMFBufferEnabled` parametro relativo all'azione: `MessageParticipant`
```
{
"Identifier": "12345678-1234-1234-1234-123456789012",
"Type": "MessageParticipant",
"Parameters": {
"SkipWhenDTMFBufferEnabled": "true",
"PromptId": "arn:aws:connect:us-west-2:111111111111:instance/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/prompt/abcdefab-abcd-abcd-abcd-abcdefghijkl"
},
"Transitions": {
"NextAction": "next-action-id",
"Errors": [
{
"NextAction": "error-action-id",
"ErrorType": "NoMatchingError"
}
]
}
}
```
Per ulteriori informazioni sul buffering dei toni tattili, consulta. [Imposta il comportamento del buffer Touchtone](set-touchtone-buffer-behavior.md)
### Dati generati da questo blocco
Questo blocco non genera alcun dato.
## Scenari di errore
Un contatto viene instradato lungo il ramo **Errore** nelle seguenti situazioni:
+ Se un contatto di callback senza un agente o un cliente viene instradato a questo blocco, il contatto viene instradato lungo il ramo **Errore**.
+ Amazon Connect non è in grado di scaricare il prompt da S3. Ciò può essere dovuto a un percorso di file errato o all'errata impostazione della policy del bucket S3 e conseguente mancato accesso di Amazon Connect. Per istruzioni su come applicare la policy e un modello da utilizzare, consulta [Impostazione di prompt da riprodurre da un bucket S3 in Amazon Connect](setup-prompts-s3.md).
+ Formato di file audio errato. Sono supportati solo i file.wav.
+ Il file audio è più grande di 50 MB o più lungo di cinque minuti.
+ L'SSML non è corretto.
+ La text-to-speech lunghezza supera i 6000 caratteri.
+ Il nome della risorsa Amazon (ARN) per il prompt non è corretto.
## Flussi di esempio
Tutti i flussi di esempio utilizzano il blocco **Play prompt (Riproduci richiesta)**. Vedi [Flusso in entrata di esempio in Amazon Connect per l’esperienza di primo contatto](sample-inbound-flow.md) per eseguire **riproduci richiesta** per la chat e per l'audio.
## Altre risorse
Per ulteriori informazioni sui prompt, consulta gli argomenti seguenti.
+ [Creazione di prompt in Amazon Connect](prompts.md)
+ [Azioni rapide](https://docs.aws.amazon.com/connect/latest/APIReference/prompts-api.html) nella Guida di riferimento dell' Connect Customer API.