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à. # Abilitare la formattazione del testo in Amazon Connect per l’esperienza di chat del cliente Utilizzando la formattazione dei messaggi di Amazon Connect, puoi consentire rapidamente ai tuoi clienti e agenti di rendere i loro messaggi di chat più chiari e meglio organizzati. **Topics** + [Tipi di formattazione supportati](#supported-format-types) + [Abilitazione della formattazione dei messaggi](#how-to-enable-message-formatting) + [Come aggiungere link e-mail e telefonici](#add-email-phone-links) + [Come aggiungere messaggi del chatbot](#add-bot-messages) ## Tipi di formattazione supportati Puoi fornire i seguenti tipi di formattazione sia per l'interfaccia utente della chat che per l'applicazione dell'agente utilizzando markdown: + Grassetto + Corsivo + Elenco puntato + Elenco numerato + Collegamenti ipertestuali + Emoji + Allegati. Per abilitare gli allegati, segui le indicazioni riportate in [Abilitare gli allegati in un CCP in modo che clienti e agenti possano condividere e caricare file](enable-attachments.md). ## Come abilitare la formattazione dei messaggi 1. Quando crei una nuova [interfaccia utente di chat](add-chat-to-website.md), la formattazione RTF è già abilitata e non sono necessarie ulteriori configurazioni. 1. Per aggiungere funzionalità di formattazione del testo a un'[interfaccia utente di chat](add-chat-to-website.md) esistente, aggiorna il [codice del widget di comunicazione](add-chat-to-website.md) utilizzando il codice seguente evidenziato in grassetto: ``` (function(w, d, x, id){ s=d.createElement('script'); s.src='https://your-instance-alias.my.connect.aws/connectwidget/static/amazon-connect-chat-interface-client.js'; s.async=1; s.id=id; d.getElementsByTagName('head')[0].appendChild(s); w[x] = w[x] || function() { (w[x].ac = w[x].ac || []).push(arguments) }; })(window, document, 'amazon_connect', 'widget-id'); amazon_connect('styles', { openChat: { color: 'white', backgroundColor: '#123456'}, closeChat: { color: 'white', backgroundColor: '#123456'} }); amazon_connect('snippetId', 'snippet-id'); amazon_connect('supportedMessagingContentTypes', [ 'text/plain', 'text/markdown' ]); ``` Il codice evidenziato in rosso viene impostato sui valori corretti quando ricevi il frammento dalla console Amazon Connect. L'unico contenuto che devi aggiungere o rimuovere è l'ultima riga in grassetto per `supportedMessagingContentTypes`. 1. Per aggiungere funzionalità di formattazione del testo a un'interfaccia utente di chat personalizzata (ad esempio, l'[interfaccia di chat di Amazon Connect](https://github.com/amazon-connect/amazon-connect-chat-interface) o la tua soluzione di interfaccia utente personalizzata in aggiunta a [ChatJS](https://github.com/amazon-connect/amazon-connect-chatjs)), segui questa procedura: 1. Chiamata dell'API [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html). Mentre chiami `StartChatContact`, aggiungi il parametro `SupportedMessagingContentTypes`, come mostrato in grassetto nell'esempio seguente: ``` // Amazon Connect StartChatContact API { "Attributes": { "string" : "string" }, "ClientToken": "string", "ContactFlowId": "your flow ID", "InitialMessage": { "Content": "string", "ContentType": "string" }, "InstanceId": "your instance ID", "ParticipantDetails": { "DisplayName": "string" } // optional "SupportedMessagingContentTypes": [ "text/plain", "text/markdown" ] } ``` 1. Importa `chatjs` come oggetto, come illustrato nell'esempio seguente: ``` import "amazon-connect-chatjs"; this.session = connect.ChatSession.create({ ... }); this.session.sendMessage({ message: "message-in-markdown-format", contentType: "text/markdown" }); ``` Se non lo utilizzi ChatJs, consulta questi argomenti per informazioni sull'invio di testo markdown tramite Amazon Connect APIs: [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)e [SendMessage](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_SendMessage.html). 1. Invia messaggi con markdown. Per un esempio, fai riferimento al precedente frammento di codice per l'importazione di `chatjs` come oggetto. Puoi utilizzare markdown semplice per formattare il testo nelle chat. Se [oggi utilizzi già chatjs per inviare messaggi in testo semplice](https://github.com/amazon-connect/amazon-connect-chatjs/blob/master/src/core/chatController.js#L66), puoi modificare la logica esistente per chiamare [SendMessage](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_SendMessage.html)con `text/markdown` as `contentType` anziché `text/plain` inviare messaggi markdown. Assicurati di aggiornare il parametro `sendMessage` in modo che includa il formato markdown dei tuoi messaggi. Per ulteriori informazioni, consulta la sezione relativa alla [sintassi di base di Markdown Guide](https://www.markdownguide.org/basic-syntax/). 1. Implementa la tua logica nel pacchetto UI per visualizzare i messaggi con markdown nell'area di input e nella trascrizione della chat. Se utilizzi React, puoi usare [react-markdown](https://github.com/remarkjs/react-markdown) come riferimento. **Nota** Le funzionalità di formattazione del testo vengono mostrate al tuo agente solo se sono state abilitate per il cliente nell'interfaccia utente della chat. Se la formattazione del testo non è supportata o abilitata nell'interfaccia utente della chat del cliente, l'agente non sarà in grado di comporre e inviare messaggi con formattazione del testo. Tutte le funzionalità di formattazione del testo ad eccezione degli allegati sono disponibili per [risposte rapide](create-quick-responses.md). ## Come aggiungere link e-mail e telefonici Il seguente esempio mostra come aggiungere link cliccabili e chiamabili alle applicazioni web e mobili. ``` Call us today: [+1 (123) 456-7890](tel:+11234567890) [Call Us](tel:+11234567890) [Skype Us](callto:+91123-456-7890) [Fax Us](fax:+91123-456-7890) [Text Us](SMS:+91123-456-7890) [Email Us](mailto:name@email.com) ``` ## Come aggiungere messaggi del chatbot Quando abiliti il markdown per i messaggi di chat, puoi utilizzare la formattazione RTF per i seguenti tipi di messaggi del chatbot: + Flussi [Riproduci prompt](play.md) + Flussi [Recupera input cliente](get-customer-input.md) + `SYSTEM_MESSAGE` + `Lex BOT` + `Third Party BOT` + `Lex BOT Lambda` L’immagine seguente mostra come abilitare manualmente un prompt in un blocco di flusso [Riproduci prompt](play.md): ![\[Immagine di un blocco di flusso e di un prompt con 2 link, uno per le domande frequenti e l’altro per un numero di telefono.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/chat-rtf-play-prompt-flow-1.png) L’immagine seguente mostra come abilitare manualmente un prompt nel blocco di flusso [Recupera input cliente](get-customer-input.md), quindi associare il blocco di flusso a un bot di Amazon Lex: ![\[Immagine di un blocco di flusso e di un prompt con 2 link, uno per le domande frequenti e l’altro per un numero di telefono.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/chat-rtf-get-customer-flow.png) L’immagine seguente mostra l’aspetto del prompt nel SYSTEM\$1MESSAGE e in vari tipi di messaggi BOT: ![\[Immagine che mostra i link “Review our FAQ” e “give us a call” nei messaggi SYSTEM e BOT.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/chat-rtf-sys-bot-messages.png) L’immagine seguente mostra come configurare un prompt nell’intento di un bot di Amazon Lex: ![\[Immagine di un intendo di Amazon Lex che contiene un prompt con 2 link, uno per le domande frequenti e l’altro per un numero di telefono.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/chat-rtf-lex-flow.png) Per ulteriori informazioni sugli endpoint, consulta [Aggiunta di endpoint](https://docs.aws.amazon.com/lexv2/latest/dg/add-intents.html) nella *Guida per gli sviluppatori di Amazon Lex V2*. Per ulteriori informazioni sui messaggi Lambda, consulta [Enabling custom logic with AWS Lambda functions](https://docs.aws.amazon.com/lexv2/latest/dg/lambda.html), sempre nella Amazon Lex V2 Developer *Guide*.