

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

# Habilitar a formatação de texto no Amazon Connect para a experiência de chat do cliente
<a name="enable-text-formatting-chat"></a>

Com a formatação de mensagens do Amazon Connect, você pode permitir que seus clientes e atendentes adicionem rapidamente estrutura e clareza às mensagens de chat. 

**Topics**
+ [

## Tipos de formatação compatíveis
](#supported-format-types)
+ [Habilitar formatação de mensagens](#how-to-enable-message-formatting)
+ [

## Como adicionar links de e-mail e telefone
](#add-email-phone-links)
+ [

## Como adicionar mensagens do chatbot
](#add-bot-messages)

## Tipos de formatação compatíveis
<a name="supported-format-types"></a>

Você pode fornecer os seguintes tipos de formatação na interface do usuário do chat e na aplicação do atendente usando markdown:
+ Negrito
+ Itálico
+ Lista com marcadores
+ Lista numerada
+ Hiperlinks
+ Emoji
+ Anexos. Para habilitar os anexos, siga [Habilitar anexos no CCP para que os clientes e atendentes compartilhem e façam upload de arquivos](enable-attachments.md).

## Como habilitar formatação de mensagens
<a name="how-to-enable-message-formatting"></a>

1. Quando você cria uma nova [interface de usuário de chat](add-chat-to-website.md), a formatação rich text é habilitada imediatamente. Não é exigida nenhuma configuração adicional.

1. Para adicionar recursos de formatação de texto a uma [interface de usuário de chat](add-chat-to-website.md) existente, atualize o [código do widget de comunicação](add-chat-to-website.md) com o seguinte código destacado em negrito: 

   ```
       (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' ]);
   ```

   O código destacado em vermelho é definido com os valores corretos quando você recebe o snippet no console do Amazon Connect. O único conteúdo que você escolhe adicionar ou remover é a última linha em negrito para`supportedMessagingContentTypes`. 

1. Para adicionar recursos de formatação de texto à sua própria interface de usuário de chat personalizada (por exemplo, [Interface de chat](https://github.com/amazon-connect/amazon-connect-chat-interface) ou sua própria solução de interface de usuário sobre o [ChatJS](https://github.com/amazon-connect/amazon-connect-chatjs)), siga estas etapas: 

   1. Chame a API [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html). Ao chamar `StartChatContact`, adicione o parâmetro `SupportedMessagingContentTypes` conforme mostrado em negrito no exemplo a seguir:

      ```
      // 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. Importe `chatjs` como objeto, conforme mostrado no exemplo a seguir:

      ```
      import "amazon-connect-chatjs";
      
      this.session = connect.ChatSession.create({
            ...
          });
      
      this.session.sendMessage({
            message: "message-in-markdown-format",
            contentType: "text/markdown"
      });
      ```

      Se você não usa ChatJs, consulte esses tópicos para obter informações sobre o envio de texto markdown por meio do 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. Envie mensagens com markdown. Consulte o snippet de código anterior para importar `chatjs` como objeto para ver um exemplo de como enviar mensagens. Você pode usar o markdown simples para formatar texto em chats. Se você já [usa o chatjs hoje para enviar mensagens de texto simples](https://github.com/amazon-connect/amazon-connect-chatjs/blob/master/src/core/chatController.js#L66), você pode modificar sua lógica existente para chamar [SendMessage](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_SendMessage.html)com `text/markdown` as `contentType` em vez de `text/plain` quando quiser enviar mensagens de markdown. Atualize o parâmetro `sendMessage` para ter o formato markdown de suas mensagens. Para obter mais informações, consulte [Markdown Guide Basic Syntax](https://www.markdownguide.org/basic-syntax/).

   1. Implemente sua própria lógica no pacote de interface do usuário para renderizar mensagens de marcação na área de entrada e na transcrição do chat. Se você usa o React, pode usar o [react-markdown](https://github.com/remarkjs/react-markdown) como referência.

**nota**  
Os recursos de formatação de texto vão aparecer para o atendente somente se o recurso tiver sido habilitado para o cliente na interface de usuário do chat. Se a formatação de texto não for suportada ou habilitada na interface de usuário do chat do cliente, o atendente não poderá redigir e enviar mensagens com formatação de texto.
Todos os recursos de formatação de texto, exceto anexos, estão disponíveis para [respostas rápidas](create-quick-responses.md).

## Como adicionar links de e-mail e telefone
<a name="add-email-phone-links"></a>

O exemplo a seguir mostra como adicionar links clicáveis e que podem ser chamados às suas aplicações web e aplicativos móveis.

```
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)
```

## Como adicionar mensagens do chatbot
<a name="add-bot-messages"></a>

Ao habilitar a marcação para mensagens de chat, você pode usar a formatação rich text para os seguintes tipos de mensagens do chatbot:
+ Fluxos [Reproduzir mensagem](play.md)
+ Fluxos [Obter informações dos clientes](get-customer-input.md)
+ `SYSTEM_MESSAGE`
+ `Lex BOT`
+ `Third Party BOT`
+ `Lex BOT Lambda`

A seguinte imagem mostra como habilitar um prompt manualmente em um bloco de fluxo [Reproduzir mensagem](play.md):

![\[Imagem de um bloco de fluxo e um prompt com dois links, um para Perguntas frequentes e outro para um número de telefone.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/chat-rtf-play-prompt-flow-1.png)


A seguinte imagem mostra como habilitar um prompt manualmente em um bloco de fluxo [Obter informações dos clientes](get-customer-input.md) e, em seguida, associar o bloco de fluxo a um bot do Amazon Lex:

![\[Imagem de um bloco de fluxo e um prompt com dois links, um para Perguntas frequentes e outro para um número de telefone.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/chat-rtf-get-customer-flow.png)


A seguinte imagem mostra como o prompt é exibido na SYSTEM\$1MESSAGE e em vários tipos de mensagem do BOT:

![\[Imagem mostrando os links “Consulte nossas perguntas frequentes” e “Ligue para nós” nas mensagens SYSTEM e BOT.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/chat-rtf-sys-bot-messages.png)


A seguinte imagem mostra como configurar um prompt em uma intenção do bot do Amazon Lex:

![\[Imagem de uma intenção do Amazon Lex contendo um prompt com dois links, um para Perguntas frequentes e outro para um número de telefone.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/chat-rtf-lex-flow.png)


Para obter mais informações sobre intenções, consulte [Adding intents](https://docs.aws.amazon.com/lexv2/latest/dg/add-intents.html) no *Guia do desenvolvedor do Amazon Lex V2*. Para obter mais informações sobre mensagens do Lambda, consulte [Habilitando a lógica personalizada com funções do AWS Lambda](https://docs.aws.amazon.com/lexv2/latest/dg/lambda.html), também no Guia do desenvolvedor do *Amazon Lex* V2.