配置聊天渠道

您可以对聊天消息传送异步聊天，联系人可随时发送聊天消息并等待回复。或实时聊天坐席与联系人进行实时交互。渠道联络中心中用于促进客户交互的各类语音和数字通信媒介。的许多方面进行配置。如果您每种类型有多个渠道，可以分别配置每个渠道以满足组织的需求。

自定义聊天小部件

您的网站上会出现聊天小部件，因此客户可以启动与您的组织的聊天消息传送异步聊天，联系人可随时发送聊天消息并等待回复。或实时聊天坐席与联系人进行实时交互。会话。如果您有多个聊天渠道联络中心中用于促进客户交互的各类语音和数字通信媒介。，每个渠道都可以使用不同的小部件外观。

HTML文件必须保存在 CXone Mpower中的实时测试或生产环境中。您不能使用本地 HTML。如果您没有通过Digital Experience进行所有更改，则聊天的显示方式可能与您在初始化和测试页面上的预期不同。请注意，您的更改可能需要几分钟时间才能在“初始化和测试”窗口中显示。

如果您在 2024 年秋季或之后开始使用Digital聊天，则必须使用Guide 在您的网站上显示聊天。通常，您不会使用自定义 CSS 和 JS 页面，因为Guide控制聊天的外观。但是，要对Guide显示的聊天渠道使用最新的 UI，请在此页面上启用使用重新设计的 UI，然后单击保存。如果不启用此选项，您仍然可以使用Guide显示聊天，但该渠道的聊天体验 UI 将没有最新的界面更新。这是特定于渠道的设置。如果您有多个与Guide一起使用的聊天渠道，则必须为每个渠道设置首选项。

请注意，Guide品牌设置将优先于此页面上设置的任何 CSS。这并不意味着这些设置会被忽略，而是如果CSS是由Guide设置的，那么它就会被使用。

单击应用程序选择器并选择ACD。
转至 Digital > 数字联络点。
单击聊天。

针对您要配置的渠道，单击自定义 CSS 和 JS。

您可以使用 CSS 或 JJavaScript (JS) 添加自定义内容。您可以在此处自定义 Adaptive Card 消息传送框架的内容。

查看如何自定义 Adaptive Card 的示例

自定义 CSS：

button.ac-pushButton {
   color: #faac4b;
   background: white;
   padding: 10px;
   border: 1px solid;
   border-radius: 10px;
   cursor: pointer;
}

自定义 JS:

window.addEventListener('load', function() { 
    if (!window.MutationObserver) {
      return;
    }
    var iframeObserver = new MutationObserver(function(){
      var button = document.querySelector('.ac-pushButton');
      if (button) {
        button.onclick = function () { 
            alert('roshan');
        };
      }
    });
    iframeObserver.observe(document.body, {
      attributes: true,
      subtree: true,
      childList: false,
      characterData: false
    });
});

单击保存。

自定义联系前调查表单

联系前调查表单会在开始聊天会话之前收集联系人的相关信息。创建表单后，您可以创建和配置要在联系前调查上显示的自定义字段。实时聊天坐席与联系人进行实时交互。和聊天消息异步聊天，联系人可随时发送聊天消息并等待回复。渠道默认都有联系前调查表单。如果您不希望某些聊天渠道或网站上的某些页面显示调查表单，则可以自定义初始化脚本为这些渠道或页面使用JavaScript命令。您还可以分配特定渠道以使用联系前调查。

为本地化添加语言变体

数字化聊天窗口中的标签自动以联系人在其浏览器中设置的相同语言显示。除了默认翻译支持的语言外，您还可以添加语言变体。如果某些选项没有可用的翻译，您可以为聊天设置备用语言。

添加语言后，您可以修改常用和自动聊天短语。这可以让您自定义翻译的措辞来满足您组织的需求。

此选项适用于聊天消息异步聊天，联系人可随时发送聊天消息并等待回复。或实时聊天坐席与联系人进行实时交互。渠道。

默认支持语言和语言代码

语言	语言代码
Arabic	AR结构
阿拉伯语（沙特阿拉伯）	ar_SA
保加利亚	背景
布列塔尼语	br
丹麦语	大
德语	de
现代希腊语	埃尔
英语（美式）	en_US
西班牙语（阿根廷）	es_AR
西班牙语（智利）	es_CL
西班牙语（哥伦比亚）	es_CO
西班牙语（西班牙）	es_ES
西班牙语（墨西哥）	es_MX
法语	fr
法语（加拿大）	fr_CA
克罗地亚语	小时
印度尼西亚语	ID
意大利语	它
日语	ja
韩语	ko
挪威博克马尔语（挪威）	ng_NO
荷兰语	nl
波兰语	PL
葡萄牙语	pt
Romanian	RO
俄语	如
瑞典语	SV
泰语	周四
土耳其语	三
中文（中国）	zh_CN
中文（台湾）	zn_TW

