为客户的聊天体验启用文本格式

使用 Amazon Connect 消息格式，您可以让您的客户和代理快速增加聊天消息的结构和清晰度。

您可以使用 markdown 在聊天用户界面和代理应用程序上提供以下类型的格式：

• 粗体

• 斜体

• 项目符号列表

• 编号清单

• 超链接

• 表情符号

• 附件。要启用附件，请关注启用附件以通过聊天共享文件。

如何启用消息格式

1. 当您创建新的聊天用户界面时，开箱即用的富文本格式。无需其他配置。

2. 要向现有聊天用户界面添加文本格式功能，请使用以下以粗体突出显示的代码更新聊天小部件代码：

   
       (function(w, d, x, id){
           s=d.createElement('script');
           s.src='https://d3xxxx.cloudfront.net/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' ]);
                   

   当您从 Amazon Connect 控制台获取代码片段时，以红色突出显示的代码将设置为正确的值。您选择添加或删除的唯一内容是最后一行以粗体显示supportedMessagingContentTypes。

3. 要向您自己的自定义聊天用户界面（例如 ChatJS 之上的聊天界面或您自己的 UI 解决方案）添加文本格式功能，请执行以下步骤：

   1. 调用 StartChatContact API。调用时StartChatContact，添加SupportedMessagingContentTypes参数，如以下示例中的粗体所示：

      // 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" ]
      }

   2. chatjs作为对象导入，如以下示例中所示：

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

      如果您不使用 ChatJs，请参阅以下主题，了解有关通过 Amazon Connect API 发送降价文本的信息：StartChatContact和SendMessage。

   3. 使用降价发送消息。有关如何发送消息的示例，请参阅前面关于chatjs作为对象导入的代码片段。你可以使用简单的 markdown 来格式化聊天中的文本。如果你现在已经在使用 chatjs 来发送纯文本消息，你可以修改你现有的逻辑来调用 SendMessageatext/markdown s，contentType而不是text/plain当你想发送 markdown 消息时。请务必更新sendMessage参数以使其具有消息的 markdown 格式。有关更多信息，请参阅 Markdown 指南基本语法。

   4. 在 UI 包中实现你自己的逻辑，在输入区域呈现 markdown 消息和聊天记录。如果你使用 React，你可以使用 react-markdown 作为参考。

注意

只有在聊天用户界面中为您的客户启用了文本格式化功能后，您的客服才会看到该功能。如果客户聊天用户界面不支持或不启用文本格式，则客服将无法使用文本格式撰写和发送消息。