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

# Personalizzazioni aggiuntive per il widget di chat Amazon Connect
<a name="pass-customization-object"></a>

Puoi aggiungere le seguenti personalizzazioni opzionali all'interfaccia utente della chat:
+ Visualizza il pulsante **Termina chat** nel menu a discesa dell'intestazione anziché nel piè di pagina.
+ Maschera o nascondi i nomi visualizzati.
+ Aggiungi icone dei messaggi.
+ Sovrascrivi i messaggi di evento.
+ Configura una finestra di dialogo di conferma che i clienti vedranno quando scelgono il pulsante **Termina chat**. Questa finestra di dialogo verifica che i clienti intendano effettivamente terminare la sessione di chat. Puoi personalizzare la finestra di dialogo di conferma, il titolo, il messaggio e il testo del pulsante.
+ Sostituisci il messaggio di rifiuto dell’allegato.

## Configurazione dell'oggetto di personalizzazione
<a name="configure-customization-object"></a>

In questo esempio viene illustrato come implementare alcune personalizzazioni opzionali. Per un elenco di tutte le personalizzazioni possibili, consulta [Vincoli e opzioni supportate](#customization-options-constraints). Poiché queste personalizzazioni sono opzionali, puoi implementare alcuni o tutti i campi mostrati nell’esempio seguente. Sostituisci le stringhe `eventNames.customer`, `eventNames.agent`, `eventNames.supervisor`, `eventMessages.participantJoined`, `eventMessages.participantDisconnect`, `eventMessages.participantLeft`, `eventMessages.participantIdle`, `eventMessages.participantReturned` e `eventMessages.chatEnded` in base alle esigenze. Le icone devono essere ospitate su piattaforme pubbliche. URLs

```
amazon_connect('customizationObject', {
        header: { 
            dropdown: true, 
            dynamicHeader: true,
        },
        transcript: { 
            hideDisplayNames: false, 
            eventNames: {
                customer: "User",
                agent: "Webchat Agent",
                supervisor: "Webchat Supervisor"
            },
            eventMessages: {
                participantJoined: "{name} has joined the chat",
                participantDisconnect: "",
                participantLeft: "{name} has dropped",
                participantIdle: "{name}, are you still there?",
                participantReturned: "",
                chatEnded: "Chat ended",
            },
            displayIcons: true,
            iconSources: { 
                botMessage: "imageURL",
                systemMessage: "imageURL",
                agentMessage: "imageURL",
                customerMessage: "imageURL",
            },
        },
        composer: {
            disableEmojiPicker: true,
            disableCustomerAttachments: true,
            alwaysHideToolbar: true,
            hide: false,
        },
        footer: {
            disabled:true,
            skipCloseChatButton: true,
        },
        endChat: {
            enableConfirmationDialog: true,
            confirmationDialogText: {
                title: "End Chat",
                message: "Are you sure you want to end this chat?",
                confirmButtonText: "End Chat",
                cancelButtonText: "Cancel",
        },
    },
    attachment: {
         // Default rejectedErrorMessage: Attachment was rejected.
        rejectedErrorMessage: "Custom Error Message: Files cannot exceed 15 MB." //this is customizable attribute 
    }
});
```

Nell'immagine seguente viene mostrato l'aspetto delle personalizzazioni se si utilizza l'esempio:

![\[Diagramma che mostra gli elementi personalizzabili: nomi visualizzati, posizioni dei menu, icone e finestra di dialogo di conferma Termina chat.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/chat-customization-diagram2.png)


## Vincoli e opzioni supportate
<a name="customization-options-constraints"></a>

Nella tabella seguente sono elencati i campi di personalizzazione supportati e i vincoli sui valori consigliati.


| Opzione di layout personalizzato | Tipo | Descrizione | 
| --- | --- | --- | 
|  `header.dropdown`  |  Booleano  |  Esegue il rendering del menu a discesa dell’intestazione anziché del piè di pagina predefinito.  Quando si imposta questa opzione su `true`, il pulsante **Download della trascrizione** viene visualizzato e rimane visibile finché non si imposta l'opzione su `false` o finché non si rimuove l'opzione.   | 
| `header.dynamicHeader` | Booleano | Imposta dinamicamente il titolo dell'intestazione su «Chatting with Bot/». AgentName | 
| `header.hideTranscriptDownloadButton` | Booleano | Nascondi il pulsante di [download della trascrizione](chat-widget-download-transcript.md) nel menu a discesa dell’intestazione. Il valore predefinito è false. | 
|  `transcript.hideDisplayNames`  |  Booleano  |  Nasconde tutti i nomi visualizzati, applica le maschere dei nomi predefinite se `eventNames` non viene fornito.  | 
|  `transcript.eventNames.customer`  |  Stringa  |  Maschera il nome visualizzato del cliente.  | 
|  `transcript.eventNames.agent`  |  Stringa  |  Maschera il nome visualizzato dell’agente.  | 
|  `transcript.eventNames.supervisor`  |  Stringa  |  Maschera il nome visualizzato del supervisore.  | 
|  ` transcript.eventMessages.participantJoined`  |  Stringa  |  Sostituisce il messaggio di evento nella trascrizione in merito al momento in cui un partecipante si è unito alla chat. Se viene specificata una stringa vuota, il messaggio di evento verrà omesso dalla trascrizione. L’elemento `{name}` può essere passato nel messaggio e verrà sostituito con il nome visualizzato del partecipante corrispondente. Il messaggio predefinito è `{name} has joined the chat`.   | 
|  `transcript.eventMessages.participantDisconnect`  |  Stringa  |  Sostituisce il messaggio di evento nella trascrizione in merito al momento in cui un partecipante si è disconnesso dalla chat. Se viene specificata una stringa vuota, il messaggio di evento verrà omesso dalla trascrizione. L’elemento `{name}` può essere passato nel messaggio e verrà sostituito con il nome visualizzato del partecipante corrispondente. Il messaggio predefinito è \$1`name} has been idle too long, disconnecting`.  | 
|  `transcript.eventMessages.participantLeft`  |  Stringa  |  Sostituisce il messaggio di evento nella trascrizione in merito al momento in cui un partecipante ha lasciato la chat. Se viene specificata una stringa vuota, il messaggio di evento verrà omesso dalla trascrizione. L’elemento `{name}` può essere passato nel messaggio e verrà sostituito con il nome visualizzato del partecipante corrispondente. Il messaggio predefinito è `{name} has left the chat`.  | 
|  `transcript.eventMessages.participantIdle`  |  Stringa  |  Sostituisce il messaggio di evento nella trascrizione in merito all’inattività di un partecipante. Se viene specificata una stringa vuota, il messaggio di evento verrà omesso dalla trascrizione. L’elemento `{name}` può essere passato nel messaggio e verrà sostituito con il nome visualizzato del partecipante corrispondente. Il messaggio predefinito è `{name} has become idle`.  | 
|  `transcript.eventMessages.participantReturned`  |  Stringa  |  Sostituisce il messaggio di evento nella trascrizione in merito al momento in cui un partecipante è rientrato nella chat. Se viene specificata una stringa vuota, il messaggio di evento verrà omesso dalla trascrizione. L’elemento `{name} `può essere passato nel messaggio e verrà sostituito con il nome visualizzato del partecipante corrispondente. Il messaggio predefinito è `{name} has returned`.  | 
|  `transcript.eventMessages.chatEnded`  |  Stringa  |  Sostituisce il messaggio di evento nella trascrizione in merito al momento in cui la chat è terminata. Se viene specificata una stringa vuota, il messaggio di evento verrà omesso dalla trascrizione. L’elemento `{name}` può essere passato nel messaggio e verrà sostituito con il nome visualizzato del partecipante corrispondente. Il messaggio predefinito è `Chat has ended!`  | 
|  `transcript.displayIcons`  |  Booleano  |  Abilita le icone di visualizzazione dei messaggi.  | 
|  `transcript.iconSources.botMessage`  |  Stringa  |  Icona visualizzata per messaggi bot, deve essere ospitata su un URL pubblico.  | 
|  `transcript.iconSources.systemMessage`  |  Stringa  |  Icona visualizzata per messaggi di sistema, deve essere ospitata su un URL pubblico.  | 
|  `transcript.iconSources.agentMessage`  |  Stringa  |  Icona visualizzata per messaggi agente, deve essere ospitata su un URL pubblico.  | 
|  `transcript.iconSources.customerMessage`  |  Stringa  |  Icona visualizzata per messaggi cliente, deve essere ospitata su un URL pubblico.  | 
|  `composer.alwaysHideToolbar`  |  Booleano  |  Nasconde la barra degli strumenti di formattazione che include funzionalità di applicazione dello stile al testo come grassetto, corsivo e opzioni per elenchi puntati e numerati.  | 
|  `composer.disableEmojiPicker`  |  Booleano  |  Disabilita il selettore di emoji durante l’utilizzo dell’[editor RTF](enable-text-formatting-chat.md).  | 
| `composer.disableCustomerAttachments` | Booleano | Impedisce ai clienti di inviare o caricare allegati. | 
| `composer.hide` | Booleano | Nasconde il compositore () o lo mostra (`true`). `false` Per cambiare il compositore in base agli eventi (ad esempio quando un agente si unisce), usalo con il metodo. `registerCallback` `hideComposer` Per ulteriori informazioni, consulta [Campi snippet del widget supportati in Amazon Connect che sono personalizzabili](supported-snippet-fields.md).<pre>document.getElementById("amazon-connect-chat-widget-iframe").contentWindow.connect.ChatInterface.hideComposer(false)</pre> | 
|  `footer.disabled`  |  Booleano  |  Nasconde il piè di pagina predefinito con il pulsante **Termina chat**.  | 
|  `footer.skipCloseChatButton`  |  Booleano  |  Chiude direttamente il widget quando si fa clic sul pulsante **Termina chat** anziché mostrare il pulsante **Chiudi**.  | 
| `endChat.enableConfirmationDialog` | Booleano | Abilita la finestra di dialogo di conferma Termina chat. Se confirmationDialogText non viene fornito, vengono utilizzati i testi predefiniti. | 
| `endChat.confirmationDialogText.title` | Stringa | Sostituisce il titolo della finestra di dialogo di conferma Termina chat. | 
| `endChat.confirmationDialogText.message` | Stringa | Sostituisce il messaggio della finestra di dialogo di conferma Termina chat. | 
| `endChat.confirmationDialogText.confirmButtonText` | Stringa | Sostituisce il testo del pulsante di conferma nella finestra di dialogo di conferma Termina chat. | 
| `endChat.confirmationDialogText.cancelButtonText` | Stringa | Sostituisce il testo del pulsante di annullamento nella finestra di dialogo di conferma Termina chat. | 
| `attachment.rejectedErrorMessage` | Stringa | Sostituisce il messaggio di errore relativo al rifiuto degli allegati del widget di chat. |