Blocco di flusso in Amazon Connect: Riproduci prompt - Amazon Connect

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

    • 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 pronunciare 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) come Africa (Città del Capo), il bucket deve trovarsi nella stessa Regione.

Tipi di contatto

Tipo di contatto Supportato?

Voce

Chat

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

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:

Tipo di flusso Supportato?

Flusso in entrata

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

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

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)

Transfer to queue flow (Flusso di trasferimento alla coda)

Come effettuare la configurazione di questo blocco

Puoi configurare il blocco Play prompt utilizzando il sito Web di Amazon Connect amministrazione o utilizzando l'MessageParticipantazione nel linguaggio Amazon Connect Flow.

Prompt archiviati nella libreria dei prompt di Amazon Connect

  1. Nel designer di flusso, apri il riquadro di configurazione per il blocco Riproduci prompt.

  2. Scegli Seleziona dalla libreria dei prompt (audio).

  3. Scegli uno dei prompt preregistrati inclusi in Amazon Connect oppure utilizza il sito Web di Amazon Connect amministrazione per registrare e caricare 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.

    La pagina delle proprietà del blocco Riproduci prompt, libreria dei prompt.

Il seguente esempio di codice mostra come questa stessa configurazione sarebbe rappresentata dall'MessageParticipantazione 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, ti 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.

  2. Scegli Specifica un file audio da un bucket S3.

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

    La pagina delle proprietà del blocco Riproduci prompt, il percorso del file S3 specificato manualmente.

    Il seguente esempio di codice mostra come questa stessa configurazione verrebbe rappresentata dall'MessageParticipantazione 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:

    Il percorso del file S3 specificato manualmente utilizzando gli attributi.

- 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'MessageParticipantazione 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 percorso del file S3 impostato dinamicamente, Namespace impostato su Definito dall'utente.

Il seguente esempio di codice mostra come la stessa configurazione verrebbe rappresentata dall'MessageParticipantazione 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.

Un blocco Riproduci prompt configurato per un percorso S3.

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.

Un text-to-speech prompt impostato manualmente.

Il seguente esempio di codice mostra come questa stessa configurazione verrebbe rappresentata dall'MessageParticipantazione nel linguaggio Flow:

{ "Parameters": { "Text": "<speak>Thank you for calling</speak>" }, "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.

Per ulteriori informazioni, consulta Aggiungi text-to-speech ai prompt nei blocchi di flusso in Amazon Polly.

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.

Un blocco Play prompt configurato per. text-to-speech

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

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

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.

  • 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 per eseguire riproduci richiesta per la chat e per l'audio.

Altre risorse

Per ulteriori informazioni sui prompt, consulta gli argomenti seguenti.

  • Azioni rapide nella Guida di riferimento dell' Amazon Connect API.