本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 在 Amazon Connect 中创建对话式 AI 机器人 您可以使用 Amazon Connect 管理网站创建、编辑和持续改进对话式 AI 机器人，以提供交互式语音应答 (IVR) 和聊天机器人自助服务体验。这些机器人由 Amazon Lex 提供支持。 通过使用 Amazon Connect 管理网站，您可以提供动态的对话式 AI 体验，以了解客户的意图，提出后续问题并自动解决他们的问题。本节中的主题说明了如何在 Amazon Connect 管理网站中启用机器人构建体验，以及如何构建您的机器人。 **Topics** + [在 Amazon Connect 中启用机器人构建和分析](enable-bot-building.md) + [创建机器人](work-bot-building-experience.md) + [创建流并添加对话式 AI 机器人](create-bot-flow.md) + [配置第三方语音提供商](configure-third-party-speech-providers.md) + [创建 Connect 人工智能代理意图](create-qic-intent-connect.md) + [创建机器人版本和别名](create-bot-version.md) + [评估对话式 AI 机器人的性能](lex-bot-analytics.md) + [机器人指标和分析](bot-metrics.md) + [机器人高级配置](bot-advanced-config.md) + [添加 Amazon Lex 自动程序](amazon-lex.md) # 在 Amazon Connect 中启用机器人构建和分析 完成以下步骤，使用户能够在 Amazon Connect 管理网站上创建 Amazon Lex 机器人并查看有关机器人性能的指标。 用户无法在 Amazon Connect 中编辑 LEX V1 机器人或跨区域机器人。 1. 打开 [Amazon Connect 控制台](https://console.aws.amazon.com/connect/)。 1. 选择要与 Amazon Lex 自动程序集成的 Amazon Connect 实例。 ![\[“Amazon Connect 虚拟联系中心实例”页面，实例别名。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/instance.png) 1. 在导航菜单上，选择**流**。 1. 选择**在 Amazon Connect 中启用 Lex 自动程序管理**和**在 Amazon Connect 中启用机器人分析和转录**，然后选择**保存**。 ![\[“Amazon Lex 机器人”页面，Amazon Connect 中启用 Lex 机器人管理和分析的选项。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/lex-bot-service-linked-role.png) **注意** 如果您已经部署了阻止访问 Lex 的服务控制策略（SCP），那么 Amazon Connect 会遵循这些策略，并且不会启用“机器人管理和分析”功能。但是，如果您是在已经启用此功能之后部署那些 SCP 策略的，则不会遵循它们。在这种情况下，您需要禁用此功能。 Amazon Connect 显示其使用的服务角色和服务关联角色名称。使用 Amazon Lex 基于资源的策略来调用您的 Amazon Lex 机器人。当您将一个 Amazon Lex 自动程序与 Amazon Connect 实例关联时，该自动程序上基于资源的策略会更新，以授予 Amazon Connect 调用该自动程序的权限。 有关 Amazon Lex 基于资源的策略的更多信息，请参阅《Amazon Lex V2 开发人员指南》**中的 [Amazon Lex V2 中基于资源的策略](https://docs.aws.amazon.com/lexv2/latest/dg/security_iam_service-with-iam.html#security_iam_service-with-iam-resource-based-policies)。 1. 为需要创建和管理机器人与机器人分析功能的用户，分配以下安全配置文件权限： + **通道和流** - **机器人** - **查看**、**编辑**、**创建**权限 + **分析和优化** - **历史指标** - **访问**权限 # 使用 Amazon Connect 管理员网站创建机器人 您无需离开 Amazon Connect 界面即可在 Amazon Connect 管理网站上构建完整的 Lex 机器人。在 Amazon Connect 中构建或编辑机器人不收费，而是收取 Amazon Lex 使用费。有关定价信息，请参阅 [Amazon Lex 定价](https://aws.amazon.com/lex/pricing/)页面。 **创建机器人** 1. 登录 Amazon Connect 管理员网站 https://*instance name*.my.connect.aws/。使用管理员账户，或者在其安全配置文件中具有**通道和流** - **机器人** - **创建**权限的账户。 1. 在左侧的导航菜单中，选择**路由**、**流**。 1. 在**流**页面上，选择**机器人**、**创建机器人**。 ![\[“流”页面，“机器人”选项卡，“创建机器人”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/flows-bots-tab.png) 1. 在**详细信息**对话框中，提供以下信息： + **机器人名称**：输入机器人的唯一名称。 + **机器人描述**：（可选）提供有关机器人用途的更多信息。 + **儿童在线隐私保护法（COPPA）**：选择机器人是否受《儿童在线隐私保护法》的约束。 下图显示**详细信息**对话框和这些选项。 ![\[“创建机器人详细信息”页面，其中包含名称、描述和 COPPA 设置。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/bot-create.png) 1. 选择**创建**。成功创建机器人后，您将被定向到机器人配置页面。下图显示了新创建的名为的机器人的示例页面**HotelBookingBot**。 ![\[未配置的机器人的配置页面示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/hotelbookingbot.png) 1. 在机器人配置页面上，选择**添加语言**。为您的机器人选择主要语言以及创建该语言的首选方式。 ![\[“定义您的机器人”页面示例，“添加语言”下拉框。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/bot-language-create.png) 1. 选择语言后，您将被定向到**定义您的机器人**部分。下图显示该部分示例。您将在该部分添加意图。 ![\[“定义机器人”部分示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/define-bot-page.png) ## 为机器人添加意图 在**定义您的机器人**部分，您可以添加意图。意图是您的用户想要实现的目标，例如订购鲜花或预订酒店。 您的机器人必须有至少一个意图。有两类意图： + 自定义意图：创建代表您的机器人应该处理的操作或请求的意图。本主题介绍如何创建自定义意图。 + 内置意图：默认情况下，所有机器人都包含一个单一的内置意图，即“回退意图”。当机器人无法识别任何其他意图时，就会使用此意图。例如，如果用户对酒店预订意图说“我想订购鲜花”，则会触发回退意图。下图显示一个内置意图的示例。 ![\[“使用内置意图” 对话框中，内置意图命名为 AMAZON。 HelpIntent。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/built-in-intent.png) **创建自定义意图** 1. 选择**添加意图**、**添加空意图**。 1. 在**添加意图**对话框中，输入意图的名称和对您有意义的描述。选择**添加**。 1. 要配置您的意图，请输入以下内容： + 添加**言语**示例：选择**添加**，然后提供用户可能用来表达该意图的短语或问题。选择**保存**。 + 配置**插槽**：选择**添加**，然后定义履行意图所需的插槽或参数。每个槽位均设有相应的类型，该类型用于定义可以在该槽位中输入的值。选择**添加**来添加插槽。添加完插槽后，选择**保存**。 + 创建**提示**：选择**编辑**，然后您可以输入机器人将用来询问信息或澄清用户输入的提示。完成后，选择**保存**。 + **初始回应消息**：在意图被调用后发送给用户的首条消息。您可以在意图开始时，提供回复、初始化值，并定义机器人响应用户的下一步操作。 + **确认提示与回应**：这些用于确认或拒绝执行意图。该确认提示会提示用户对槽位值进行检查。例如，“我已经预订了周五的酒店。是否确认？” 当用户拒绝确认时，会将拒绝响应发送给用户。 + **结束回应消息**：这是在意图被履行并且所有其他消息都播放完毕后发送给用户的响应。例如，“感谢您预订酒店房间”。 有关 Amazon Lex 机器人意图和高级配置的更多信息，请参阅 Amaz *on Lex V* [2 开发者指南中的添加意图](https://docs.aws.amazon.com/lexv2/latest/dg/add-intents.html)。 # 创建流并添加对话式 AI 机器人 本主题介绍如何向流中添加之前创建的对话式 AI 机器人。 1. 在 Amazon Connect 的导航菜单上，选择**路由**、**流**、**创建流**，然后键入流的名称。 1. 在**交互**下，将[获取客户输入](get-customer-input.md)块拖到设计器中，然后将它连接到**入口**点块。 1. 选择[获取客户输入](get-customer-input.md)块以打开它。 1. 在 Amazon Lex 选项卡上，使用下拉菜单选择您之前创建的机器人以及别名，如下图所示。 ![\[“获取客户输入”块属性，Amazon Lex 选项卡。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/get-customer-input-lextab.png) 1. 在 “**客户提示或机器人初始化**” 下，选择**Text-to-speech 或聊天文本**。 1. 键入一条消息向呼叫方提供有关他们可以执行什么操作的信息。例如，使用与机器人中使用的意图相匹配的消息，譬如*查询账户余额，请按 1 或说 1。联系座席，请按 2 或说 2*。下图显示此消息在[获取客户输入](get-customer-input.md)块的属性页面上的位置。 ![\[“获取客户输入”块的“客户提示或机器人初始化”部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-prompt-bot-initialization.png) 1. 在**意图**下，选择**添加意图**，然后输入或搜索应触发机器人的客户意图。 ![\[“意图”部分，“添加意图”按钮，“搜索”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/add-intent.png) 在搜索意图时，可以按区域设置进行筛选。区域设置仅用于筛选，与机器人被触发时的区域设置无关。例如，您可以使用英语（美国）区域设置找到 BookHotel 意图，但是可以成功地以英语（美国）和英语（GB）返回意图。 有关查找意图的更多信息，请参阅[如何查找意图](#find-notlisted-intents)。 下图显示按区域设置筛选意图的对话框。 ![\[“搜索”选项，“使用区域设置进行筛选以添加意图”对话框。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/filter-intents.png) 1. 选择**保存**。 **重要** 如果您使用的是 Amazon Lex V2 自动程序，则您在 Amazon Connect 中的语言属性必须与构建 Lex 自动程序时使用的语言模型相匹配。这与 Amazon Lex (Classic) 不同。使用[设置语音](set-voice.md#set-voice-lexv2bot)数据块指示 Amazon Connect 语言模型，或者使用[设置联系属性](set-contact-attributes.md)数据块。 ## 如何查找 Amazon Lex V1 机器人、跨区域机器人或动态设置的机器人的意图 **意图**下拉框不会列出 Amazon Lex V1 机器人、跨区域机器人或动态设置了机器人 ARN 的意图。对于这些意图，请尝试使用以下选项查找它们。 + 检查**AmazonConnectEnabled**标签是否设置为 true： 1. 打开 Amazon Lex 控制台，选择**机器人**，选择所需机器人，然后选择**标签**。 1. 如果**AmazonConnectEnabled**标签不存在，则添加 **AmazonConnectEnabled = true**。 1. 返回 Amazon Connect 管理员网站。刷新流设计器，以在**获取客户输入**模块中看到选项。 + 检查版本是否与别名相关联： 1. 在 Amazon Connect 管理网站中，选择 “**路由**”、“**流程**”、“机器人”、“**别名**”。验证是否已启用**在流和流模块中使用**，如下图所示。 ![\[“别名”选项卡，“在流和流模块中使用”切换。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/bot-alias-enabled.png) 1. 刷新流设计器，以在**获取客户输入**模块中看到选项。 # 在 Amazon Connect 中配置第三方语音提供商 您可以在 Amazon Connect 中配置第三方 speech-to-text text-to-speech (STT) 和 (TTS) 提供商，以扩大语言覆盖范围、提高识别准确度并提供更具表现力的合成语音。本节介绍如何为机器人配置第三方 STT 提供商和第三方 TTS 提供商以用于联系流。 **Topics** + [配置第三方 speech-to-text (STT) 提供商](configure-third-party-stt.md) + [配置第三方 text-to-speech (TTS) 提供商](configure-third-party-tts.md) + [第三方 STT 提供商的终端节点和区域](endpoints-regions-third-party-stt.md) + [管理密钥和资源策略](managing-secrets-resource-policies.md) # 配置第三方 speech-to-text (STT) 提供商 按照以下说明配置第三方 speech-to-text (STT) 提供商。 ## 先决条件 + 具有现有语言环境的机器人。 + 存储在中的 AWS Secrets Manager第三方 STT 提供商 API 密钥。有关在 Secrets Manager 中将 API 密钥存储为密钥的更多信息，请参阅[创建 AWS Secrets Manager 密](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html)钥。 + Secrets Manager 资源策略允许 Amazon Connect 检索密钥。有关更多信息，请参阅 [管理密钥和资源策略](managing-secrets-resource-policies.md)。 + AWS KMS key 允许解密的权限。有关更多信息，请参阅 [管理密钥和资源策略](managing-secrets-resource-policies.md)。 + 提供者型号 ID 和 Secrets Manager ARN。 ## 步骤 1：打开语音模型配置面板 1. 登录 Amazon Connect 管理网站。 1. 选择**机器人**，然后选择机器人。 1. 选择区域。 1. 在 “**语音模型**” 部分，选择 **“编辑”** 以打开配置模式。 ![\[对话式 AI 机器人的配置页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/Lex/01-airlinesbot.png) ## 第 2 步：选择模型类型 在**模型类型**下拉列表中，选择**语音转文本 (STT)**。这样可以确保将语言环境配置为转录，而不 speech-to-speech是。 ![\[语音模型对话框。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/Lex/02-speech-model.png) ## 步骤 3：查看默认语音模型设置 默认情况下，亚马逊被选为 speech-to-text提供商。切换到第三方提供商之前，请查看当前设置。 ![\[选择 Amazon 作为语音提供者的语音模型对话框。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/Lex/03-speech-model-amazon.png) ## 第 4 步：选择第三方 STT 提供商 打开**语音提供商**下拉列表并选择支持的第三方 speech-to-text提供商。 ![\[选择 Deepgram 作为语音提供者的语音模型对话框。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/Lex/04-speech-model-deepgram.png) ## 第 5 步：输入模型 ID 和 Secrets Manager ARN 1. 在**型号 ID** 中，输入提供商的型号名称。 + 有些提供商要求提供最小或最大长度。 + 模型区 IDs 分大小写，并且必须与提供者文档相匹配。 1. 在 S **ecrets Manager ARN** 中，输入包含提供者 API 密钥的密钥的 ARN。 + 该密钥必须与您的 Amazon Connect 实例位于同一区域。 + Secrets Manager 和 KMS 密钥策略必须允许 Amazon Connect 访问和解密密钥。有关更多信息，请参阅 [管理密钥和资源策略](managing-secrets-resource-policies.md)。 1. 选择 “**继续**” 以保存您的更改。 ## 生成并激活语言环境 如果语言环境显示**未构建的更改**，请选择**构建语言**。成功构建后，新的 STT 设置将变为活动状态。 ## 运行时行为 (STT) + Amazon Connect 将音频路由到选定的第三方 speech-to-text提供商。 + 无需对流程或 Lambda 函数进行任何更改。 + 日志中 IDs 会出现诸如无效凭证或型号无效之类的错误。 + 指标和分析继续正常运行。 ## 故障排除 (STT) + **型号 ID 无效**：请使用提供商文档确认该值。 + **访问被拒绝**：验证 Secrets Manager 和 KMS 权限。 + **语言环境构建失败**：确保必填字段有效。 + **高延迟**：验证提供商区域配置。 # 配置第三方 text-to-speech (TTS) 提供商 按照以下说明配置第三方 text-to-speech (TTS) 提供商。 ## 先决条件 + 存在联系流（或者您有权创建联系流）。 + 存储在中的 AWS Secrets Manager第三方 TTS 提供商 API 密钥。有关在 Secrets Manager 中将 API 密钥存储为密钥的更多信息，请参阅[创建 AWS Secrets Manager 密](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html)钥。 + 允许 Amazon Connect 检索密钥的 Secrets Manager 资源策略。有关更多信息，请参阅 [管理密钥和资源策略](managing-secrets-resource-policies.md)。 + AWS KMS key 允许解密的权限。有关更多信息，请参阅 [管理密钥和资源策略](managing-secrets-resource-policies.md)。 + 提供商特定的模型和语音值。 ## 步骤 1：打开联系流程 1. 登录 Amazon Connect 管理网站。 1. 选择 “**流程**”。 1. 选择现有流程或创建新流程。 ## 第 2 步：添加或选择设置语音屏蔽 1. 在 Flow 设计器中，搜索 Se **t voic** e。 1. 将方块拖到画布上或选择现有方块。 1. 选择方块以打开其配置面板。 ## 第 3 步：选择第三方 TTS 提供商 在**语音提供商**下拉列表中，选择要使用的第三方 text-to-speech提供商。 ![\[“设置语音” 配置窗格显示了语音提供商的下拉列表。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/Lex/08-set-voice-amazon.png) ## 第 4 步：指定模型、语音、Secrets Manager ARN 和语言 1. 在**模型**下，选择**手动设置**并输入提供者模型。 1. 在 “**语音**” 下，选择 “**手动设置**”，然后输入提供者语音。 1. 在 S **ecrets Manager ARN** 下，选择**手动设置**并输入提供者密钥的 ARN。 + 秘密必须相同 AWS 区域。 + AWS Secrets Manager 而且 KMS 策略必须允许检索和解密。有关更多信息，请参阅 [管理密钥和资源策略](managing-secrets-resource-policies.md)。 1. 在 “**语言**” 下，选择 “**手动设置**”，然后选择提供者语音支持的语言。 ![\[显示 ElevenLabs第三方语音提供商的 “语音提供商” 配置窗格。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/Lex/09-voice-provider-elevenlabs.png) ## 第 5 步：保存并发布流程 1. 在流程设计器中选择 “**保存**”。 1. 选择 “**发布**” 以激活更新的流程设置。 ## 运行时行为 (TTS) + Amazon Connect 会向 TTS 提供商发送文本进行合成。 + 返回的音频将播放给客户。 + 执行日志包括提供程序错误，例如无效的凭据或模型值。 ## 故障排除 (TTS) + **没有音频输出**：验证模型和语音值。 + **身份验证错误**：验证 Secrets Manager 和 KMS 权限。 + **动态属性**：确保运行时值解析为有效的提供程序参数。 + **高延迟**：验证提供商区域对齐情况。 # 第三方 STT 提供商的终端节点和区域 默认情况下，Amazon Connect 与以下终端节点通信： **深度监控：[https://api.deepgram.com](https://api.deepgram.com)** **ElevenLabs**: [https://api.elevenlabs.io](https://api.elevenlabs.io) 作为 JSON 对象的一部分，您可以在 API 密钥旁边指定其他提供商区域： ``` { "apiToken": "XXXXX", "apiTokenRegion": "xx" } ``` 支持以下区域： | **Provider** | **apiTokenRegion** | **Endpoint** | | --- | --- | --- | | 深度格拉姆 | eu | [https://api.eu.deepgram.com](https://api.eu.deepgram.com)（仅支持 speech-to-text） | | 深度格拉姆 | \$1SHORT\$1UID\$1。 \$1REGION\$1SUBDOMAIN\$1 | https://\$1SHORT\$1UID\$1.\$1REGION\$1SUBDOMAIN\$1.api.deepgram.com（Deepgram 专用端点） | | ElevenLabs | us | [https://api.us.elevenlabs.io](https://api.us.elevenlabs.io) | | ElevenLabs | eu | [https://api.eu.residency.elevenlabs.io](https://api.eu.residency.elevenlabs.io) | | ElevenLabs | in | [https://api.in.residency.elevenlabs.io](https://api.in.residency.elevenlabs.io) | # 管理密钥和资源策略 [配置第三方语音提供者](configure-third-party-speech-providers.md)时，需要在 Secrets Manager 中创建一个包含语音提供者的 API 密钥的密钥。创建密钥的过程分为两步： + 创建包含 API 密钥的密钥。有关说明，请参阅[创建 AWS Secrets Manager 密钥](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html)。 + 配置必要的权限： + 将基于资源的策略附加到密钥。 + 将基于资源的策略附加到与密钥关联的 KMS 密钥（不是 API 密钥）。KMS 密钥保护密钥中的 API 密钥。 这些策略允许 Amazon Connect 访问密钥中的 API 密钥。请注意，您不能使用默认 `aws/secretsmanager` KMS 密钥；必须创建新密钥或使用现有的客户管理的密钥。有关 KMS 密钥如何保护机密的更多信息，请参阅 Secrets Manager [中的密钥加密和解密](https://docs.aws.amazon.com/secretsmanager/latest/userguide/security-encryption.html)。 确保密钥的基于资源的策略包括`aws:SourceAccount`和`aws:SourceArn`混淆的副手条件（请参阅混淆的[副手问题](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html)），并且 KMS 密钥的基于资源的策略包含该`kms:EncryptionContext:SecretARN`条件。这将确保 Amazon Connect 只能在单个特定实例的环境中访问您的 API 密钥密钥，并且只能在该实例和特定密钥的上下文中访问您的 KMS 密钥。 ## Secrets Manager 密钥基于资源的策略示例 以下是您可以附加到密钥的基于资源的策略的示例。 ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": [ "connect.amazonaws.com" ] }, "Action": "secretsmanager:GetSecretValue", "Resource": "*", "Condition": { "ArnLike": { "aws:sourceArn": "///the ARN of your Amazon Connect instance///" }, "StringEquals": { "aws:sourceAccount": "///Your account ID///" } } } ] } ``` ## s 的基于资源的策略示例 AWS KMS key 以下是您可以附加到 KMS 密钥的基于资源的策略的示例。 ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": [ "connect.amazonaws.com" ] }, "Action": "kms:Decrypt", "Resource": "*", "Condition": { "ArnLike": { "aws:sourceArn": "///the ARN of your Amazon Connect instance///" }, "StringEquals": { "aws:sourceAccount": "///Your account ID///", "kms:EncryptionContext:SecretARN": "///the ARN of your secrets manager secret///" } } } ] } ``` ## 将基于资源的策略附加到你的 Secrets Manager 密钥 要将基于资源的策略附加到您的密钥，请转到中的 Secrets Manager 控制台 AWS 管理控制台，导航到您的密钥，选择**编辑权限****或资源权限**，然后直接在页面上添加或修改资源策略，使其看起来与[示例](#example-resource-policy-secrets-manager)类似。您也可以通过的`put-resource-policy`命令附加资源策略，或者使用 [PutResourcePolicy](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutResourcePolicy.html)API 操作以编程方式附加资源策略。 AWS CLI ## 将基于资源的策略附加到您的 KMS 密钥 要将基于资源的策略附加到您的 KMS 密钥，请转到中的 AWS Key Management Service 控制台 AWS 管理控制台，导航到您的 KMS 密钥并编辑您的密钥策略，使其与[示例](#example-resource-policy-kms-keys)类似。您也可以通过的`put-key-policy`命令更新密钥，或者使用 [PutKeyPolicy](https://docs.aws.amazon.com/kms/latest/APIReference/API_PutKeyPolicy.html)API 操作以编程方式更新密钥。 AWS CLI ## 轮换 API 密钥 我们建议至少每 90 天轮换 API 密钥，以最大限度地降低泄露风险，并在紧急情况下保持经过良好实践的密钥轮换流程。 要轮换 API 密钥，必须轮换包含该密钥的密钥。有关如何[轮换密钥](https://docs.aws.amazon.com/secretsmanager/latest/userguide/rotating-secrets.html)的更多信息，请参阅 S *ecrets Manager 用户指南*中的轮换 Secrets Manager 密钥。轮换 API 密钥时，建议您等待先前密钥的使用量降至零，然后再撤消旧的 API 密钥，以确保正在进行的请求不会受到影响。 # 从 Amazon Connect 实例创建 Connect 人工智能代理意图 通过启用 [AMAZON，您可以将由 Connect 人工智能代理提供支持的生成人工智能功能用于您的机器人。 QinConnectIntent](https://docs.aws.amazon.com/lexv2/latest/dg/built-in-intent-qinconnect.html)在你的机器人里。这是一个 Amazon Lex 内置意图。 完成以下步骤以启用 Connect AI 代理。 1. 打开您要为其添加**亚马逊的机器人。 QinConnectIntent**意图。 1. 导航到机器人构建器界面中的**配置**选项卡。 1. 启用**亚马逊。 QinConnectIntent**通过将切换开关设置为开启来实现意图。下图显示开关的位置。 ![\[未配置的机器人的配置页面示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/enable-qic-bot.png) 只有在 Amazon Connect 管理网站中直接创建的机器人才支持 **Connect AI 代理意图**开关。要将 Amazon Q 功能添加到在 Amazon Connect 管理网站之外创建的机器人的意图中，请使用 Amazon Lex 控制台更新配置。 1. 在 “**启用 Connect AI 代理意图**” 对话框中，使用下拉菜单选择 Connect AI 代理意图的亚马逊资源名称 (ARN)。 ![\[启用 Connect AI 代理意图对话框。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/qic-intent-dropdownbox.png) 1. 选择 “**确认**” 以添加**亚马逊。 QinConnectIntent**意图支持。 **重要** 您不能使用**亚马逊。 **QInConnectIntent**以及没有具体言论的意图，例如 Amazon.qn、**亚马逊AIntent**。 BedrockAgentIntent**在同一个机器人区域中。有关更多信息，请参阅[亚马逊。 QinConnectIntent](https://docs.aws.amazon.com/lexv2/latest/dg/built-in-intent-qinconnect.html)在 *Amazon Lex V2 开发者指南*中。 # 在 Amazon Connect 中创建机器人版本和别名 为了控制您的客户端使用哪个机器人实现，您需要创建版本和别名。 + 版本相当于您的工作的带编号快照。 + 您可以为您希望向客户提供的机器人版本指定别名。 在创建版本之间的时间段里，您可以继续更新机器人的草稿版本，而不会影响客户的体验。此过程对于在生产环境中部署机器人至关重要。 ## 创建版本 创建新版本会保留机器人配置的当前状态。完成以下步骤，在 Amazon Connect 中创建新版本的 Amazon Lex 机器人。 1. 打开您想要为其创建新版本的机器人。 1. 选择**版本**选项卡，然后选择**创建版本**。 ![\[“版本”选项卡，“创建版本”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/bot-versionstab.png) 1. 在**创建版本**对话框中： 1. 输入版本描述（可选但建议输入，以便跟踪更改） 1. 选择**创建**。下图显示**创建版本**对话框示例。 ![\[“创建版本”对话框。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/create-version-bot.png) 创建版本后，您可以将其与别名相关联，或者使用它恢复到机器人之前的状态。 ## 创建 别名 别名是指向自动程序特定版本的指针。利用别名，您可以轻松更新您的客户端应用程序正在使用的版本。例如，您可以将别名指向您机器人的版本 1。当您准备好更新机器人时，可以创建版本 2，然后更改别名以指向新版本。由于您的应用程序使用的是别名而不是特定版本，因此您的所有客户端无需进行更新即可获得新功能。这允许进行可控的发布和轻松的版本管理。 **重要** 如果要在流中使用机器人，请务必在创建别名时选择**启用在流和流模块中使用**。 完成以下步骤，为您的 Amazon Lex 机器人创建别名。 1. 打开您要为其添加别名的机器人。 1. 选择**别名**选项卡，然后选择**创建别名**。 ![\[“别名”选项卡，“创建别名”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/bot-aliases-button.png) 1. 在**创建别名**对话框中： 1. 为别名输入一个唯一的名称。 1. 为别名提供一个描述（可选但建议提供）。 1. 选择要与此别名关联的机器人版本。 1. （推荐）选择**启用在流和流模块中使用**。如果您想在流中使用该机器人，此项是必需的。 1. 选择**创建**。下图显示**创建别名**对话框示例。 ![\[“创建别名”对话框。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/bot-create-alias.png) 有关 Amazon Lex V2 中版本和别名的更多信息，请参阅《Amazon Lex V2 开发人员指南》**中的 [Lex V2 机器人的版本控制和别名](https://docs.aws.amazon.com/lexv2/latest/dg/versions-aliases.html)。 # 评估在 Amazon Connect 中您的对话式 AI 机器人的性能 您可以使用 Amazon Connect 中的综合分析工具来帮助评估和优化对话式 AI 机器人的性能。这些见解使您能够识别成功的互动、查明失败点并可视化对话模式，从而持续改善客户体验。 分析控制面板包括关键指标，例如“话语识别率”和“对话性能”。这些指标可帮助您了解机器人与客户互动的成功率和失败率。 **注意** “机器人分析”页面仅显示由流触发的对话数据。您可以使用 Lex APIs 或自定义集成在外部触发机器人，但这些对话的数据不会反映在此页面上。 **查看机器人的分析数据** 1. 登录 Amazon Connect 管理员网站 https://*instance name*.my.connect.aws/。使用管理员账户或在其安全配置文件中具有下列权限的账户： + **通道和流** - **机器人** - **查看** + **通道和流** - **机器人** - **编辑** + **分析和优化** - **历史指标** - **访问** 1. 在左侧的导航菜单中，选择**路由**、**流**。 1. 在**流**页面上，选择**机器人**，选择要评估其性能的机器人，然后选择**分析**。 ![\[“流”页面，“分析”选项卡。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/bot-analytics1.png) 下图显示分析数据示例。 ![\[“分析”选项卡，其中包含一个机器人的分析数据示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/bot-analytics.png) 使用这些分析来识别改进机会，完善机器人的响应并改善整体客户体验。 有关特定于 Amazon Lex 的其他指标和高级分析技术，请参阅[在 Lex V2 中监控机器人性能](https://docs.aws.amazon.com/lexv2/latest/dg/monitoring-bot-performance.html)。 # Amazon Connect 机器人指标和分析 [流和对话机器人性能控制面板](flows-performance-dashboard.md)和 [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) 上提供了以下流量驱动指标。 ## 平均机器人对话时间 该指标衡量调用资源（流或流模块）在指定的开始时间和结束时间之间启动的已完成对话的平均持续时间。 **指标类型**：字符串（*hh:mm:ss*） **指标类别**：流驱动的指标 **如何使用 Amazon Connect API 进行访问**： + [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API 指标标识符：`AVG_BOT_CONVERSATION_TIME` 可以使用 `BOT_CONVERSATION_OUTCOME_TYPE` 指标级别过滤器根据特定的对话结果进行筛选。 **计算逻辑**： + （将所有筛选出的对话从开始到结束所经历的时间相加所得到的总和）/(筛选出的所有对话总数) **备注**： + 该指标的数据从格林威治标准时间 2024 年 12 月 2 日 00:00:00 开始提供。 ## 平均机器人对话回合数 该指标提供调用资源（流或流模块）在指定的开始和结束时间之间启动的已完成对话的平均回合数。 一个回合是指来自客户端应用程序的一个请求以及来自机器人的一个响应。 **指标类型**：双精度 **指标类别**：流驱动的指标 **如何使用 Amazon Connect API 进行访问**： + [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API 指标标识符：`AVG_BOT_CONVERSATION_TURNS` 可以使用 `BOT_CONVERSATION_OUTCOME_TYPE` 指标级别过滤器根据特定的对话结果进行筛选。 **计算逻辑**： + （所有筛选出的对话的总回合数）/（所有筛选出的对话的数量） **备注**： + 该指标的数据从格林威治标准时间 2024 年 12 月 2 日 00:00:00 开始提供。 ## 已完成的机器人对话数 该指标提供调用资源（流或流模块）在指定的开始和结束时间之间启动的已完成对话的数量。对话结束时间可以超过指定的结束时间。 例如，如果您请求该指标的开始时间为上午 9 点，结束时间为上午 10 点，则结果将包括调用资源（流或流模块）符合以下条件的对话： + 上午 9:15 开始，上午 9:40 结束 + 上午 9:50 开始，上午 10:10 结束 但会排除调用资源（流或流模块）符合以下条件的对话： + 上午 8:50 开始，上午 9:10 结束 **指标类型**：整数 **指标类别**：流驱动的指标 **如何使用 Amazon Connect API 进行访问**： + [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API 指标标识符：`BOT_CONVERSATIONS_COMPLETED` 可以使用指标级别筛选器 `BOT_CONVERSATION_OUTCOME_TYPE` 根据以下对话结果对其进行筛选。 + 成功：对话的最终意图被归类为*成功*。 + 失败：对话的最终意图为失败。如果 Amazon Lex V2 默认为 `AMAZON.FallbackIntent`，则对话也被归类为失败。 + 已删除：在该对话被归类为*成功*或*失败*之前，客户没有做出回应。 **计算逻辑**： + 对话的总计数。 **备注**： + 该指标的数据从格林威治标准时间 2024 年 12 月 2 日 00:00:00 开始提供。 ## 已完成的机器人意图数 该指标提供已完成意图的计数。其中包括调用资源（流或流模块）在指定的开始和结束时间之间启动的已完成对话的意图。 **指标类型**：整数 **指标类别**：流驱动的指标 **如何使用 Amazon Connect API 进行访问**： + [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API 指标标识符：`BOT_INTENTS_COMPLETED` 可以使用指标级别筛选器 `BOT_CONVERSATION_OUTCOME_TYPE` 根据以下对话结果对其进行筛选。 可以使用指标级别筛选器 `BOT_INTENTS_OUTCOME_TYPE` 根据以下意图结果对其进行筛选。 + 成功：机器人成功履行了意图。满足以下条件之一： + *意图*状态*为 *ReadyForFulfillment*，Di *alogAction* 的类型为 “关闭”。* + 意图 `state` 为 `Fulfilled`，并且 `dialogAction` 的类型为 `Close`。 + 失败：机器人未能履行意图。意图状态。满足以下条件之一： + 意图 `state` 是 `Failed`，并且 `dialogAction` 的 `type` 是 `Close`（例如，用户拒绝了确认提示）。 + 机器会在意图完成之前切换到 `AMAZON.FallbackIntent`。 + 已切换：在最初的意图被归类为*成功*或*失败*之前，机器人识别出另一个不同意图并且切换到该意图。 + 已删除：在该意图被归类为*成功*或*失败*之前，客户没有做出回应。 **计算逻辑**： + 意图的总计数。 **备注**： + 该指标的数据从格林威治标准时间 2024 年 12 月 2 日 00:00:00 开始提供。 ## 机器人对话结果百分比 该指标提供以指标级别筛选器（`BOT_CONVERSATION_OUTCOME_TYPE`）中指定的特定结果类型结束的对话总数的百分比。其中仅包括调用资源（流或流模块）在指定的开始和结束时间之间启动的已完成对话。 **指标类型**：百分比 **指标类别**：流驱动的指标 **如何使用 Amazon Connect API 进行访问**： + [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API 指标标识符：`PERCENT_BOT_CONVERSATIONS_OUTCOME` **如何使用 Amazon Connect 管理员网站进行访问**： **计算逻辑**： + （采用 BOT\$1CONVERSATION\$1OUTCOME\$1TYPE 的对话次数）/（对话总数）\$1 100 **备注**： + 该指标的数据从格林威治标准时间 2024 年 12 月 2 日 00:00:00 开始提供。 ## 机器人意图结果百分比 该指标提供以指标级别筛选器（`BOT_INTENT_OUTCOME_TYPE`）中指定的特定结果类型结束的意图的百分比。其中包括调用资源（流或流模块）在指定的开始和结束时间之间启动的已完成对话的意图。 **指标类型**：百分比 **指标类别**：流驱动的指标 **如何使用 Amazon Connect API 进行访问**： + [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API 指标标识符：`PERCENT_BOT_INTENTS_OUTCOME` **如何使用 Amazon Connect 管理员网站进行访问**： **计算逻辑**： + （采用 BOT\$1INTENT\$1OUTCOME\$1TYPE 的意图计数）/（意图总数）\$1 100 # Amazon Connect 提供的机器人高级配置支持 高级配置功能使您无需前往 Amazon Lex 控制台即可对机器人进行详细的自定义。 1. 在 Amazon Connect 管理网站的左侧导航栏中，选择 Fl **ows**。选择**机器人**选项卡，然后选择要使用的机器人。 1. 选择**高级配置**按钮，如下图所示。 ![\[机器人详情页面上的“高级配置”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/bot-advanced-config.png) 此操作会将视图切换到更详细的界面，您可以在其中访问更多功能来自定义机器人。 1. 要切换回简单的机器人用户界面，请选择**配置摘要**，如下图所示。 ![\[“高级配置”页面，“配置摘要”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/bot-adv-config2.png) # 将 Amazon Lex 自动程序添加到 Amazon Connect **重要** **终止支持通知**：2025年9月15日， AWS 我们将停止对Amazon Lex V1的支持。2025 年 9 月 15 日之后，您将无法再访问 Amazon Lex V1 控制台或 Amazon Lex V1 资源。要了解如何迁移到 Amazon Lex V2，请参阅[迁移机器人](https://docs.aws.amazon.com/lex/latest/dg/migrate.html)。 在本文中，我们将指导您完成将 Amazon Lex 自动程序添加到 Amazon Connect 的步骤。 借助 Amazon Lex，您可以建立对客户来说感觉很自然的对话互动（自动程序）。在 Amazon Connect 流中使用 Amazon Connect 中的 Amazon Lex 自动程序时，还可以捕获客户输入的数字，即客户在数字键盘上输入的数字。这样，客户可以选择他们要如何输入敏感信息（如账号）。 要按本演练进行操作，您需要以下各项： + 一个活跃的 AWS 账户。 + 一个 Amazon Connect 实例 **提示** 您还可以使用 Amazon Lex 为 Amazon Connect 聊天提供交互式消息。交互式消息包含丰富的消息，提供提示和预置的显示选项，客户可以从中选择。这些消息由 Amazon Lex 提供支持，并使用 Lambda 通过 Amazon Lex 进行配置。有关更多信息，请参阅 [在聊天中为客户添加 Amazon Lex 互动消息](interactive-messages.md)。 ## 创建 Amazon Lex 自动程序 在此步骤中，您将创建一个自定义自动程序，以演示按下或说出操作与 Amazon Connect 的集成。自动程序提示呼叫方按下或说出与要完成任务的菜单选项相匹配的数字。在这种情况下，输入的目的是检查账户余额。 ------ #### [ Amazon Lex ] 1. 打开 [Amazon Lex 控制台](https://console.aws.amazon.com/lexv2/home)。 1. 选择**创建自动程序**。 1. 在**配置自动程序设置**页面，选择**创建 - 创建空白自动程序**并提供以下信息： + **机器人名称** — 在本演练中，请命名机器人**AccountBalance**。 + **IAM 权限** - 如果您已创建角色，请选择一个角色。否则，请选择**创建具有基本 Amazon Lex 权限的角色**。 + **COPPA** - 选择自动程序是否符合《儿童在线隐私保护法案》的要求。 + **会话超时** - 选择自动程序在结束会话之前需等待多长时间才能获得呼叫方输入。 1. 选择**下一步**。 1. 提供语言和语音的特定信息： + **语言** - 从 [Amazon Lex 支持的语言和区域](https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html)列表中选择语言和区域。 + **语音交互** - 为您的自动程序选择对呼叫方说话时要使用的语音。Amazon Connect 的默认声音是 Joanna。 1. 选择**完成**。 AccountBalance 机器人已创建，并显示 “**意图**” 页面。 ------ #### [ Amazon Lex (Classic) ] 1. 打开 [Amazon Lex 控制台](https://console.aws.amazon.com/lex/)。 1. 如果这是您第一次创建自动程序，请选择**开始**。否则，依次选择**自动程序、创建**。 1. 在**创建自动程序**页面，选择**自定义自动程序**并提供以下信息： + **机器人名称** — 在本演练中，请命名机器人**AccountBalance**。 + **输出语音** - 为您的自动程序选择对呼叫方说话时要使用的语音。Amazon Connect 的默认声音是 Joanna。 + **会话超时** - 选择自动程序在结束会话之前需等待多长时间才能获得呼叫方输入。 + **COPPA** - 选择自动程序是否符合《儿童在线隐私保护法案》的要求。 1. 选择**创建**。 ------ ## 配置 Amazon Lex 自动程序 在此步骤中，您将通过提供目的、示例话语、输入槽和错误处理，以确定自动程序如何对客户进行响应。 在本示例中，您将为自动程序配置两个目的：一个是查找账户信息，另一个是与座席交谈。 ### 创建 AccountLookup 意图 ------ #### [ Amazon Lex ] 1. 创建自动程序后，您将进入 Amazon Lex 控制台的**意图**页面。如果你不在那里，你可以通过选择 B **ots**、、**Bot 版本**AccountBalance**、**草稿版本****、**Intents** 来实现目标。选择**添加意图**、**添加空意图**。 1. 在 “**意图名称**” 框中输入**AccountLookup**。 1. 向下滚动页面至**示例言语**。在此步骤中，您输入允许客户表达意图的话语。 AccountLookup 输入以下言语，然后在每个言语后面选择**添加言语**。 + **查看我的账户余额** + **第一：这会将 “一个**” 的说法或按下 “1” 的键盘分配给意图。**AccountLookup** 下图显示了在**示例言语**部分添加言语的位置。 ![\[“意图”页面的示例言语部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/lexv2-enter-utterances.png) 1. 滚动到**槽值**部分，然后选择**添加槽值**。按如下说明完成操作： 1. **此意图为必需的** = 已选中。 1. **姓名** = **AccountNumber**。 1. **槽值类型** = **AMAZON.Number**。 1. **提示** = 接听电话时要说的文本。例如，要求呼叫方使用小键盘输入其账号：**请使用按键式小键盘输入您的账号**。选择**添加**。 下图显示了已完成的**添加槽值**部分。 ![\[“意图”页面的添加槽值部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/lexv2-add-slots.png) 1. 滚动到**关闭响应**部分。添加自动程序要对客户说的一条信息。例如，**您的账户余额为 \$11,234.56**。（在本演练中，我们不会真正获取数据，而现实中您要这样做。） 下图显示了已完成的**关闭响应**部分。 ![\[“意图”页面的关闭响应部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/lexv2-response1.png) 1. 选择**保存意图**。 ------ #### [ Amazon Lex (Classic) ] 1. 在 Amazon Lex 控制台中，选择**意图**旁边的 **\$1** 图标，然后选择**创建新意图**。 1. 命名意图**AccountLookup**。 1. 添加示例言语，如*检查我的账户余额*，然后选择 **\$1** 图标。 1. 添加另一个话语，例如*一*并选择 **\$1** 图标。这会将 “一个” 的说法或按下 “1” 的键盘分配给意图。**AccountLookup** **提示** 您必须在自动程序中添加言语“一”，而不是数字“1”。这是因为 Amazon Lex 不直接支持数字输入。为了解决这个问题，在本演练后面，您将使用数字输入与从流调用的 Lex 自动程序进行交互。 1. 在 “**老虎机**” 下，添加一个名为的插槽**AccountNumber**。 下图显示了页面上**槽值**部分的位置。 ![\[“意图”页面的槽值部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/lex-slots.png) 1. 对于**槽类型**，使用下拉列表选择 **AMAZON.NUMBER**。 1. 对于**提示**，添加接听电话时要说的文本。例如，要求呼叫方使用小键盘输入其账号：*请使用按键式小键盘输入您的账号*。 1. 选择 \$1 图标。 1. 确保选中**必需**复选框。 1. 在**响应**部分，添加自动程序要对客户说的一条信息。例如，**您的账户余额为 \$11,234.56**。 1. 选择 **Save Intent (保存目的)**。 ------ ### 创建 SpeakToAgent 意图 ------ #### [ Amazon Lex ] 1. 导航至**意图**页面：选择**返回意图列表**。 1. 选择**添加意图**、**添加空意图**。 1. 在 “**意图名称**” 框中输入 **SpeakToAgent**，然后选择**添加**。 1. 向下滚动至**示例言语**部分。输入以下话语，让客户能够表达意图： SpeakToAgent + **与座席交谈** + **二** 1. 向下滚动至**关闭响应**部分。添加自动程序要对客户说的一条信息。例如，**好的，座席将马上与您联系**。 1. 选择**保存意图**。 ------ #### [ Amazon Lex (Classic) ] 1. 在 Amazon Lex 控制台中，选择**意图**旁边的 **\$1** 图标，然后选择**创建新意图**。 1. 命名意图**SpeakToAgent**。 1. 选择 **SpeakToAgent**。 1. 添加示例言语，例如*与座席交谈*，然后选择 **\$1**。 1. 添加另一个言语，例如*二*，并选择 **\$1**。 1. 添加一条消息，让呼叫方知道其呼叫正在连接到座席。例如，“好的，座席将马上与您联系。” 1. 选择 **Save Intent (保存目的)**。 ------ ## 构建和测试 Amazon Lex 自动程序 在创建自动程序后，确保其可按预期正常工作。 ------ #### [ Amazon Lex ] 1. 在页面底部，选择**构建**。这可能需要一两分钟。下图显示了**构建**按钮的位置。 ![\[“构建”按钮在页面上的位置。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/lexv2-build-test-intent.png) 1. 构建完成后，选择**测试**。 1. 让我们测试一下**AccountLookup**意图：在 “**测试草稿版本” 窗格的** “**键入消息**” 框中，键入 **1**，然后按 Enter。然后键入一个虚构的账号并按下 Enter。下图显示了在哪里输入意图。 ![\[键入测试意图的框。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/lexv2-test1.png) 1. 清除测试框。 1. 键入要测试的意图。 1. 要确认**SpeakToAgent**意图是否有效，请清除测试框，然后键入 **2** 并按 Enter。下图显示了清除测试然后输入 2 后测试的样子。 ![\[测试框。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/lexv2-test2.png) 1. 关闭**测试草稿版本**面板。 ------ #### [ Amazon Lex (Classic) ] 1. 选择**构建**。这可能需要一两分钟。 1. 在构建完成后，选择**测试聊天自动程序**，如下图中所示。 ![\[在页面右侧的“测试聊天自动程序”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/lex-test-chatbot.png) 1. **让我们来测试一下**AccountLookup**意图：在 “**测试聊天机器人” 窗格的 “与你的机器人****聊天**” 框中，键入 1。**然后，键入虚构的账号。在下图中，箭头指向您要键入 1 的框。 ![\[测试自动程序，用于键入消息的框。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/lex-test-run.png) 1. 选择**清除聊天历史记录**。 1. 要确认**SpeakToAgent**意图是否有效，请键入 **2**。 ------ ## 创建自动程序版本（可选） 在此步骤中，您将创建一个新的自动程序版本以在别名中使用。这就是创建可在生产环境中使用的别名的方式。测试别名受较低的节流限制。尽管这是一个测试演练，但创建版本仍是最佳实践。 ------ #### [ Amazon Lex ] 1. 如果您在**意图**页面，选择**返回意图列表**。 1. 在左侧菜单上，选择**自动程序版本**。 1. 选择**创建版本**。 1. 查看**AccountBalance**机器人的详细信息，然后选择 “**创建**”。 这会创建您的自动程序版本（版本 1）。您可以在非测试别名上切换版本，不必跟踪要发布的版本。 ![\[列出了版本 1 的“版本”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/lexv2-version1.png) ------ ## 为自动程序创建别名 ------ #### [ Amazon Lex ] 1. 在左侧菜单中，选择**别名**。 1. 在**别名**页面，选择**创建别名**。 1. 在**别名**框中，输入一个名称，例如**测试**。在本演练的稍后部分，您将使用此别名在流中指定此自动程序的版本。 **重要** 在生产环境中，请务必使用与 Amazon Lex 不同的别名，**TestBotAlias**对于 Amazon Lex classic，请务必使用**与 \$1** LATEST 不同的别名。 **TestBotAlias**而且 **\$1LATES** T 支持对 Amazon Lex 机器人进行有限数量的并发调用。有关更多信息，请参阅[运行时系统份额](https://docs.aws.amazon.com/lexv2/latest/dg/quotas.html#quotas-service)。 1. 对于**关联版本**，请选择您刚刚创建的版本，例如**版本 1**。 1. 选择**创建**。 ------ #### [ Amazon Lex (Classic) ] 1. 选择**发布**。 1. 为自动程序提供别名。使用别名在流中指定此自动程序的版本，例如，**测试**。 **重要** 在生产环境中，请务必使用与 Amazon Lex 不同的别名，**TestBotAlias**对于 Amazon Lex classic，请务必使用**与 \$1** LATEST 不同的别名。 **TestBotAlias**而且 **\$1LATES** T 支持对 Amazon Lex 机器人进行有限数量的并发调用。有关更多信息，请参阅[运行时系统服务限额](https://docs.aws.amazon.com/lex/latest/dg/gl-limits.html#gl-limits-runtime)。 1. 选择**发布**。 ------ ## 将 Amazon Lex 自动程序添加到您的 Amazon Connect 实例 ------ #### [ Amazon Lex ] 1. 打开 [Amazon Connect 控制台](https://console.aws.amazon.com/connect/)。 1. 选择要与 Amazon Lex 自动程序集成的 Amazon Connect 实例。 ![\[“Amazon Connect 虚拟联系中心实例”页面，实例别名。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/instance.png) 1. 在导航菜单上，选择**流**。 1. 在 **Amazon Lex** 下，使用下拉列表选择你的 Amazon Lex 机器人的区域，然后选择你的 Amazon Lex 机器人**AccountBalance**。 1. 从下拉列表中选择 Amazon Lex 自动程序别名（**测试**），然后选择 **\$1 添加 Lex 自动程序**。下图显示了配置后的 Amazon Lex 部分。 ![\[流页面的 Amazon Lex 部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/lexv2-region-bot.png) **注意** Amazon Connect 使用 Amazon Lex 基于资源的策略来调用您的 Amazon Lex 自动程序。当您将一个 Amazon Lex 自动程序与 Amazon Connect 实例关联时，该自动程序上基于资源的策略会更新，以授予 Amazon Connect 调用该自动程序的权限。有关 Amazon Lex 基于资源的策略的更多信息，请参阅 [Amazon Lex 如何与 IAM 配合使用](https://docs.aws.amazon.com/lexv2/latest/dg/security_iam_service-with-iam.html#security_iam_service-with-iam-resource-based-policies)。 ------ #### [ Amazon Lex (Classic) ] 1. 打开 [Amazon Connect 控制台](https://console.aws.amazon.com/connect/)。 1. 选择要与 Amazon Lex 自动程序集成的 Amazon Connect 实例。 1. 在导航菜单上，选择**联系流** 1. 在 **Amazon Lex** 下，从下拉列表中选择 Amazon Lex Classic 自动程序的区域，然后选择您的 Amazon Lex Classic 自动程序。它的名字将带有后缀“(Classic)”。然后选择**添加 Lex 自动程序**。 ------ ## 创建流并添加您的 Amazon Lex 自动程序 **重要** 如果您使用的是 Amazon Lex V2 自动程序，则您在 Amazon Connect 中的语言属性必须与构建 Lex 自动程序时使用的语言模型相匹配。这与 Amazon Lex (Classic) 不同。使用[设置语音](set-voice.md#set-voice-lexv2bot)数据块指示 Amazon Connect 语言模型，或者使用[设置联系属性](set-contact-attributes.md)数据块。 接下来，创建使用 Amazon Lex 自动程序的新流。当您创建流时，您需要配置播放给呼叫方的信息。 1. 使用对联系流和 Amazon Lex 自动程序具有权限的账户登录到您的 Amazon Connect 实例。 1. 在导航菜单上，选择**路由、流、创建流**，然后键入流的名称。 1. 在**交互**下，将[获取客户输入](get-customer-input.md)块拖到设计器中，然后将它连接到**入口点块**。 1. 选择**获取客户输入**数据块打开它。选择**文字转语音或聊天文本、输入文本**。 1. 键入一条消息向呼叫方提供有关他们可以执行什么操作的信息。例如，使用与机器人中使用的意图相匹配的消息，譬如“查询账户余额，请按 1 或说 1。联系座席，请按 2 或说 2。” 此消息在下图**获取客户输入**数据块的“属性”页面上显示。 ![\[“获取客户输入”数据块的“属性”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/lex-get-customer-input.png) 1. 选择 **Amazon Lex** 选项卡，如下图中所示。 ![\[“获取客户输入”数据块的“属性”页面上的 Amazon Lex 选项卡。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/lexv2-get-customer-input2.png) 1. 在 “**名称**” 下拉列表中，选择您之前创建的**AccountBalance**机器人。 1. 如果您选择了 Amazon Lex 自动程序，请在**别名**下使用下拉菜单选择自动程序别名，即**测试**。 1. Amazon Lex Classic 自动程序的名字后面有后缀“(Classic)”。如果您选择了 Classic 自动程序，请在**别名**字段中输入要使用的别名。 1. 对于 Amazon Lex V2 自动程序，您还可以选择手动设置自动程序别名 ARN。选择**手动设置**，然后键入要使用的自动程序别名的 ARN，或者使用动态属性设置 ARN。 1. 在**意图**下，选择**添加意图**。 1. 键入**AccountLookup**并选择 “**添加其他意图**”。下图显示了使用此信息配置的**意图**部分。 ![\[Amazon Lex 选项卡的“意图”部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/lex-get-customer-input3.png) 1. 键入**SpeakToAgent**并选择 “**保存**”。 ### 完成流 在此步骤中，您将完成向流中添加呼叫方与自动程序交互后运行的部分： 1. 如果呼叫方按 1 来获得他们的账户余额，使用**提示**数据块来播放信息并断开呼叫连接。 1. 如果呼叫方按 2 来与座席说话，请使用**设置队列**数据块以设置队列并将呼叫方转接到队列，这会终止流。 以下是创建流的步骤： 1. 在 In **ter** act 下，将 **Play 提示块**拖到设计器上，然后将 “**获取客户输入**” 块的**AccountLookup**节点连接到设计器。客户从 Amazon Lex 自动程序获取账户余额后，会播放**播放提示**数据块中的消息。 1. 在**结束/转接**下，将**断开链接**数据块拖入设计器，并与**播放提示**数据块连接。播放该提示信息后，呼叫会断开连接。 要完成**SpeakToAgent**意图，请执行以下操作： 1. 添加 **Set 工作队列**块并将其连接到 Ge **t 客户输入**块的**SpeakToAgent**节点。 1. 添加**转接到队列**数据块。 1. 将**设置客户队列流**数据块的成功节点连接到**转接队列**。 1. 选择**保存**，然后选择**发布**。 已结束的流类似于以下图像。流从**获取客户输入**数据块开始。该数据块会分支到**播放提示**或**设置客户队列**。 ![\[流设计器中已完成的流。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/lex-contactflow-designer.png) **提示** 如果您的企业在单个自动程序中使用多个区域设置，请在流的开头添加一个[设置联系属性](set-contact-attributes.md)数据块。将此区块配置为使用 [\$1。 LanguageCode](connect-attrib-list.md#attribs-system-table)系统属性。 ## 将流分配给电话号码 当客户呼叫联络中心时，他们被送到的流是分配给他们呼叫的电话的流。要激活新的流，请将其分配给实例的一个电话号码。 1. 打开 Amazon Connect 控制台。 1. 选择**路由、电话号码**。 1. 在**管理电话号码**页面，选择要分配给流的电话号码。 1. 添加描述。 1. 在**流/IVR** 菜单中，选择您刚刚创建的流。 1. 选择**保存**。 ## 试试看！ 要测试自动程序和流，请呼叫您分配给流的号码。按照提示操作。 # 使用聊天频道和 Amazon Lex 的最佳实践 以下是一些将聊天频道和 Amazon Lex 结合使用的最佳实践。 + 您可以对语音和聊天通道使用同一自动程序。但是，您可能希望自动程序根据渠道做出不同的响应。例如，您希望为语音返回 SSML，以便将数字作为电话号码读取，但您希望向聊天返回正常文本。您可以通过传递**渠道**属性来实现此目的。有关说明，请参阅[如何对语音和聊天使用同一 Amazon Lex 自动程序](one-bot-voice-chat.md)。 + 对于语音，某些单词最好按照发音拼写以获得正确的发音，例如姓氏。如果您的场景是这种情况，请将其包含在自动程序的设计中。或者，您可以保持语音和聊天自动程序分开。 + 告诉座席有关机器人的信息。当联系人连接到座席时，座席将在其窗口中看到整个转录。脚本包括来自客户和自动程序的文本。 # 在聊天中为客户添加 Amazon Lex 互动消息 交互式消息包含丰富的消息，提供提示和预置的显示选项，供客户选择。这些消息由 Amazon Lex 提供支持，并使用 AWS Lambda 函数通过 Amazon Lex 进行配置。 **提示** 如果您已与 Apple Messages for Business 集成，请参阅 Apple 网站上的[交互式消息类型](https://register.apple.com/resources/messages/msp-rest-api/type-interactive)。 ## 验证限制 字符串字段限制（例如标题、副标题等）应由客户端（即自定义构建的界面或托管通信小部件）强制执行。[SendMessage](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_SendMessage.html)API 仅检查字符串的总大小是否小于 20KB。 + 当您使用托管通信小部件而不对其进行自定义时，如果字符串超出字段限制，则会在用户界面上将其截断并附加省略号（...）。您可以通过自定义小组件来确定如何强制执行字段限制。 + 如果您要与其他平台（例如 Apple Messages for Business）集成，请查看本主题中针对 Amazon Connect 的限制，并查看文档中针对其他平台的限制。例如，旧版本的 iOS 不支持快速响应。 要成功发送消息，必须遵守所有其他字段限制。 ## 消息显示模板 Amazon Connect 提供以下消息显示模板。使用它们向聊天中的客户呈现信息： + [列表选择器](#list-picker) + [时间选取器](#time-picker) + [面板](#panel) + [快速回复](#quick-reply-template) + [轮播](#carousel-template) + [Apple 表单模板](#apple-form-template) + [Apple Pay 模板](#apple-pay-template) + [iMessage 应用程序模板](#imessage-app-template) + [WhatsApp list](#whatsapp-list) + [WhatsApp 回复按钮](#whatsapp-reply-button) + [丰富的标题和字幕格式](#rich-link-formatting) 这些模板定义了信息的呈现方式，以及聊天界面中会显示哪些信息。通过聊天发送交互式消息时，流会验证消息格式是否遵循其中一个模板。 ## 列表选择器模板 使用列表选择器模板向客户显示最多六个选项的列表。每个选项都可以有自己的图像。 下图显示了列表选择器模板如何在聊天中呈现信息的两个示例。 + 其中一张图像显示了三个按钮，每个按钮都用文字表示一种水果的名字：苹果、橙子、香蕉。 + 第二张图像显示了一家商店的图片，在商店下方有三个按钮，每个按钮都有水果的名称、图片和价格。 ![\[列表选择器模板在聊天中呈现信息。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/interactive-messages-listpicker-images2.png) 以下代码是您可以在 Lambda 中使用的列表选择器模板。注意以下几点： + **粗体文本**表示必填参数。 + 在某些情况下，如果父元素不是必填项，但父元素中的字段是必填字段，则这些字段就是必填字段。例如，请参阅以下模板中的 `data.replyMessage` 结构。如果该结构存在，则 `title` 为必填项。否则完整的 `replyMessage` 为可选项。 ``` { "templateType":"ListPicker", "version":"1.0", "data":{ "replyMessage":{ "title":"Thanks for selecting!", "subtitle":"Produce selected", "imageType":"URL", "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/fruit_34.3kb.jpg", "imageDescription":"Select a produce to buy" }, "content":{ "title":"What produce would you like to buy?", "subtitle":"Tap to select option", "imageType":"URL", "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/fruit_34.3kb.jpg", "imageDescription":"Select a produce to buy", "elements":[ { "title":"Apple", "subtitle":"$1.00", "imageType":"URL", "imageData":"https://interactive-message-testing.s3-us-west-2.amazonaws.com/apple_4.2kb.jpg" }, { "title":"Orange", "subtitle":"$1.50", "imageType":"URL", "imageData":"https://interactive-message-testing.s3-us-west-2.amazonaws.com/orange_17.7kb.jpg", }, { "title":"Banana", "subtitle":"$10.00", "imageType":"URL", "imageData":"https://interactive-message-testing.s3-us-west-2.amazonaws.com/banana_7.9kb.jpg", "imageDescription":"Banana" } ] } ``` ### 列表选择器限制 如果您选择从头开始构建自己的 Lambda，下表列出了每个列表选择器元素的限制。必填参数以粗体显示。 要发送不受限制的选项，请在应用程序中实施操作按钮。有关更多信息，请参阅[在交互式消息列表选择器/面板中实施操作按钮。](https://github.com/amazon-connect/amazon-connect-chat-interface/blob/master/.github/docs/InteractiveMessageActionButtonImplementation.md) **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/interactive-messages.html) **注意** 如果您正在使用 `targetForLinks` 字段和 Amazon Connect 通信小部件，为了在同一浏览器选项卡中打开链接，您必须在小部件代码片段中添加以下属性，以允许当前 iframe 在同一选项卡中打开并导航链接： ``` amazon_connect('updateSandboxAttributes', 'allow-scripts allow-same-origin allow-popups allow-downloads allow-top-navigation-by-user-activation') ``` ## 时间选取器模板 时间选取器模板非常有用，能让客户安排预约。您最多可以在聊天中向客户提供 40 个时段。 下图显示了时间选取器模板如何在聊天中呈现信息的两个示例。 + 其中一张图像显示了一个日期，在其下方显示了一个时段。 + 第二张图像显示了一个日期，在其下方显示了两个时段。 ![\[时间选取器模板在聊天中呈现信息。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/interactive-messages-timepicker.png) 下图显示了带有图像的时间选择器 **注意** 如果您在 [Apple Messages for Business](apple-messages-for-business.md) 频道中使用此消息模板，但没有添加图片，Amazon Connect 将在回复和响应消息中添加默认图片。 ![\[带有图像的时间选择器。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/interactive-messages-timepicker-with-image.png) 以下代码是您可以在 Lambda 中使用的时间选取器模板。注意以下几点： + **粗体文本**表示必填参数。 + 在某些情况下，如果父元素不是必填项，但父元素中的字段是必填字段，则这些字段就是必填字段。例如，请参阅以下模板中的 `data.replyMessage` 结构。如果该结构存在，则 `title` 为必填项。否则完整的 `replyMessage` 为可选项。 ``` { "templateType":"TimePicker", "version":"1.0", "data":{ "replyMessage":{ "title":"Thanks for selecting", "subtitle":"Appointment selected", "imageType":"URL", "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/booked.jpg", "imageDescription":"Appointment booked" }, "content":{ "title":"Schedule appointment", "subtitle":"Tap to select option", "imageType":"URL", "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/calendar.jpg", "imageDescription":"Appointment booked", "timeZoneOffset":-450, "location":{ "latitude":47.616299, "longitude":-122.4311, "title":"Oscar", "radius":1, }, "timeslots":[ { "date" : "2020-10-31T17:00+00:00", "duration": 60, }, { "date" : "2020-11-15T13:00+00:00", "duration": 60, }, { "date" : "2020-11-15T16:00+00:00", "duration": 60, } ], } } } } ``` ### 时间选取器限制 下表列出了每个时间选取器元素的限制。如果您选择从头开始构建自己的 Lambda，请使用此信息。必填参数以粗体显示。 **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/interactive-messages.html) ## 面板模板 通过使用面板模板，您可以在一个问题下向客户提供最多 10 个选项。但是，只能包含一张图像，而不是每个选项一张。 下图显示了面板模板如何在聊天中呈现信息的示例。它在消息的顶部显示了一张图像，在图像下方显示了一个提示，询问*我该怎么帮您？ 点击选择选项*。在提示下向客户显示了三个选项：**检查自助服务选项**、**与座席交谈**、**结束聊天**。 ![\[面板模板在聊天中呈现信息。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/interactive-messages-panel1.png) 以下代码是您可以在 Lambda 中使用的面板模板。注意以下几点： + **粗体文本**表示必填参数。 + 在某些情况下，如果父元素不是必填项，但父元素中的字段是必填字段，则这些字段就是必填字段。例如，请参阅以下模板中的 `data.replyMessage` 结构。如果该结构存在，则 `title` 为必填项。否则完整的 `replyMessage` 为可选项。 ``` { "templateType":"Panel", "version":"1.0", "data":{ "replyMessage":{ "title":"Thanks for selecting!", "subtitle":"Option selected", }, "content":{ "title":"How can I help you?", "subtitle":"Tap to select option", "imageType":"URL", "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/company.jpg", "imageDescription":"Select an option", "elements":[ { "title":"Check self-service options", }, { "title":"Talk to an agent", }, { "title":"End chat", } ] } } } ``` ### 面板限制 如果您选择从头开始构建自己的 Lambda，下表列出了每个面板元素的限制。必填参数以粗体显示。 要发送不受限制的选项，请在应用程序中实施操作按钮。有关更多信息，请参阅[在交互式消息列表选择器/面板中实施操作按钮。](https://github.com/amazon-connect/amazon-connect-chat-interface/blob/master/.github/docs/InteractiveMessageActionButtonImplementation.md) **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/interactive-messages.html) ## 快速回复模板 使用快速回复消息获得客户的简单回复，以及他们在内联列表中对客户的回复。不支持使用图像进行快速响应。 下图显示了快速回复模板如何在聊天中呈现信息的示例。 ![\[面板模板在聊天中呈现信息。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/quick-reply-template.png) 以下代码是您可以在 Lambda 中使用的快速回复模板。 ``` { "templateType": "QuickReply", "version": "1.0", "data": { "replyMessage": { "title": "Thanks for selecting!" }, "content": { "title": "Which department would you like?", "elements": [{ "title": "Billing" }, { "title": "Cancellation" }, { "title": "New Service" } ] } } } ``` ### 快速回复限制 下表列出了每个快速回复元素的限制。如果您选择从头开始构建自己的 Lambda，请使用此信息。必填参数以粗体显示。 **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/interactive-messages.html) ## 轮播模板 使用轮播在一条消息中向客户显示最多 5 个列表选择器或面板。与列表选择器和时间选取器类似，您可以使用 SHOW\$1MORE 功能向轮播添加更多选项。 以下 GIF 显示了轮播模板如何在聊天中呈现信息的示例。客户使用左右箭头滚动浏览图像轮播。 ![\[客户聊天体验中的轮播。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/carousel-interactive.gif) 下图显示了两个**了解更多**超链接，它们是轮播选择器超链接元素的示例。 ![\[带有超链接的轮播选择器。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/carousel-interactive1.png) 以下代码是您可以在 Lambda 中使用的轮播模板。 ``` { "templateType": "Carousel", "version": "1.0", "data": { "content": { "title": "View our popular destinations", "elements": [ { "templateIdentifier": "template0", "templateType": "Panel", "version": "1.0", "data": { "content": { "title": "California", "subtitle": "Tap to select option", "elements": [ { "title": "Book flights" }, { "title": "Book hotels" }, { "title": "Talk to agent" } ] } } }, { "templateIdentifier": "template1", "templateType": "Panel", "version": "1.0", "data": { "content": { "title": "New York", "subtitle": "Tap to select option", "elements": [ { "title": "Book flights" }, { "title": "Book hotels" }, { "title": "Talk to agent" } ] } } } ] } } } ``` 对于托管通信小部件用户： + 在轮播模板上的选择会生成结构如以下示例的 JSON 字符串响应，然后发送回 Lambda（其他交互式消息类型只会返回带有 `selectionText` 值的常规字符串响应）： ``` { templateIdentifier: "template0", listTitle: "California", selectionText: "Book hotels" } ``` + 在轮播中，你可以在列表元素中提供超链接。 picker/panel 要创建超链接而不是按钮，请为本应是超链接的元素添加以下其他字段： ``` { title: "Book flights", ... type: "hyperlink", url: "https://www.example.com/Flights" } ``` ### 轮播限制 下表列出了每个轮播元素的限制。如果您选择从头开始构建自己的 Lambda，请使用此信息。必填参数以粗体显示。 **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/interactive-messages.html) ## Apple 表单模板 **注意** 此模板仅适用于 Apple Messages for Business 联系流。 企业可以通过一条消息向终端客户发送表单交互式消息，其中包含多页要求输入的内容。当终端客户的 Apple 设备收到消息后，他们可以打开表单并浏览页面，为每个页面回复，然后在表单末尾提交所有回复。 例如，企业可以将 Apple 表单用于各种用途，包括分类流、客户调查和账户创建/注册。 **警告** 互动消息内容和终端客户回复都存储在联系记录副本中，其他聊天参与者和联系人分析师可以访问文字记录查看。为防止 PII 在联系**结束后出现在您的联系人**记录笔[录中，您需要在 step-by-step指南流程中使用 “设置记录和分析行为” 块](set-recording-behavior.md)Contact Lens，[启用](sensitive-data-redaction.md)和启用敏感日期的编辑。有关如何启用 PII 编辑的完整详细信息，请参阅[启用敏感数据编辑](enable-analytics.md#enable-redaction)。 受支持的页面类型是： + **ListPicker**：用户必须从支持图像的选项中进行选择的列表。 + **WheelPicker**: 与之类似， ListPicker 但选择是通过可滚动的选项轮进行的。 + **DatePicker**: 日历视图，用户可以在其中选择日期。 + **输入**：用户必须填写的文本字段。 以下代码是您可以在 Lambda 中使用的 Apple 表单模板的示例。 **注意** **粗体文本**是必填参数。 在某些情况下，如果请求中存在父元素，并且不是必填/粗体，但其中的字段是必填/粗体，则这些字段就是必填字段。 简单调查表单示例： ``` {   "templateType": "AppleForm",   "version": "1.0",   "data": {     "content": {       "title": "Survey",       "pages": [         {           "pageType": "DatePicker",           "title": "Date you visited",           "subtitle": "When did you last visit?",           "minDate": "2024-01-02"         },         {           "pageType": "ListPicker",           "title": "Rating",           "subtitle": "How do you rate the experience?",           "items": [             {               "title": "Good",               "imageType": "URL",               "imageData": "https://mybucket.s3.us-west-2.amazonaws.com/good.jpg"             },             {               "title": "Okay",               "imageType": "URL",               "imageData": "https://mybucket.s3.us-west-2.amazonaws.com/okay.jpg"             },             {               "title": "Poor",               "imageType": "URL",               "imageData": "https://mybucket.s3.us-west-2.amazonaws.com/poor.jpg"             }           ]         },         {           "pageType": "ListPicker",           "title": "Dine type",           "subtitle": "Select all dine types that apply",           "multiSelect": true,           "items": [             {               "title": "Pickup"             },             {               "title": "Dine-in"             },             {               "title": "Delivery"             }           ]         },         {           "pageType": "WheelPicker",           "title": "Visits",           "subtitle": "How often do you visit?",           "items": [             {               "title": "Often"             }             {               "title": "Sometimes"             },             {               "title": "Rarely"             }           ]         },         {           "pageType": "Input",           "title": "Additional notes",           "subtitle": "Anything else you'd like to mention about your visit?",           "multiLine": true         }       ]     }   } } ``` ### Apple 表单限制 #### InteractiveMessage | 字段 | 类型 | 必需 | 说明/注释 | | --- | --- | --- | --- | | 版本 | 字符串 | 是 | 版本号。允许的值：“1.0” | | templateType | TemplateType | 是 | 互动消息模板类型。允许的值：[” ListPicker “、” “、TimePicker “面板”、“”、“”、QuickReply “Carousel”、ViewResource “”、“” AppleForm“] | | 数据 | InteractiveMessageData | 是 | 互动消息数据 | #### InteractiveMessageData | 字段 | 类型 | 必需 | 说明/注释 | | --- | --- | --- | --- | | content | InteractiveMessageContent | 是 | 主要互动消息内容 | | replyMessage | ReplyMessage | 否 | 发送互动消息回复后的消息显示配置 | #### AppleFormContent | 字段 | 类型 | 必需 | 说明/注释 | | --- | --- | --- | --- | | 标题 | 字符串 | 是 | 表单顶部标题。显示在 Apple 接收消息气泡和文字记录渲染中 | | subtitle | 字符串 | 否 | 在中用作字幕 ReceivedMessage | | imageType | 字符串 | 否 | 有效值：“URL” 用于中的图片 ReceivedMessage | | imageData | 字符串 | 否 | S3 图片网址用于中的图片 ReceivedMessage | | pages | AppleFormPage[] | 是 | 表单页面列表 | | showSummary | 布尔值 | 否 | 是否在提交前显示要查看的回复的摘要页面默认：False（无 confirmation/summary 页面） | | splashPage | AppleFormSplashPage | 否 | 在实际页面之前显示的初始醒目页面 默认：无醒目页面 | #### AppleFormSplashPage | 字段 | 类型 | 必需 | 说明/注释 | | --- | --- | --- | --- | | 标题 | 字符串 | 是 | 醒目页面的标题 | | subtitle | 字符串 | 否 | 副标题/醒目页面正文 | | imageType | ImageType | 否 | 在醒目页面中显示图像时显示允许的值：“URL” 默认：不显示图像 | | imageData | 字符串 | 否 | 对于 imageType= “URL”，这是 URL 值 默认：不显示图像 | | buttonTitle | 字符串 | 是 | “继续”按钮文本。Apple 要求，不支持具有本地化功能的默认文本 | #### AppleFormPage + 表单页面基本模型。从此模型延伸出的特定页面类型 | 字段 | 类型 | 必需 | 说明/注释 | | --- | --- | --- | --- | | pageType | ApplePageType | 是 | 页面类型枚举。允许的值：[“输入”、DatePicker “”、WheelPicker “”、ListPicker “] | | 标题 | 字符串 | 是 | 页面标题 | | subtitle | 字符串 | 是 | 页面副标题。用于确认页面 | #### AppleFormDatePickerPage **AppleFormDatePickerPage**扩展 [AppleFormPage](#apple-forms-limits-appleformpage) | 字段 | 类型 | 必需 | 说明/注释 | | --- | --- | --- | --- | | pageType | ApplePageType | 是 | 值：“DatePicker” | | labelText | 字符串 | 否 | 日期输入旁边显示的文本。参见附录中的示例屏幕截图 | | helperText | 字符串 | 否 | 日期输入下方显示帮助文本。参见附录“默认：无辅助文本”中的屏幕截图 | | dateFormat | 字符串 | 否 | ISO 8601 日期格式。默认值：MM/dd/yyyy | | startDate | 字符串 | 否 | 采用有效日期格式的初始/默认选定日期 默认：发送消息时最终用户的当前日期 | | minDate | 字符串 | 否 | 允许以有效的日期格式选择的最小日期 默认：无最小日期 | | maxDate | 字符串 | 否 | 允许以有效日期格式选择的最大日期 默认：发送消息时最终用户的当前日期 | #### AppleFormListPickerPage **AppleFormListPickerPage**扩展 [AppleFormPage](#apple-forms-limits-appleformpage) | 字段 | 类型 | 必需 | 说明/注释 | | --- | --- | --- | --- | | pageType | ApplePageType | 是 | 值：“ListPicker” | | multiSelect | 布尔值 | 否 | 允许选择多个项目 默认值：false（单选） | | 物品 | AppleFormListPickerPageItem[] | 是 | 列表页项目列表 | #### AppleFormListPickerPageItem **AppleFormListPickerPageItem**扩展 [AppleFormPage](#apple-forms-limits-appleformpage) | 字段 | 类型 | 必需 | 说明/注释 | | --- | --- | --- | --- | | 标题 | 字符串 | 是 | 显示项目文本 | | imageType | ImageType | 否 | 在项目中显示图像时显示允许的值：“URL” 默认：不显示图像 | | imageData | 字符串 | 否 | 对于 imageType= “URL”，这是 URL 值 默认：不显示图像 | **注意** 图像模型与现有的交互式消息模型 (ListPicker) 类似，但`imageDescription`不包括在内，它用于聊天小部件/网络聊天中的图像替代文本，而在 Apple 交互式消息中则被忽略。 #### AppleFormWheelPickerPage **AppleFormWheelPickerPage**扩展 [AppleFormPage](#apple-forms-limits-appleformpage) | 字段 | 类型 | 必需 | 说明/注释 | | --- | --- | --- | --- | | pageType | ApplePageType | 是 | 值：“WheelPicker” | | 物品 | AppleFormWheelPickerPageItem[] | 是 | 旋转选择器项目清单 | | labelText | 字符串 | 否 | 输入旁边显示的文本。参见附录中的示例屏幕截图 | #### AppleFormWheelPickerPageItem **AppleFormWheelPickerPageItem**扩展 [AppleFormPage](#apple-forms-limits-appleformpage) | 字段 | 类型 | 必需 | 说明/注释 | | --- | --- | --- | --- | | 标题 | 字符串 | 是 | 显示选取器项目的文本 | #### AppleFormInputPage **AppleFormInputPage**扩展 [AppleFormPage](#apple-forms-limits-appleformpage) | 字段 | 类型 | 必需 | 说明/注释 | | --- | --- | --- | --- | | pageType | ApplePageType | 是 | 值：“Input” | | labelText | 字符串 | 否 | 输入方框旁边显示的文本。参见附录中的示例屏幕截图 | | helperText | 字符串 | 否 | 在输入框下方显示其他文本，默认：无帮助程序文本 | | placeholderText | 字符串 | 否 | 没有输入时初始显示的占位符文本 默认：“（可选）”或“（必填）”占位符文本 | | prefixText | 字符串 | 否 | 要在输入旁边显示的前缀文本。例如：“\$1”，当输入为货币值时 默认：无前缀文本 | | 必需的 | 布尔值 | 否 | 是否要求最终用户提供输入 默认值：false | | multiLine | 布尔值 | 否 | 是否可以提供多行输入 默认值：false（单行） | | maxCharCount | 数字 | 否 | 输入的最大字符数。在 Apple 客户端上强制执行 默认：无限制 | | 正则表达式 | 字符串 | 否 | 用于对所提供的输入内容进行限制的 Regex 字符串 默认：无 regex 限制 | | keyboardType | 字符串 | 否 | 确定最终用户输入允许值时显示的键盘类型：与 Apple 相同。参阅[文档](https://register.apple.com/resources/messages/msp-rest-api/type-interactive#form-message)。一些允许的值：numberPad、phonePad、emailAddress | | textContentType | 字符串 | 否 | 有助于在 Apple 设备上使用自动填充建议。  允许的值：与 Apple 相同。参阅[文档](https://register.apple.com/resources/messages/msp-rest-api/type-interactive#form-message)。一些允许的值：电话号码、、FamilyName fullStreetAddress | ## Apple Pay 模板 **注意** 此模板仅适用于 Apple Messages for Business 联系流。 使用 Apple 支付模板，为客户提供一种简单而安全的方式，让他们通过使用 Apple Pay 的 Apple Messages for Business 购买商品和服务。 以下代码是您可以在 Lambda 中使用的 Apple Pay 模板。 **注意** **粗体文本**是必填参数。 在某些情况下，如果请求中存在父元素，并且不是必填/粗体，但其中的字段是必填/粗体，则这些字段就是必填字段。 ``` {   "templateType":"ApplePay",   "version":"1.0",   "data":{     "content":{       "title":"Halibut",       "subtitle":"$63.99 at Sam's Fish",       "imageType":"URL",       "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/fish.jpg",       "payment": {         "endpoints": {           "orderTrackingUrl": "https://sams.example.com/orderTrackingUrl/",           "paymentGatewayUrl": "https://sams.example.com/paymentGateway/",           "paymentMethodUpdateUrl": "https://sams.example.com/paymentMethodUpdate/",           "shippingContactUpdateUrl": "https://sams.example.com/shippingContactUpdate/",           "shippingMethodUpdateUrl": "https://sams.example.com/shippingMethodUpdate/",           "fallbackUrl": "https://sams.example.com/paymentGateway/"         },         "merchantSession": {           "epochTimestamp": 1525730094057,           "expiresAt": 1525730094057,           "merchantSessionIdentifier": "PSH40080EF4D6.........9NOE9FD",           "nonce": "fe72cd0f",           "merchantIdentifier": "merchant.com.sams.fish",           "displayName": "Sam's Fish",           "signature": "308006092a8.......09F0W8EGH00",           "initiative": "messaging",           "initiativeContext": "https://sams.example.com/paymentGateway/",           "signedFields": [             "merchantIdentifier",             "merchantSessionIdentifier",             "initiative",             "initiativeContext",             "displayName",             "nonce"           ],         },         "paymentRequest": {           "applePay": {             "merchantCapabilities": [               "supports3DS",               "supportsDebit",               "supportsCredit"             ],             "merchantIdentifier": "merchant.com.sams.fish",             "supportedNetworks": [               "amex",               "visa",               "discover",               "masterCard"             ]           },           "countryCode": "US",           "currencyCode": "USD",           "lineItems": [             {               "amount": "59.00",               "label": "Halibut",               "type": "final"             },             {               "amount": "4.99",               "label": "Shipping",               "type": "final"             }           ],           "requiredBillingContactFields": [             "postalAddress"           ],           "requiredShippingContactFields": [             "postalAddress",             "phone",             "email",             "name"           ],           "shippingMethods": [             {               "amount": "0.00",               "detail": "Available within an hour",               "identifier": "in_store_pickup",               "label": "In-Store Pickup"             },             {               "amount": "4.99",               "detail": "5-8 Business Days",               "identifier": "flat_rate_shipping_id_2",               "label": "UPS Ground"             },             {               "amount": "29.99",               "detail": "1-3 Business Days",               "identifier": "flat_rate_shipping_id_1",               "label": "FedEx Priority Mail"             }           ],           "total": {             "amount": "63.99",             "label": "Sam's Fish",             "type": "final"           },           "supportedCountries" : [             "US",             "CA",             "UK",             "JP",             "CN"           ]         }       },       "requestIdentifier" : "6b2ca008-1388-4261-a9df-fe04cd1c23a9"     }   } } ``` ### Apple Pay 限制 | 父字段 | 字段 | 必需 | 最少字符 | 最多字符 | 其他要求 | | --- | --- | --- | --- | --- | --- | | | templateType | 是 | | | 有效的模板类型 | | | 数据 | 是 | | | | | | 版本 | 是 | | | 必须为“1.0" | | 数据 | content | 是 | | | | | content | 标题 | 是 | 1 | 512 | 收到的消息气泡的标题 | | | subtitle | 否 | 0 | 512 | 在接收到的消息气泡标题下方显示的副标题 | | | imageData | 否 | 0 | 200 | 必须是可公开访问的有效 URL | | | imageType | 否 | 0 | 50 | 必须是“URL” | | | 付款 | 是 | | | 一本包含提供 Apple Pay 请求具体信息的字段的字典。 | | | requestIdentifier | 否 | | | 字符串， ApplePay 请求的标识符。如果未指定，则将生成并使用 UUID。 | | 付款 | 端点 | 是 | | | 一本包含付款处理、联系人更新和订单跟踪端点的字典。 | | | merchantSession | 是 | | | 一本包含 Apple Pay 在请求新的付款会话后提供的付款会话的字典。 | | | paymentRequest | 是 | | | 一本包含付款请求信息的字典 | | 端点 | paymentGatewayUrl | 是 | | | 字符串。由 Apple Pay 调用，通过支付提供商处理付款。此 URL 应与商家会话的 initiativeContext 字段中的 URL 匹配 | | | fallbackUrl | 否 | | | 一个可在网页浏览器中打开的 URL，以便客户在设备无法使用 Apple Pay 付款时完成购买。如果指定，则需要匹配 fallbackURL。 paymentGatewayUrl | | | orderTrackingUrl | 否 | | | 完成订单后，Messages for Business 会调用该功能，让您有机会在系统中更新订单消息。 | | | paymentMethodUpdate网址 | 否 | | | 当客户更改付款方式时，Apple Pay 会调用该功能。如果您未实现此端点并在字典中包含此密钥，则客户会看到一条错误消息。 | | | shippingContactUpdate网址 | 否 | | | 当客户更改收货地址信息时，Apple Pay 会调用该功能。如果您未实现此端点并在字典中包含此密钥，则客户会看到一条错误消息 | | | shippingMethodUpdate网址 | 否 | | | 当客户更改配送方式时，Apple Pay 会调用该功能。如果您未实现此端点并在字典中包含此密钥，则客户会看到一条错误消息。 | | merchantSession | displayName | 是 | 1 | 64 | 字符串。适合显示的商店规范名称。不要将名称本地化。 | | | initiative | 是 | | | 字符串。必须是“消息传递” | | | initiativeContext | 是 | | | 字符串。传递您的支付网关 URL。 | | | merchantIdentifier | 是 | | | 字符串。代表 Apple Pay 商家的唯一标识符。 | | | merchantSessionIdentifier | 是 | | | 字符串。代表 Apple Pay 商户会话的唯一标识符。 | | | epochTimestamp | 是 | | | 字符串。时间表示为自 1970 年 1 月 1 日（星期四）00:00:00 UTC 起已过去的秒数。 | | | expiresAt | 是 | | | 字符串。到期时间表示为自 1970 年 1 月 1 日（星期四）00:00:00 UTC 起已过去的秒数。 | | | nonce | 否 | | | 二进制。检查互动完整性的一次性字符串。 | | | signature | 否 | | | 二进制。对互动进行签名的公钥的哈希值。 | | | signedFields | 否 | | | 包含签名属性的字符串列表。 | | paymentRequest | applePay | 是 | | | 一本描述 Apple Pay 配置的字典。 | | | countryCode | 是 | | | 字符串。商家的双字母 ISO 3166 国家/地区代码。 | | | currencyCode | 是 | | | 字符串。付款的三字母 ISO 4217 货币代码。 | | | lineItems | 否 | | | 一系列解释付款和额外费用的细列项目。订单项不是必填项。但是，如果存在 lineItems 密钥，则数组不能为空。 | | | total | 是 | | | 一本包含总数的字典。总金额必须大于零才能通过验证。 | | | requiredBillingContact字段 | 否 | | | 客户处理交易所需的账单信息清单。有关可能的字符串的列表，请参阅[requiredBillingContact字段](https://developer.apple.com/documentation/apple_pay_on_the_web/applepaypaymentrequest/2216120-requiredbillingcontactfields)。只要求填写处理付款所需的联系人信息。要求提供不必要的字段会增加交易的复杂性，从而增加客户取消付款请求的几率。 | | | requiredShippingContact字段 | 否 | | | 为配送订单而要求客户提供的配送或联系信息清单。例如，如果您需要客户的电子邮件或电话号码，请提供此密钥。有关可能的字符串的列表，请参阅[requiredShippingContact字段](https://developer.apple.com/documentation/apple_pay_on_the_web/applepaypaymentrequest/2216121-requiredshippingcontactfields)。 | | | shippingMethods | 否 | | | 一个列出了可用配送方式的数组。Apple Pay 付款页面会将数组中的第一种配送方式显示为默认配送方式。 | | | supportedCountries | 否 | | | 一个支持的国家的数组。列出每个国家/地区的 ISO 3166 国家/地区代码。 | | applePay | merchantIdentifier | 是 | | | 代表 Apple Pay 商家的唯一标识符。 | | | merchantCapabilities | 是 | | | 一个商家支持的付款功能的数组。该数组必须包含 supports3DS，也可以选择包含 supportsCredit、supportsDebit 和 supportsEMV。 | | | supportedNetworks | 是 | | | 一个商家支持的付款网络的数组。该数组必须包含以下一个或多个值：amex、discover、jcb、masterCard、privateLabel 或 visa | | lineItem | amount | 是 | | | 行项目的货币金额。 | | | label | 是 | | | 行项目的简短本地化描述。 | | | 键入 | 否 | | | 一个表示行项目是最终项目还是待定项目的值。 | | total | amount | 是 | | | 付款的总金额。 | | | label | 是 | | | 付款的简短本地化描述。 | | | 键入 | 否 | | | 一个表示付款是最终项目还是待定项目的值。 | | shippingMethods | amount | 是 | | | 字符串。与此配送方式相关的非负成本。 | | | detail | 是 | | | 字符串。配送方式的补充描述。 | | | label | 是 | | | 字符串。配送方式的简短描述。 | | | identifier | 是 | | | 字符串。客户定义的值，用于标识此配送方式。 | ## iMessage 应用程序模板 **注意** 此模板仅适用于 Apple Messages for Business 联系流。 使用 iMessage 应用程序模板向客户展示您定制的 iMessage 应用程序。 以下代码是您可以在 Lambda 函数中使用的 iMessage 应用程序模板示例。  ``` {    templateType: AppleCustomInteractiveMessage,    version: "1.0",    data: {        content: {            appIconUrl: "https://interactive-message-testing.s3-us-west-2.amazonaws.com/apple_4.2kb.jpg",            appId: "123456789",            appName: "Package Delivery",            title: "Bubble Title CIM",            bid: "com.apple.messages.MSMessageExtensionBalloonPlugin:{team-id}:{ext-bundle-id}",            dataUrl: "?deliveryDate=26-01-2024&destinationName=Home&street=1infiniteloop&state=CA&city=Cupertino&country=USA&postalCode=12345&latitude=37.331686&longitude=-122.030656&isMyLocation=false&isFinalDestination=true",            subtitle: "Bubble package",        },        replyMessage: {            title: "Custom reply message title",            subtitle: "Custom reply message subtitle",            imageType: "URL",            imageData: "https://interactive-msg.s3-us-west-2.amazonaws.com/fruit_34.3kb.jpg",        }    } } ``` ### iMessage 应用程序限制 | **父字段** | **字段** | **必填** | **Type** | **其他说明** | | --- | --- | --- | --- | --- | | | templateType | 是 | TemplateType | 有效的模板类型，“AppleCustomInteractiveMessage” | | | data | 是 | InteractiveMessageData | 包含内容和 receivedMessage 字典 | | | 版本 | 是 | 字符串 | 必须为“1.0" | | data | content | 是 | InteractiveMessageContent | iMessage 应用程序的互动内容 | | | replyMessage | 是 | ReplyMessage | 发送互动消息回复后的消息显示配置 | | content | appIconUrl | 是 | 字符串 | AWS S3 网址 | | | appId | 是 | 字符串 | 商业 IMessage 应用程序 ID | | | appName | 是 | 字符串 | 商业 IMessage 应用程序名称 | | | bid | 是 | 字符串 | 商业 IMessage 应用程序出价。模式：com.apple.messages。 MSMessageExtensionBalloonPlugin: \$1team-id\$1: \$1\$1 ext-bundle-id | | | dataUrl | 是 | 字符串 | 传递到 iMessage 应用程序的数据 | | | useLiveLayout | 否 | 布尔值 | 默认：True | | | title | 是 | 字符串 | Imessage 应用程序泡沫的标题 | | | subtitle | 否 | 字符串 | 副标题应用程序泡沫的标题 | | replyMessage | title | 否 | 字符串 | | | | subtitle | 否 | 字符串 | | | | imageType | 否 | 字符串 | 必须是可公开访问的有效 URL | | | imageData | 否 | 字符串 | 没有图像就不存在 | ## WhatsApp 名单 **注意** 您只能将此模板用于 WhatsApp 消息流。有关 WhatsApp 与 Amazon Connect 集成的更多信息[设置 WhatsApp 企业消息](whatsapp-integration.md)，请参阅本指南前面的。 您可以在 WhatsApp 聊天中使用 WhatsApp 列表模板为客户提供选项列表。 以下示例显示了用于银行服务的选项列表。 ``` { "templateType": "WhatsAppInteractiveList", "version": "1.0", "data": { "content": { "title": "Which account do you need help with?", "body": { "text": "Which account do you need help with?" }, "action": { "button": "Options", "sections": [ { "title": "Your accounts", "rows": [ { "id": "11111111", "title": "11111111", "description": "PERSONAL CHECKING" }, { "id": "22223333", "title": "22223333", "description": "PERSONAL SAVINGS" } ] }, { "title": "Other", "rows": [ { "id": "other", "title": "I can't find my account" } ] } ] } } } } ``` 下图显示了客户打开列表之前和之后的典型屏幕。 ![\[显示选项列表的图片。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/whatsapp-options-results.png) ### WhatsApp 期权限制 | 父字段 | 字段 | 必需 | 最小长度 | 最大长度 | 其他要求 | | --- | --- | --- | --- | --- | --- | | | templateType | 是 | | | 必须是 “WhatsAppInteractiveList” | | | data | 是 | | | | | | 版本 | 是 | | | 必须为“1.0" | | data | content | 是 | | | | | content | title | 是 | | | | | | 标题 | 否 | | | | | | body | 是 | | | | | | 页脚 | 否 | | | | | | action | 是 | | | | | 标题 | type | 是 | | | 必须是“文本” | | | 文本 | 是 | 1 | 60 | | | body | 文本 | 是 | 1 | 4096 | | | footer | 文本 | 是 | 1 | 60 | | | action | 章节 | 是 | 1 | 10 | | | | 按钮 | 是 | 1 | 20 | | | 部分 | title | 是 | 1 | 24 | | | | 行 | 是 | 1 | 10 | 所有部分最多 10 行 | | 行 | id | 是 | 1 | 200 | 在行中必须唯一 | | | title | 是 | 1 | 24 | | | | 描述 | 否 | 1 | 72 | | ## WhatsApp 回复按钮 **注意** 您只能将此模板用于 WhatsApp 消息流。 您可以使用 WhatsApp 回复按钮模板为客户提供内联选项列表。 ``` { "templateType": "WhatsAppInteractiveReplyButton", "version": "1.0", "data": { "content": { "title": "What would you like to do?", "body": { "text": "What would you like to do?" }, "action": { "buttons": [ { "type": "reply", "reply": { "id": "agent", "title": "Continue to agent" } }, { "type": "reply", "reply": { "id": "end_chat", "title": "End chat" } } ] } } } } ``` 下图显示了典型的用户体验。 ![\[在聊天会话中回复的图像。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/whatsapp-reply-template.png) ### WhatsApp 回复按钮限制 回 WhatsApp 复模板有以下限制。 | 父字段 | 字段 | 必需 | 最小长度 | 最大长度 | 其他要求 | | --- | --- | --- | --- | --- | --- | | | templateType | 是 | | | 必须是 “WhatsAppInteractiveReplyButton” | | | data | 是 | | | | | | 版本 | 是 | | | 必须为“1.0" | | data | content | 是 | | | | | content | 标题 | 是 | | | | | | 标题 | 否 | | | | | | body | 是 | | | | | | footer | 否 | | | | | | action | 是 | | | | | 标题 | type | 是 | | | 有效值：“text”、“document”、“image”、“video” | | | 文本 | 否 | 1 | 60 | | | | 图片 | 否 | | | | | | 视频 | 否 | | | | | | 文档 | 否 | | | | | 图片 | link | 是 | | | 必须是可公开访问的媒体 URL，以 https/http 开头 | | 视频 | link | 是 | | | 必须是可公开访问的媒体 URL，以 https/http 开头 | | 文档 | link | 是 | | | 必须是可公开访问的媒体 URL，以 https/http 开头 | | body | 文本 | 是 | 1 | 1024 | | | footer | 文本 | 是 | 1 | 60 | | | action | 按钮 | 是 | 1 | 3 | | | 按钮 | type | 是 | | | 必须是“reply” | | | reply.id | 是 | 1 | 256 | 各个按钮必须是唯一的 | | | reply.title | 是 | 1 | 20 | | ## 丰富的标题和字幕格式 您可以为聊天消息的标题和副标题添加丰富的格式。例如，您可以添加链接、斜体、粗体、编号列表和项目符号列表。您可以使用 [markdown]( https://commonmark.org/help/) 设置文本格式。 下图的聊天框显示了标题和副标题中格式丰富的列表选择器示例。 + 标题**我们该怎么帮您？aws.amazon.com** 以粗体显示，包含一个链接。 + 副标题包含斜体和粗体文本、项目符号列表和编号列表。它还显示了纯链接、文本链接和示例代码。 + 聊天框的底部显示了三个列表选择器元素。 ![\[聊天框，带链接的标题，带有列表和链接的副标题。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/rich-link-formatting-example1a.png) ### 如何使用 markdown 设置文本格式 您可以用多行格式编写标题和副标题字符串，也可以在单行中使用 ``\r\n`` 换行符。 + **多行格式**：以下代码示例说明了如何在 markdown 中以多行格式创作列表。 ``` const MultiLinePickerSubtitle = `This is some *emphasized text* and some **strongly emphasized text** This is a bulleted list (multiline): * item 1 * item 2 * item 3 This is a numbered list: 1. item 1 2. item 2 3. item 3 Questions? Visit https://plainlink.com/faq [This is a link](https://aws.amazon.com) This is \`\` ` const PickerTemplate = { templateType: "ListPicker|Panel", version: "1.0", data: { content: { title: "How can we help?", subtitle: MultiLinePickerSubtitle, elements: [ /* ... */ ] } } } ``` + **单行格式**：以下示例说明了如何使用 ``\r\n`` 换行符在单行中创作副标题。 ``` const SingleLinePickerSubtitle = "This is some *emphasized text* and some **strongly emphasized text**\r\nThis is a bulleted list:\n* item 1\n* item 2\n* item 3\n\nThis is a numbered list:\n1. item 1\n2. item 2\n3. item 3\n\nQuestions? Visit https://plainlink.com/faq\r\n[This is a link](https://aws.amazon.com)\r\nThis is ``"; const PickerTemplate = { templateType: "ListPicker|Panel", version: "1.0", data: { content: { title: "How can we help?", subtitle: SingleLinePickerSubtitle, elements: [ /* ... */ ] } } } ``` 以下示例显示了如何使用 markdown 设置斜体和粗体文本的格式： `This is some *emphasized text* and some **strongly emphasized text**` 以下示例显示了如何使用 markdown 将文本格式化为代码： `This is ``` ### 如何使用 markdown 设置链接格式 要创建链接，请使用以下语法： `[aws](https://aws.amazon.com)` 以下示例显示了两种使用 markdown 添加链接的方法： `Questions? Visit https://plainlink.com/faq ` `[This is a link](https://aws.amazon.com)` **注意** 对于列表选取器，如果您想对打开链接的位置进行精细控制，可以将 `targetForLinks` 字段作为子字段添加到 `content` 中。默认情况下，通信小部件将在新的浏览器选项卡中打开链接。有关更多信息，请参阅 [列表选择器模板](#list-picker)。