What's my plan?
Add-on AI agents - Advanced
本文章介绍了旧版功能，仅供已安装Ultimate Chat 小组件并需要维护相关信息的客户使用。新客户应通过 Web Widget 设置人工智能专员。

只需几分钟， Ultimate Chat 小组件即可在您的网站上运行。您将很快就能提供一流的客户支持！小组件高度可自定义，可匹配您品牌独特的外观和风格，其设计旨在优化性能：其紧凑的尺寸不会减慢您的页面加载时间。

本文章包含以下内容：

  • 嵌入小组件
  • 加载小组件
  • 捕获Metadata
  • 对话记录
  • 国际化和本地化
  • 生成式回复配置
  • 通知
  • 方法
  • 表格
  • 本地化
  • 数据隐私
  • 常见问题解答

支持的平台：

  • 桌面
  • 移动（网络）

支持的内容类型：

  • 短信，包括 HTML 格式
  • 生成式回复
  • 按钮
  • 卡片和轮播
  • 链接
  • 图像和 GIF 支持

升级

  • 电邮升级
  • 工单创建（需要简单的 API 整合）

嵌入小组件

要添加小组件，将脚本嵌入您的网站或通过标签管理器添加小组件。

请确保将 botID 替换为您的唯一人工智能专员标识符。您的 BotID 在以下 URL 中找到：https://dashboard.ultimate.ai/bot/{botID}/ 或 https://dashboard.ultimate.ai/ultimategpt/{botID}。

嵌入脚本 - 在 HTML 文件中

此脚本应插入 在 正文标签结束 之前：</body>

<script type="module"> import UltimateChat from 'https://widget.ultimate.ai/sdk/index.mjs'; const chat = UltimateChat.Initialize({ botId: 'YOUR_BOT_ID_HERE', theme: {

'actions-hover': '#4A48B0',

'actions': '#5D5ADC',

'header-text': '#ECECF9',

'chat-button': '#15142d',

'chat-border-radius': 12px,

'header': '#000'

}, navbar: { avatarUrl: 'https://www.ultimate.ai/hubfs/raw_assets/public/ultimate/favicon/apple-touch-icon-152x152.png', title: 'Ultimate.ai', subtitle: 'Our bot will reply instantly', longSubtitle: 'I\'m an AI agent and here to answer your questions.' }, recoverConversation: true, metadata: [ { key: 'name', value: 'John Doe' }, { key: 'email', value: 'john@ultimate.ai', sanitize: true } ] }); </script>

嵌入脚本 - Tag Manager（GTM 或类似服务） 

<script> function _onUltimateChatLoad() { var chat = UltimateChat.Initialize({ botId: 'YOUR_BOT_ID', theme: {

'actions-hover': '#4A48B0',

'actions': '#5D5ADC',

'header-text': '#ECECF9',

'chat-button': '#15142d',

'chat-border-radius': 12px,

'header': '#000'

}, navbar: { avatarUrl: 'https://www.ultimate.ai/hubfs/raw_assets/public/ultimate/favicon/apple-touch-icon-152x152.png', title: 'Ultimate.ai', subtitle: 'Our bot will reply instantly', longSubtitle: "I'm an AI agent and here to answer your questions." }, recoverConversation: true, metadata: [ { key: 'name', value: 'John Doe' }, { key: 'email', value: 'john@ultimate.ai', sanitize: true } ] }); } </script> <script> (function () { var s = document.createElement('script'); s.type = 'text/javascript'; s.async = true; s.src = 'https://widget.ultimate.ai/sdk/index.iife.js'; s.onload = _onUltimateChatLoad; var x = document.getElementsByTagName('script')[0]; x.parentNode.insertBefore(s, x); })(); </script>

样式自定义

在小组件脚本中，您可以选择各种颜色以适应小组件的主题。

theme: { 
'actions-hover': '#4A48B0', 
'actions': '#5D5ADC', 
'header-text': '#ECECF9', 
'chat-button': '#15142d', 
'chat-border-radius': 12px, 
'header': '#000' 
},

资产规格：

头像 -172x172 px

加载小组件

加载时打开

此配置选项控制小组件在加载时的行为。当设置为 时 true完成加载后，小组件会自动打开。默认情况下，此选项设置为 false 这意味着在线交谈小组件将保持关闭状态，直到用户手动打开。

打开小组件只能以编程方式进行（请参阅方法 - 打开小组件），或通过 openOnLoad 配置选项。默认情况下，此选项设置为 false更新。

 

显示/隐藏小组件按钮

此配置选项控制小组件“欢迎按钮”的可见度。当设置为 时 true时，该按钮无论是在初始加载或关闭小组件后根本不显示。

 

在线交谈位置

此配置使您可以控制在线交谈小组件在屏幕上的什么位置。您可以将其设置为 Bottom-right 或 Bottom-left取决于它最适合您的品牌的地方。如果未定义，则小组件将默认为 Bottom-right更新。

捕获Metadata

Metadata是为人工智能专员提供更多背景信息的数据。Metadata可用于扩充在线交谈，提供关于客户、其行为以及其之前与公司互动的更多信息。