阅读此处了解有关语言代码的更多信息。

单击应用程序选择器并选择ACD。
转至 Digital > 数字联络点。
单击聊天。
单击所需渠道旁边的翻译。
单击添加语言。
为您要添加的语言变体输入名称。
从下拉列表中选择一种语言。
从下拉列表中选择一个国家/地区。如果您不选择国家/地区，语言将显示给在浏览器设置中使用该语言的任何人。标有国家/地区的翻译优先于无国家/地区的语言。
从下拉列表中选择备用语言。如果特定选项没有可用的翻译，则会显示在聊天中。如果未设置备用语言，这些文本将以英语显示。
单击保存。
如果要修改任何常用短语或自动消息，则可以自定义翻译文本。
1. 在您要更改的每个短语下方的文本框中输入新文本。
2. 滚动到页面顶部，然后单击保存。

如果您想将所有语言翻译恢复为默认设置，可以单击“翻译”页面上的全部重置。

修改常用和自动的聊天短语

数字聊天渠道联络中心中用于促进客户交互的各类语音和数字通信媒介。提供一些常用的短语和自动消息。示例包括等待坐席、您与 {name} 聊天和存在网络错误。请再试一次。您可能想要更改这些消息的措辞，来更好地满足组织的需求。

如果您的组织支持多种语言，您可以为每种语言创建单独的聊天信道。您可以为您创建的每个信道提供适用语言的聊天小部件。

此选项适用于聊天消息异步聊天，联系人可随时发送聊天消息并等待回复。或实时聊天坐席与联系人进行实时交互。渠道。

单击应用程序选择器并选择ACD。
转至 Digital > 数字联络点。
单击聊天。
单击想要修改的渠道相应的转换。
单击您要更改的语言旁边的编辑。
对于要更改的每个短语，在文本框中输入新的文本。
单击保存。

配置文件类型和大小限制

您可以对客户可通过聊天发送给坐席的文件配置限制。限制文件类型时您需要知道允许或限制的文件类型的 MIME 类型。此选项适用于聊天消息异步聊天，联系人可随时发送聊天消息并等待回复。或实时聊天坐席与联系人进行实时交互。渠道。

了解有关 MIME 类型的更多信息

MIME（多用途互联网邮件扩展）类型是一种比文件扩展名更加安全的确定文件类型的方法。这是一个由两部分组成的标识符，用于指定文件的常规类别和子类型。例如，一个 PNG 文件的 MIME 类型是 image/ PNG。 Web 浏览器和其他应用程序可以使用 MIME 类型来确定如何处理文件或 URL。

某些公共文件的 MIME 类型列示在下表中。有关完整列表，请在互联网上搜索 IANA MIME 类型。

文件扩展名	MIME 类型
AAC	audio/aac
AVI	video/x-msvideo
BMP	image/bmo
DOC	application/msword
DOCX	application/vnd.openxmlformats-officedocument.wordprocessingml.document
HTM、HTML	text/html
JPG, JPEG	image/jpeg
MP3	audio/mpeg
MP4	audio/mp4
PDF	application/pdf
PNG	image/png
PPT	application/vnd.ms.powerpoint
PPTX	application/vnd.openxmlformats-officedocument.presentationml.presentation
XLS	application/vnd.ms.excel
XLSX	application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

当客户试图发送过大或不允许的文件类型时，会显示弹出消息。该消息会描述允许的文件类型和大小。另外，如果浏览器不支持在聊天中发送的图像，则会显示占位符图标。

单击应用程序选择器并选择ACD。
转至 Digital > 数字联络点。
单击聊天。
单击要配置的渠道的文件限制。
启用来自客户的附件可允许联系人在聊天中共享文件附件。单击保存。
输入客户可以通过聊天发送的最大文件大小以 MB 为单位）。默认值为 40 MB。这是可以输入的最大值。
单击保存。

在允许的文件类型下，输入要允许的文件类型的 MIME 类型和描述。

在此步骤中了解有关字段的更多信息

