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á.
# Campos de trechos de widget compatíveis no Amazon Connect que são personalizáveis
A tabela a seguir lista os campos de trechos do widget de comunicação que você pode personalizar. O código de exemplo após a tabela mostra como usar os campos de trecho.
| Campo de trecho | Tipo | Description | Documentação adicional |
| --- | --- | --- | --- |
| `snippetId` | String | Obrigatória, gerada automaticamente | n/a |
| `styles` | String | Obrigatória, gerada automaticamente | n/a |
| `supportedMessagingContentTypes` | Array | Obrigatória, gerada automaticamente | n/a |
| `customLaunchBehavior` | Objeto | Personalize como o site renderiza e lança o ícone do widget hospedado | [Personalizar o comportamento de inicialização do widget e o ícone do botão para seu site hospedado no Amazon Connect](customize-widget-launch.md), mais adiante neste tópico |
| `authenticate` | Função | Função de retorno de chamada para habilitar a segurança JWT no site | [Etapa 2: especificar os domínios do site em que você espera exibir o widget de comunicação](add-chat-to-website.md#chat-widget-domains), anteriormente nesta seção. |
| `customerDisplayName` | Função | Transmitir o nome de exibição do cliente durante a inicialização de um contato | [Transmitir o nome de exibição do cliente quando um chat do Amazon Connect é iniciado](pass-display-name-chat.md), posteriormente nesta seção. |
| `customStyles` | Objeto | Substituir os estilos CSS padrão | [Transmitir propriedades personalizadas para substituir os padrões no widget de comunicação do Amazon Connect](pass-custom-styles.md), posteriormente nesta seção. |
| `chatDurationInMinutes` | Número | A duração total da sessão de chat recém-iniciada | Padrão: 1.500 - Mín 60, Máx: 10.080 |
| `enableLogs` | Booleano | Habilitar os logs de depuração | Padrão: Falso |
| `language` | String | O Amazon Connect pode fazer traduções para códigos de idioma de formato ISO-639 aceitos. Para obter mais informações, consulte [https://en.wikipedia. org/wiki/List\$1de\$1Códigos ISO\$1639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes). Isso não traduziria substituições de texto personalizadas e conteúdo de mensagens (tanto enviadas quanto recebidas). | Padrão: en\$1US. Aceitos: “cs\$1CZ”, “da\$1DK”, “de\$1DE”, “en\$1AU”, “en\$1CA”, “en\$1GB”, “en\$1US”, “es\$1ES”, “fi\$1FI”, “fr\$1FR”, “hu\$1HU”, “id\$1ID”, “it\$1IT”, “ja\$1JP”, “ko\$1KR”, “nl\$1NL”, “nn\$1NO”, “pt\$1BR”, “pt\$1PT”, “sk\$1SK”, “sv\$1SE”, “zh\$1CN”, “zh\$1TW” |
| `disableCSM` | Booleano | Desabilite o rastreamento das métricas do lado do cliente por meio do widget de comunicação. | Padrão: Falso |
| `nonce` | String | Valor de handshake entre iframe e política csp do site do cliente. Exemplo: csp do cliente permite o valor de 1234 nonce, o iframe que extrai outro script deve ter o mesmo valor de 1234 nonce para que o navegador saiba que é um script confiável pelo site pai do iframe. | Padrão: indefinido |
| `customizationObject` | Objeto | Personalizar o layout e a transcrição do widget | Para obter mais informações, consulte [Personalizações adicionais para seu widget de chat do Amazon Connect](pass-customization-object.md), mais adiante nesta seção. |
| `contactAttributes` | Objeto | Passe atributos para o fluxo de contato diretamente do código do trecho, sem nenhuma configuração de JWT | Para obter mais informações, consulte [Pass contact attributes when a chat initializes](https://docs.aws.amazon.com/connect/latest/adminguide/pass-contact-attributes-chat.html). |
| `customDisplayNames` | Objeto | Substitua as configurações de nome de exibição e logotipo do sistema ou bot definidas no site de administração do Amazon Connect. | Para obter mais informações, consulte [How to pass override system and bot display names and logos for the communications widget](https://docs.aws.amazon.com/connect/latest/adminguide/pass-custom-styles.html#pass-override-system). |
| `contactMetadataHandler` | Função | Função de retorno de chamada para acessar o contactId. Por exemplo, adicione um ouvinte de eventos para lidar com cenários como chamar a StopContact função com o ContactID quando a guia do navegador estiver fechada ou manter a persistência do bate-papo com um ContactID anterior. | |
| `registerCallback` | Objeto | Isso permite executar retornos de chamada para os eventos do ciclo de vida expostos. Para obter mais informações, consulte [amazon-connect-chatjs](https://github.com/amazon-connect/amazon-connect-chatjs). | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/supported-snippet-fields.html) |
| `initialMessage` | String | A mensagem a ser enviada para o chat recém-criado. Restrições de comprimento: mínimo de 1, máximo de 1.024. | Para invocar o bot Lex configurado no fluxo de contato usando uma mensagem inicial, modifique o [bloco Obter fluxo de entrada do cliente](get-customer-input.md) selecionando a opção **Inicializar bot com mensagem**. Para obter mais informações, consulte [How to configure Get customer input flow block](get-customer-input.md#get-customer-input-properties). |
| `authenticationParameters` | Objeto | Isso habilita o bloco de fluxo [Autenticar cliente](authenticate-customer.md). | Para obter mais informações, consulte [Habilitar a autenticação do cliente](enable-connect-managed-auth.md). |
| `mockLexBotTyping` | Booleano | Habilite o indicador de digitação simulada para mensagens do Lex Bot. | Padrão: Falso |
| `customStartChat` | Função | Função de retorno de chamada para chamar a API Start Chat do seu backend. | Para acessar mais informações, consulte [Interface de usuário de widget hospedada com API Start Chat personalizada](https://github.com/amazon-connect/amazon-connect-chat-interface#option-3-hosted-widget-ui-with-custom-start-chat-api) |
O exemplo a seguir mostra como adicionar campos de trecho ao script HTML que adiciona o widget de chat ao site.
```
(function(w, d, x, id) { /* ... */})(window, document,
'amazon_connect', 'widgetId');
amazon_connect('snippetId', 'snippetId');
amazon_connect('styles', /* ... */);
amazon_connect('registerCallback', {
// Custom event example
// WIDGET_FRAME_CLOSED
/**
* This event is triggered when user clicks on the chat widget close button,
* either widget close button was clicked when error in the chat session or normally by the user.
* This event can be used for webview use cases to go back to main app
*
* @param {string} status - The reason for widget closure
* - "error_chat": Indicates the user clicked on widget close button due to an error in the chat session
* - "close_chat": Indicates the user clicked on widget close button normally by the user
*/
'WIDGET_FRAME_CLOSED': (eventName, { status }) => {
// You can implement custom logic based on the status value(error_chat or close_chat)
if (status == "error_chat") {
// handle error chat
} else if (status == "close_chat") {
// handle close chat
}
},
// System event example
/**
* chatDetails: {
* contactId: string,
* participantId: string,
* participantToken: string,
* }
* data: {
* AbsoluteTime?: string,
* ContentType?: string,
* Type?: string,
* ParticipantId?: string,
* DisplayName?: string,
* ParticipantRole?: string,
* InitialContactId?: string
* }
*/
'PARTICIPANT_JOINED': (eventName, { chatDetails, data }) => {
alert(`${data.ParticipantRole} joined the chat.`);
},
'event_Name_3': callback(function),
'event_Name_4': callback(function),
// ...
});
amazon_connect('initialMessage', 'Your initial message string');
// ...
amazon_connect('snippetFieldHere', /* ... */);
```