As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Personalizações adicionais para seu widget de chat do Amazon Connect
Você pode adicionar as seguintes personalizações opcionais à interface de usuário do chat:
+ Exiba o botão **Encerrar chat** no menu suspenso do cabeçalho, e não no rodapé.
+ Mascare ou oculte nomes de exibição.
+ Adicione ícones de mensagem.
+ Substitua mensagens de eventos.
+ Configure uma caixa de diálogo de confirmação que será apresentada aos clientes quando eles escolherem o botão **Encerrar chat**. Essa caixa de diálogo verifica se os clientes pretendem realmente encerrar a sessão de chat. Você pode personalizar a caixa de diálogo de confirmação, o título, a mensagem e o texto do botão.
+ Substitua a mensagem de rejeição do anexo.
+ Exiba um botão **Minimizar** no cabeçalho do bate-papo.
## Configurar o objeto de personalização
Este exemplo mostra como implementar algumas das personalizações opcionais. Consulte uma lista de todas as personalizações possíveis em [Restrições e opções com suporte](#customization-options-constraints). Como essas personalizações são opcionais, você pode implementar alguns ou todos os campos mostrados no exemplo a seguir. Substitua as strings `eventNames.customer`, `eventNames.agent`, `eventNames.supervisor`, `eventMessages.participantJoined`, `eventMessages.participantDisconnect`, `eventMessages.participantLeft`, `eventMessages.participantIdle`, `eventMessages.participantReturned` e `eventMessages.chatEnded` conforme necessário. Os ícones devem ser hospedados em público URLs.
```
amazon_connect('customizationObject', {
header: {
dropdown: true,
dynamicHeader: true,
minimizeChatHeaderButton: 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
}
});
```
A imagem a seguir mostra a aparência das personalizações se você usar o exemplo:
## Restrições e opções com suporte
A tabela a seguir lista os campos de personalização compatíveis e as restrições de valores recomendadas.
| Opção de layout personalizado | Tipo | Descrição |
| --- | --- | --- |
| `header.dropdown` | Booleano | Renderiza o menu suspenso do cabeçalho, em vez do rodapé padrão Quando você define essa opção como`true`, o botão **Download da transcrição** aparece e permanece visível até que você defina a opção como `false`, ou até que você remova a opção. |
| `header.dynamicHeader` | Booleano | Define dinamicamente o título do cabeçalho como “Conversando com Bot/AgentName”. |
| `header.hideTranscriptDownloadButton` | Booleano | Oculta o botão da [fazer download da transcrição](chat-widget-download-transcript.md) no menu suspenso do cabeçalho. O valor padrão é false. |
| `header.minimizeChatHeaderButton` | Booleano | Exibe um botão Minimizar no cabeçalho do bate-papo. O valor padrão é false. |
| `transcript.hideDisplayNames` | Booleano | Oculta todos os nomes de exibição, aplicará máscaras de nome padrão se `eventNames` não for fornecido. |
| `transcript.eventNames.customer` | String | Mascara o nome de exibição do cliente. |
| `transcript.eventNames.agent` | String | Mascara o nome de exibição do atendente. |
| `transcript.eventNames.supervisor` | String | Mascara o nome de exibição do supervisor. |
| ` transcript.eventMessages.participantJoined` | String | Substitui a mensagem do evento na transcrição para quando um participante entrou no chat. Se uma string vazia for especificada, a mensagem do evento será omitida da transcrição. O `{name}` pode ser transmitido na mensagem e será substituído pelo nome de exibição do participante correspondente. A mensagem padrão é `{name} has joined the chat`. |
| `transcript.eventMessages.participantDisconnect` | String | Substitui a mensagem de evento na transcrição para quando um participante é desconectado do chat. Se uma string vazia for especificada, a mensagem do evento será omitida da transcrição. O `{name}` pode ser transmitido na mensagem e será substituído pelo nome de exibição do participante correspondente. A mensagem padrão é {`name} has been idle too long, disconnecting`. |
| `transcript.eventMessages.participantLeft` | String | Substitui a mensagem do evento na transcrição para quando um participante entrou no chat. Se uma string vazia for especificada, a mensagem do evento será omitida da transcrição. O `{name}` pode ser transmitido na mensagem e será substituído pelo nome de exibição do participante correspondente. A mensagem padrão é `{name} has left the chat`. |
| `transcript.eventMessages.participantIdle` | String | Substitui a mensagem do evento na transcrição para quando um participante está ocioso. Se uma string vazia for especificada, a mensagem do evento será omitida da transcrição. O `{name}` pode ser transmitido na mensagem e será substituído pelo nome de exibição do participante correspondente. A mensagem padrão é `{name} has become idle`. |
| `transcript.eventMessages.participantReturned` | String | Substitui a mensagem do evento na transcrição para quando um participante voltou ao chat. Se uma string vazia for especificada, a mensagem do evento será omitida da transcrição. O `{name} ` pode ser transmitido na mensagem e será substituído pelo nome de exibição do participante correspondente. A mensagem padrão é `{name} has returned`. |
| `transcript.eventMessages.chatEnded` | String | Substitui a mensagem do evento na transcrição para quando o chat terminou. Se uma string vazia for especificada, a mensagem do evento será omitida da transcrição. O `{name}` pode ser transmitido na mensagem e será substituído pelo nome de exibição do participante correspondente. A mensagem padrão é `Chat has ended!` |
| `transcript.displayIcons` | Booleano | Habilita ícones de exibição da mensagem. |
| `transcript.iconSources.botMessage` | String | Ícone exibido para mensagens de bot, deve estar hospedado em um URL público. |
| `transcript.iconSources.systemMessage` | String | Ícone exibido para mensagem de sistema, deve estar hospedado em um URL público. |
| `transcript.iconSources.agentMessage` | String | Ícone exibido para mensagem de atendente, deve estar hospedado em um URL público. |
| `transcript.iconSources.customerMessage` | String | Ícone exibido para mensagem de cliente, deve estar hospedado em um URL público. |
| `composer.alwaysHideToolbar` | Booleano | Oculta a barra de ferramentas de formatação que inclui recursos de estilo de texto, como negrito, itálico e opções de listas numeradas e com marcadores. |
| `composer.disableEmojiPicker` | Booleano | Desabilita o seletor de emojis ao usar o [editor de rich text.](enable-text-formatting-chat.md) |
| `composer.disableCustomerAttachments` | Booleano | Impede que os clientes enviem ou façam upload de anexos. |
| `composer.hide` | Booleano | Esconde o compositor (`true`) ou o mostra (`false`). Para alternar o compositor com base em eventos (como quando um agente se junta), use `registerCallback` com o método. `hideComposer` Para obter mais informações, consulte [Campos de trechos de widget compatíveis no Amazon Connect que são personalizáveis](supported-snippet-fields.md).document.getElementById("amazon-connect-chat-widget-iframe").contentWindow.connect.ChatInterface.hideComposer(false) |
| `footer.disabled` | Booleano | Oculta o rodapé padrão e o botão **Encerrar chat**. |
| `footer.skipCloseChatButton` | Booleano | Fecha diretamente o widget ao clicar no botão **Encerrar chat** em vez de mostrar o botão **Fechar**. |
| `endChat.enableConfirmationDialog` | Booleano | Habilita a caixa de diálogo de confirmação Encerrar chat. Os textos padrão serão usados se confirmationDialogText não for fornecido. |
| `endChat.confirmationDialogText.title` | String | Substitui o título da caixa de diálogo de confirmação Encerrar chat. |
| `endChat.confirmationDialogText.message` | String | Substitui a mensagem da caixa de diálogo de confirmação Encerrar chat. |
| `endChat.confirmationDialogText.confirmButtonText` | String | Substitui o texto do botão de confirmação na caixa de diálogo de confirmação Encerrar chat. |
| `endChat.confirmationDialogText.cancelButtonText` | String | Substitui o texto do botão de cancelamento na caixa de diálogo de confirmação Encerrar chat. |
| `attachment.rejectedErrorMessage` | String | Substitui a mensagem de erro para rejeição do anexo do widget de chat. |