字段	详细信息
MIME 类型	输入您想要允许的文件类型的 MIME 类型。如果您想要许可所有 MIME 类型，请输入星号作为通配符。如果希望允许某个类别的所有类型，可以使用星号包括该类别。例如，要允许所有图像类型，您可以使用 image/。数字聊天渠道默认允许以下 MIME 类型： application/vnd.openxmlformats-officedocument.spreadsheetml.sheet application/pdf application/vnd.ms-excel video/ audio/* application/vnd.openxmlformats-officedocument.wordprocessingml.document application/vnd.ms-powerpoint image/* application/msword application/vnd.openxmlformats-officedocument.presentationml.present
说明	文件类型的描述。如果客户发送过大或不允许的文件类型，此信息将出现在向客户显示的弹出消息中。描述应与 MIME 类型相对应。例如，如果 MIME 类型为 application/msword，则描述应为 .doc。

字段

详细信息

MIME 类型

输入您想要允许的文件类型的 MIME 类型。

如果您想要许可所有 MIME 类型，请输入星号作为通配符。

如果希望允许某个类别的所有类型，可以使用星号包括该类别。例如，要允许所有图像类型，您可以使用 image/*。

数字聊天渠道默认允许以下 MIME 类型：

application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
application/pdf
application/vnd.ms-excel
video/*
audio/*
application/vnd.openxmlformats-officedocument.wordprocessingml.document
application/vnd.ms-powerpoint
image/*
application/msword
application/vnd.openxmlformats-officedocument.presentationml.present

说明

文件类型的描述。如果客户发送过大或不允许的文件类型，此信息将出现在向客户显示的弹出消息中。描述应与 MIME 类型相对应。例如，如果 MIME 类型为 application/msword，则描述应为 .doc。

单击添加。

阻止 IP 地址

有时您可能需要阻止垃圾邮件发送者或其他不合适的用户与您的组织聊天。您可能还想阻止内部用户使用专为客户准备的聊天渠道联络中心中用于促进客户交互的各类语音和数字通信媒介。。您可以通过 IP 地址阻止聊天消息传送异步聊天，联系人可随时发送聊天消息并等待回复。或实时聊天坐席与联系人进行实时交互。渠道的使用。

单击应用程序选择器并选择ACD。
转至 Digital > 数字联络点。
单击聊天。
单击想要配置的渠道相应的 IP 阻止。
在文本区域中每个 IP 地址单独输入一行。不要使用 IP 地址的 CIDR 表示法或掩码位。例如，以下格式是可以接受的：192.168.2.1。此格式不可接受：192.168.2.1/24。如果在 IP 地址中输入斜杠（ / ），则会显示错误消息。
单击保存。

配置客户身份验证

您可以对聊天消息传送异步聊天，联系人可随时发送聊天消息并等待回复。或实时聊天坐席与联系人进行实时交互。渠道联络中心中用于促进客户交互的各类语音和数字通信媒介。配置加强的客户身份验证。这允许 Digital Experience 即使客户在交谈过程中使用不同的设备，也可以对其进行身份验证。客户身份验证为您组织的聊天会话提供了更高的安全性。

对于聊天消息渠道，一旦客户经过身份验证，Digital Experience 就会下载并显示坐席与客户之间以前的所有对话。这提供了一个完全异步的聊天体验。

在启用客户身份验证之前，您需要设置OAuth具有某些端点的服务器。这些端点允许 OAuth 和 Digital Experience 进行通信。使用终结点配置Digital Experience后，需要让组织的网站管理员修改聊天初始化脚本。

单击应用程序选择器并选择ACD。
转至 Digital > 数字联络点。
单击聊天。
单击您要配置的聊天渠道的身份验证选项。

从聊天安全下拉列表中，选择三个身份验证选项之一。每个选项都有完成配置的独特要求。

在此步骤中了解有关字段的更多信息

字段	详细信息
安全 Cookie	设置为默认值。通过控制聊天数据的可用时间来提供最佳的数据安全性。聊天会话使用 cookie 来存储联系人数据，但 cookie 具有一个安全属性，可以防止通过跨站点脚本进行的盗窃。这使您能够存储联系人的客户 ID，同时确保恶意软件或未授权方无法访问客户信息。在客户会话生存时间（分钟）字段中，输入在客户会话过期之前允许进行身份验证的分钟数。这定义了您的网站记住联系人身份的时间。如果您根本不希望会话过期，请输入0。
匿名	当您使用匿名选项时，聊天会话不会存储联系人的客户 ID。选择是否要允许不安全的 websocket 连接。
第三方 OAuth	如果您使用第三方到 OAuth 提供者，请选择此选项。选择是否要允许不安全的 websocket 连接。输入您设置的 OAuth 服务器中以下三个所需端点的URL：端点 - 授权：交换访问令牌和刷新令牌的授权代码。该代码只能使用一次，并且很快就会过期，例如，在一分钟内。端点 - 刷新令牌：生成新的访问令牌。该访问令牌的生命周期约为 30 分钟。这可让联系人保持在应用程序中的登录状态。端点 - UserInfo：使用访问令牌检索客户的信息，包括过去与坐席的对话。如果您设置此功能，则可以将用户的详细信息映射到自定义字段。这可使您在其他地方访问个人信息，例如通过欢迎消息。输入客户端 ID 和客户端密钥。这些是来自您 OAuth 提供程序的标识符。如果您希望在联系人登录后将其重定向到特定页面或视图，请输入重定向 uri。从请求正文格式下拉列表中，选择 JSON 或x-www-form-urlencoded。这是 CXone Mpower 用来从您的提供程序获取 OAuth 令牌的请求格式。选中存储访问令牌复选框以保存OAuth令牌以供将来使用。

字段

详细信息

安全 Cookie

设置为默认值。通过控制聊天数据的可用时间来提供最佳的数据安全性。

聊天会话使用 cookie 来存储联系人数据，但 cookie 具有一个安全属性，可以防止通过跨站点脚本进行的盗窃。这使您能够存储联系人的客户 ID，同时确保恶意软件或未授权方无法访问客户信息。

在客户会话生存时间（分钟）字段中，输入在客户会话过期之前允许进行身份验证的分钟数。这定义了您的网站记住联系人身份的时间。如果您根本不希望会话过期，请输入0。

匿名

当您使用匿名选项时，聊天会话不会存储联系人的客户 ID。

选择是否要允许不安全的 websocket 连接。

第三方 OAuth

如果您使用第三方到 OAuth 提供者，请选择此选项。

选择是否要允许不安全的 websocket 连接。
输入您设置的 OAuth 服务器中以下三个所需端点的URL：
- 端点 - 授权：交换访问令牌和刷新令牌的授权代码。该代码只能使用一次，并且很快就会过期，例如，在一分钟内。
- 端点 - 刷新令牌：生成新的访问令牌。该访问令牌的生命周期约为 30 分钟。这可让联系人保持在应用程序中的登录状态。
- 端点 - UserInfo：使用访问令牌检索客户的信息，包括过去与坐席的对话。如果您设置此功能，则可以将用户的详细信息映射到自定义字段。这可使您在其他地方访问个人信息，例如通过欢迎消息。
输入客户端 ID 和客户端密钥。这些是来自您 OAuth 提供程序的标识符。
如果您希望在联系人登录后将其重定向到特定页面或视图，请输入重定向 uri。
从请求正文格式下拉列表中，选择 JSON 或x-www-form-urlencoded。这是 CXone Mpower 用来从您的提供程序获取 OAuth 令牌的请求格式。
选中存储访问令牌复选框以保存OAuth令牌以供将来使用。

单击页面底部的保存，或者继续设置数据映射。

第三方身份验证程序的数据映射

本部分中的步骤允许您将第三方 OAuth 解决方案中的数据映射到 Digital 中的自定义字段。 OAuth 提供程序不得以相同格式返回用户数据。因此，您可以使用 Digital Experience 能够使用的自定义字段映射回复中的字段。例如，名字能够以 Name、firstName、FirstAndLast 等形式返回。

单击应用程序选择器并选择ACD。
转至 Digital > 数字联络点。
单击聊天。
单击您要配置的聊天渠道的身份验证选项。
从聊天安全下拉列表中选择第三方 OAuth。
如果您想存储 OAuth 提供程序提供的访问令牌以供进一步使用，请选择存储访问令牌。
滚动到“映射”部分。
选择启用自定义映射。
输入客户 id 映射字段、客户名字映射字段和客户姓氏映射字段。
不支持层次结构。简单地格式化数据。请以以下示例为指导。
var(--codeSnippetCopyLabel)
{ "customerId":"12345", "customerFirstName": "John", "customerLastName": "Doe" }
从下拉列表中选择要与映射一起使用的自定义字段，然后输入第三方授权服务中应该与自定义字段对应的字段。您对每个映射最多可以添加 100 个现有的自定义字段。
单击保存。

将JavaScript命令添加到网页

让网站管理员修改网页上的聊天初始化脚本，该网页为客户与您的组织发起聊天的网页。网站管理员需要添加此内容。

您应该使用 Guide 来实现所有新的数字聊天频道。若要首次设置数字聊天或创建新的聊天频道，请按照以下代码中的示例作：

var(--codeSnippetCopyLabel)

cxone('guide', 'init');

此版本未指定特定的Guide模板。因此，Guide 参与规则确定模板应显示哪个Guide。这是推荐的方法。

var(--codeSnippetCopyLabel)


                <script>
                    (function (n,u) {
                    window.CXoneDfo=n,
                    window[n]=window[n]||function(){(window[n].q=window[n].q||[]).push(arguments)},window[n].u=u,
                    e=document.createElement("script"),e.type="module",e.src=u+"?"+Math.round(Date.now()/1e3/3600),
                    document.head.appendChild(e);
                    })('cxone','https://web-modules-de-na1.niceincontact.com/loader/1/loader.js');

                    cxone('init', '5157');
                    cxone('guide', 'init', '242a5e90-57cb-44b2-83ef-d851676f334a');
                </script>

此版本指定了与特定聊天频道相对应的特定Guide模板。

请务必在代码的第一行输入您的 brandId。