通过利用元数据，人工智能专员可以为客户提供更加个性化、更加高效的体验，从而提高客户满意度和忠诚度。此外，元数据可帮助支持团队分析并改进其支持流程。

网站可随时设置和更新对话期间可用的元数据。

这可通过将您要收集的值添加到 小组件代码 中来完成。

如果您想使用此功能，我们可以建议您如何调整小组件代码。

用例：

客户信息：Metadata可提供关于客户的信息，例如姓名、电邮地址、电话号码、位置和其他详情。此信息可帮助人工智能专员个性化对话，并提供更相关的帮助。

购买记录：如果客户以前曾从该公司购买商品，元数据可提供关于其购买历史记录的信息，例如其购买的产品、购买日期和支付的价格。这些信息可帮助人工智能专员了解客户的需求，并提供针对性协助。

沟通记录：Metadata还可以提供关于客户以前与公司互动的信息，例如以前的在线交谈、电邮或电话。此信息可帮助人工智能专员了解当前对话的背景信息，并为客户提供更加无缝的体验。

设备信息：Metadata可提供关于客户在线交谈所使用的设备的信息，例如设备类型、操作系统和浏览器。此信息可帮助人工智能专员解决技术问题，并提供更有针对性的帮助。

Metadata

要为人工智能专员提供更多背景信息，请使用：

setMetadata(Array<{
key: string;
value: string;
sanitize: boolean;
}> metadata)

如果 sanitize 已设置为 true 该值在对话日志中不可用，将带有占位符

例如：

            setTimeout(() => {
                chat.setMetadata([
                    { key: 'orderName', value: 'Jane Doe' },
                    { key: 'orderEmail', value: 'jane@ultimate.ai', sanitize: true }
                ]);
            }, 2000);

自动元数据收集

Ultimate Chat 小组件可自动收集与用户设备相关的元数据。

如何设置？

此功能默认处于活动状态。

您可以通过设置取消激活它autoMetadataCollection 收件人： false

已收集元数据的详情。

此功能根据设备配置工作，不需要 Cookie 和用户 IP 即可正常工作。

Metadata 描述
语言 {{systemLanguage}}

用户设备的默认语言。

即 en-GB, en-US

完整的语言代码列表参见 此处。

（使用标准 BCP 47）
时区 {{systemTimezone}}

用户当前所在的时区/地区。

即 Europe/Berlin,

完整的时区列表在 区 ID列 中。
设备类型 {{deviceName}}

用户使用的设备类型。我们正在检测的设备是：

移动设备： iPad, iPhone, Android, Windows Phone

桌面设备： Mac, Windows, Linux

起始 URL

{{url}}

用户打开小组件的页面 URL。

即 https://www.google.com
浏览器名称 {{browserName}}

用户浏览器的名称。

即 Chrome, Firefox, Opera, etc
浏览器版本 {{browserVersion}}

用户浏览器的版本。

即 111, 113 etc

 

对话记录

与小组件的每次对话都直接存储在对话日志中。

为了无缝对话，我们建议启用交谈记录。这样用户可以从中断的地方继续操作，即使在重新加载页面或重新打开浏览器标签后也是如此。

为此，我们利用浏览器的本地存储空间来保存对话 ID。这样我们就可以在需要时检索对话数据。

激活

检索上一次对话更改 recoverConversation参数 为 true更新。

取消激活

当您取消激活对话记录（更改 recoverConversation 参数为 false) 时， lastReadMessageId_{botId} 和 platformConversationId_{botId} 已从用户的浏览器本地存储空间 (LS) 中移除。有关本地存储使用情况的更多详情，请参阅 此处。

recoverConversation was previously named isConversationPersistanceEnabled

 

生成式回复配置

人工智能答案标签

从现在开始，每个人工智能生成的答案上方都会显示一个标签。这意味着用户可以轻松区分人工智能生成的内容和其他消息输入。此举旨在使用户体验更加清晰明了，让用户随时了解其与之互动的内容的性质。

配置：

显示/隐藏信息图标 messageGeneratedAdditionalInfo （默认 false)

消息来源

每个人工智能生成的回复现在都会显示信息的来源，使您可以追溯回复的来源。这不仅可以提高可信度，还使用户可以通过触手可及的可信参考进一步探索主题。

配置：

使用 参数显示/隐藏人工智能来源 showLlmSources （默认 true)

通知

可视化通知

这些通知以可视化形式呈现新到的消息。每次关闭或最小化小组件并收到新消息时，都会显示红色通知，显示已收到但未打开的消息数量。 

声音通知

声音通知用作提高用户认知度的声音警报，在以下条件下被激活：
  1. 专员升级：当专员加入升级请求时。
  2. 后台标签警报：当用户正在查看其他浏览器标签时收到一条消息时。
  3. 最小化小组件警报：当有新消息到达且小组件最小化时。
配置选项
启用/禁用声音通知客户端可以使用配置声音通知的默认状态 allowSoundNotifications 小组件脚本中的 选项：
  • 要默认启用声音通知，设置 allowSoundNotifications 收件人： true更新。
  • 要默认禁用声音通知，设置 allowSoundNotifications 收件人： false更新。
配置完成后，用户仍可根据其偏好手动打开或关闭声音通知。

打开/关闭小组件

您可以使用以下简单的命令，从您网站的任何地方轻松控制小组件：

  • 显示小组件 openWidget()
  • 隐藏小组件 closeWidget()

移除小组件

用例示例：

仅向已登录的用户提供小组件访问权限，并确保在用户退出后小组件已关闭。

实施：

调用方法 destroy()

行为：

  • 从 DOM（文档对象模型）中移除在线交谈小组件的 iFrame

  • 断开 WebSocket 连接

 

表格 

表格消息是一种结构化消息，使用该消息可以显示一个表格，在正在进行的对话中捕获用户数据，该表格可以包含文本输入以及下拉菜单选择。 

对人工智能专员（高级）

表格是收集客户数据的好方法，而且无需让人工智能专员提出多个问题。典型用例包括安全性、身份问题或数据更改请求。

要创建表格，前往 Settings / Ultimate Chat Widget / Forms 并根据页面上的说明创建表格。

可以创建如下表格字段：

  • Text
  • 电邮
  • 选择

创建表格后，前往您要添加表格的相应对话，并按照以下步骤操作。 

步骤：

  1. 添加带有速记代码的人工智能专员消息，以捕获并插入表格。在下图中，我们正在添加潜在客户捕获表格。但是，您需要在以下代码段中的 模板: 和 ))% 之间添加您的表格名称。

    %((template: nameOfTemplate))%

  2. 添加 访问者消息（自由文本写入） 人工智能专员消息之后的阻止功能。这将捕获用户的回复。

  3. 在访问者消息之后添加另一个人工智能专员消息块，其中包含对客户填写表格的某种确认，例如感谢您。

  4. 用户的回答已锁定在元数据中。如果您想在稍后的在线交谈中使用它们，您将想要检索它们——这完全是可选的。我们通过操作来做到这一点。

清理客户回复

如果您要求客户提供任何PII数据，您就需要对回复进行清理。您可能在内容实体中对此很熟悉，例如，我们默认会检查电邮地址和 IBAN 号码。要了解更多关于数据清理的信息，请参阅以下文章。

人工智能专员（高级）数据处理说明

配方：使用内容实体清理个人身份信息 (PII) 数据

如何清理表格数据

根据表格的用例，您可能需要清理信息。这很容易做到。 

  1. 单击蓝色栏“如果……”以打开详情面板。
  2. 单击“清理用户的答案”框，将详情隐藏在“人工智能专员（高级）”中

因此，当您在“人工智能专员（高级）”中查看对话时，将如下所示。

 

本地化

可以在运行时调整小组件区域设置。更改小组件调用方法的本地化： setLocale(<string>)

默认值： en_US

其他受支持的语言： nl_NL

测试本地化

使用 test 参数切换小组件的语言。 https://widget.ultimate.ai/demo/?botId={Your.Bot.ID}&locale={Your.Locale}
即https://widget.ultimate.ai/demo/?botId=65da6df65ab8b465b87222586&locale=nl_BL

用例示例：将小组件界面的语言与网站语言同步。调用方法以在网站语言更改时更新小组件语言。

数据隐私

我们的小组件符合 SOC2 和GDPR

  • 不使用 Cookie。
  • 本地存储用于提供最佳对话体验。

自定义隐私政策 URL

您也可以通过我们的小组件将其添加到导航栏部分，以添加您自己的隐私政策。

privacyPolicyUrl: URL

即 privacyPolicyUrl：https://www.ultimate.ai/security-privacy

本地存储

我们的小组件不会在用户设备上存储 Cookie，但需要有用户端存储来支持小组件的功能。这些措施概述如下：

参数名称 描述
platformConversationId_{botId} 我们会存储对话 ID，以便在页面重新加载时恢复对话。 （可以将其取消激活 —— 请参阅 此部分）
lastReadMessageId_{botId}

宽e 存储用户最后阅读消息的 ID。稍后这将用于计算通知计数器。

常见问题解答

  1. 是否必须连接到客户关系管理才能测试小组件？不，客户关系管理连接不是必需的，您可以在沙盒环境的网站上实施，如果无法做到，请让我们提供一个环境。
    我们将在平台上添加小组件，以补充我们的测试人工智能专员功能。 

  2. 如果链接被单击，我们可以跟踪吗？很遗憾，目前无法跟踪链接是否已单击。我们将评估以后是否要添加此功能。

  3. 对话生成器中是否有 HTML 格式？很遗憾，目前还没有。您可以尝试使用一个在线编辑器，例如 -HTML5 编辑器 - 免费在线内容撰写工具

  4. 我们可以进行多个对话吗？当前不支持此功能

  5. Ultimate Chat 小组件使用 cookie 吗？不，我们的小组件不会在用户设备上存储 cookie。请参阅上文，了解客户端存储空间要求的详情。

翻译免责声明：本文章使用自动翻译软件翻译，以便您了解基本内容。 我们已采取合理措施提供准确翻译，但不保证翻译准确性

如对翻译准确性有任何疑问，请以文章的英语版本为准。

由 Zendesk 提供技术支持