集成 Google Dialogflow CX

在完成本页面上的任务之前，请确保已满足集成的先决条件 。

创建脚本

所需的权限：查看脚本、创建/编辑脚本

您需要创建至少一个 Studio 脚本来将交互路由到虚拟坐席。请按照脚本指南和要求集成虚拟坐席。支持的此提供程序的虚拟坐席操作是 VoiceBot Exchange。

• VoiceBot Exchange
• Voicebot Conversation

如果将 SIP 用于对多媒体通信会话（如语音和视频通话）发出信号和进行控制的协议。 秘密渠道与虚拟坐席结合使用，则脚本具有不同的要求。

您可以在在线帮助的基础知识和技术参考指南部分中了解有关 Studio 脚本编写的更多信息。

自定义有效负载最佳实践

将自定义有效负载数据从 Google Dialogflow CX 集成至 CXone 时，请遵循以下最佳实践：

• DialogflowCX 不像 Dialogflow ES 使用上下文将数据传递给 Dialogflow 意图 联系人所说/输入内容背后的含义或目的；联系人想要沟通或完成的内容。

• 您可以使用 JSON 键值对将自定义数据传递到 Dialogflow CX。在脚本的 Snippet action中，创建一个动态 customPayload 对象，并向其添加键值。例如：

  DYNAMIC customPayload
  customPayload.ani = ani
  customPayload.contactID = contactId
  customPayload.masterContactId = masterId
  customPayloadJSON = "{customPayload.asJSON()}"	

• 在脚本的 Exchange 或 Conversation 操作中，通过其值中包含 asJSON() 函数的变量来配置 customPayload 属性。您可以在 customPayload 对象中找到该变量。
• 使用 QueryParameters 的 Payload 属性将 customPayload JSON 传递给虚拟坐席。请参阅 Google 文档，了解 Google Dialogflow CX 的 QueryParameters 。
• 通过 QueryParameters 传递的数据由 Dialogflow CX 中的 Webhook 接收。您可以在 Dialogflow CX 控制台中编写代码来处理传递的数据。
• 不要在 customPayload 对象中嵌套对象。嵌套的对象作为文字字符串进行发送。
• 要将自定义数据从 Dialogflow CX 虚拟坐席传递回脚本，请使用 Dialogflow CX 控制台中的 Custom Payload 字段。确保您位于与 CXone 结合使用的虚拟坐席的控制台中。在脚本中的语音或聊天 Studio 操作中，使用 customPayloadVarName (out) 变量将其映射到脚本。例如，您可以使用此来设置下一个提示行为。

• 使用 customPayload 设置的参数只能在外部 Webhook 中使用。如果要设置参数以便在外部 webhook 之外使用，请在包含 session_params 字段的 Snippet 操作中设置参数。例如：

  {
  	"session_params":
  	{ 
  		"name": "Winnie Le Pooh"
  		"job": "Food critic"
  		"location": "Hundred Acre Wood"
  	}
  }

  使用以下语法访问 Dialogflow CX 坐席意图中的会话参数：

  $session.params.name = Winnie Le Pooh

  $session.params.job = Food critic

  $session.params.location = 100 Acre Wood

  会话参数仅与 Dialogflow CX 虚拟坐席一起使用。要通过 Dialogflow 获得类似的结果，请使用上下文。

• 语音上下文提示可以通过 speechContexts 参数中的自定义有效负载进行传递。voiceContexts.phrases 的值必须是您想要给出的提示的 Google 类令牌 。该令牌必须与您的联系人的语言和区域设置相匹配。例如：

  DYNAMIC customPayload
  customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
  customPayload.speechContexts.boost=10		

• 使用VOICEBOT EXCHANGE时：要配置联系人在讲话时暂停时虚拟坐席等待的时间，请将 maxPostEnergySilenceMS 参数添加到 Next Prompt Behaviors 或 Default Next Prompt Behaviors Snippet 操作中。

将应用程序添加到 虚拟坐席中心

所需的权限：查看脚本、创建/编辑脚本

将配置应用程序添加到 虚拟坐席中心，以便在 CXone 与虚拟坐席提供程序之间建立连接。

如果将 SIP 用于对多媒体通信会话（如语音和视频通话）发出信号和进行控制的协议。 秘密渠道连接与虚拟坐席结合使用，请按照设置此类连接的步骤进行操作。

1. 在 Studio 中，打开或创建一个脚本或新增一个虚拟坐席操作（如果尚未添加）。
2. 双击该虚拟坐席操作可打开 虚拟坐席中心。
3. 单击添加机器人。

4. 输入虚拟坐席（机器人）名称，然后单击虚拟坐席提供程序列表中的 Google Dialogflow CX 。

5. 单击下一步。

6. 填写配置表单中的字段，然后单击下一步 。您可以在此页面的配置页面详细信息部分中找到有关此表单的详细信息。

7. 单击下一步。

8. 请参阅本页上的配置语音集成选项部分。

9. 单击下一步。

10. 在“记录文本”页面上，选择是否要捕获对话记录文本和意图信息的选项。您可以选择仅捕获并归档意图信息，以捕获并归档记录文本和意图信息，或仅捕获和归档记录文本。您还可以选择不捕获或归档记录文本或意图信息。此选项仅适用于基于话语的语音虚拟坐席。使用 SIP 用于对多媒体通信会话（如语音和视频通话）发出信号和进行控制的协议。 秘密渠道的语音集成不支持它。

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

    选项	详细信息
    不采集或归档记录文本或意图信息	如果您不想采集对话记录文本或意图 联系人所说/输入内容背后的含义或目的；联系人想要沟通或完成的内容信息，请选择此选项。
    仅采集和归档意图信息	如果只想采集意图信息，请选择此选项。默认情况下，仅在交互期间存储捕获的数据。 此选项需要自定义脚本。
    采集并归档记录文本或意图信息	如果要采集记录文本数据和意图数据，请选择此选项。默认情况下，仅在交互期间存储捕获的数据。 此选项需要自定义脚本。

11. 单击下一步。

12. 您可以在“测试 + 添加”页面通过发送语音或文本提示，测试机器人的连接情况。如果测试消息不起作用，请单击返回，以返回到“配置”页面并验证设置。您可能还需要验证虚拟坐席提供程序管理控制台中的配置。

13. 单击添加。

Google Dialogflow CX 配置页面详细信息

完成“配置”页面时，请使用下表中的信息。在 虚拟坐席中心 中添加应用程序时您会看到此页面

如果将DialogflowCX 设置为使用 SIP 用于对多媒体通信会话（如语音和视频通话）发出信号和进行控制的协议。 秘密渠道连接，请按照设置连接的步骤而不是本节中的步骤进行操作。

配置 Google Dialogflow CX TTS 输出

如果要使用 GoogleTTS 服务，请完成本节中的步骤。启用 虚拟坐席中心 中 DialogflowCX 配置页面上的执行输出 TTS 选项后，会出现下图中的字段。

1. 在 虚拟坐席中心 中，添加新的配置应用程序，并按照本页将应用程序添加到 虚拟坐席中心 部分中的步骤进行配置。
2. 启用执行输出 TTS。

3. 要使用自定义语音模型，请启用使用自定义语音，然后在自定义语音模型字段中输入要使用的 AutoML 模型名称。

   查看图像

   

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

   字段	详细信息
   使用自定义语音	允许您使用 AutoML（自动机器学习）模型为机器人合成自定义语音。Dialogflow 使用此语音而不使用 TTS 语音。如果您使用此选项，请在出现的自定义语音模型字段中输入您要使用的 AutoML 模型的名称。 此字段仅在启用执行 TTS 输出时可见。

4. 如果要使用 Google 语音模型，请从下拉列表中选择 TTS 语音名称。

5. 选择希望 Google TTS 服务在合成语音时使用的机器学习模型和模型变量。

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

   字段	详细信息
   模型	选择您希望转录服务在转录音频时使用的机器学习模型。这些模型已经过训练，可以识别来自特定音频类型和来源的语音。仅为语音虚拟坐席配置此字段。并非所有语言都支持每个模型。请参阅 Google 文档以了解有关语言支持的更多信息。 电话呼叫是大多数语音虚拟坐席的推荐选项。 可用选项为： 命令和搜索：当转录较短音频片段时使用，如命令或语音搜索。考虑改用 最新短。 默认：当音频不符合其他模式时使用。它可以转录任何类型的音频，但某些类型的结果可能质量较低。 最新长音：用于长格式内容，如即兴演讲或对话。 最新短音：用于几秒钟长的话语，如命令。考虑使用此模型取代命令和搜索。 医疗对话：当转录医疗专业人员与患者之间对话时使用。 医疗口述：当转录医疗专业人员的口述说明时使用。 电话呼叫：用于电话呼叫中的音频。 视频：当转录有多个发言者的音频时使用，如来自视频片段或播客的音频。如果视频没有您需要的语言，请改用最新长。
   模型变体	选择您希望虚拟坐席使用的所选模型的变体。某些模型具有增强变体，可提供质量更高的结果。有关支持增强变体的模型的更多信息，请参阅 Dialogflow 文档。增强模型的收费标准高于标准模型。 对于 Phone Call 模型，建议的变体是 Enhanced。 该字段的可用选项包括： Best Available：如果所选模型有增强模型，则选择是否让 Dialogflow 使用该模型。如果不是，则使用标准模型。 Enhanced：选使用增强模型。如果所选的模型没有可用的增强模型，则 Dialogflow 使用标准模型。 Standard：选择使用标准模型，即使增强模型可用。 Unspecified：如果不确定使用哪种变体，请选择。Dialogflow 默认为所选模型的最佳可用变体。

6. 要在虚拟坐席音频响应开始时添加静音，请在添加前导静音字段中输入要添加的静音毫秒数。建议的静音时间为 500 毫秒。

7. 输入语速、音调和音量增益，以配置 TTS 语音的声音效果。

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

   字段	详细信息
   语速	单击 + 或 – 可更改 TTS 语音的语速。语速可介于 0.25 和 4.0 之间。正常语速是 1.0。语速 2.0 是正常语速的两倍，语速 0.5 是正常语速的一半。默认值为 0。 此字段仅在启用执行 TTS 输出时可见。
   音调	单击 + 或 – 可更改 TTS 语音的音调。音调是语音的高低。默认值为 0。最大值为 20.0，表示语音比默认值高 20 个半音。最小值为 -20.0，表示语音比默认值低 20 个半音。 此字段仅在执行 TTS 输出开启时可见。
   音量增益	单击 + 或 –可更改以分贝 (dB) 为单位测得的 TTS 语音的音量。默认值为 0。范围为 16.0 到 -96.0。增益 +6.0 表示播放音量大约是默认音量的两倍。请勿超过+10 dB。 此字段仅在执行 TTS 输出开启时可见。

8. 返回本面的“将应用程序添加到 虚拟坐席中心”部分，完成配置应用程序的添加。

配置语音集成选项

所需的权限：查看脚本、创建/编辑脚本

如果您正在使用与语音虚拟坐席之间的 SIP 秘密渠道连接，请按照设置 SIP 秘密渠道的步骤操作。

1. 在 虚拟坐席中心 中，添加新的配置应用程序，并按照本页将应用程序添加到 虚拟坐席中心 部分中的步骤进行配置。

2. 单击“配置”页面上的下一步。

3. 在“语音”页面的“语音集成选项”下，选择逐轮控制（CXone语音机器人网关）。

4. 在“文本转语音选项”下，如果要使用 CXoneTTS 选项，请选择使用CXone云 TTS。要使用虚拟坐席提供程序的 TTS 服务，请清除此复选框并在向导的配置页面上配置 TTS 输出。

   如果表单不允许您选择使用CXone云 TTS，请单击返回返回“配置”页面。单击执行输出 TTS 滑块至关闭。现在可以在“语音”页面上启用 Cloud TTS。

5. 如果使用 Cloud TTS，请选择 TTS 供应商。如果使用的是虚拟坐席提供程序的 TTS 服务，则不显示此字段，可以跳过此步骤。

6. 在“转录”选项下，选择要使用的转录服务选项。

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

   字段	详细信息
   转录选项	选择要用于转录的服务： 使用机器人帐户转录：如果要使用虚拟坐席提供程序的转录服务，请选择此选项。联系人话语中的音频在转录之前会发送给提供程序。 使用 CXone 转录配置文件：如果要使用 CXone 转录配置文件，请选择此选项。您可以在 CXone 逐轮转录 帮助页面上了解有关此选项的更多信息。

7. 如果您选择使用 CXone 转录配置文件，请单击转录配置文件，选择您要使用的转录配置文件。单击添加新的逐个转录配置文件，创建一个新配置文件。
8. 单击下一步。
9. 返回本面的“将应用程序添加到 虚拟坐席中心”部分，完成配置应用程序的添加。

将 Google Dialogflow CX 应用程序分配给操作

所需的权限：查看脚本、创建/编辑脚本

在 虚拟坐席中心 中设置和配置虚拟坐席 联系人所说/输入内容背后的含义或目的；联系人想要沟通或完成的内容应用程序时，您需要将其分配给脚本中的虚拟坐席操作。这会将操作和脚本连接到您的虚拟坐席提供程序。

您使用的操作取决于虚拟坐席及其支持的内容。

1. 在 Studio 中，打开要修改的脚本。

2. 如果您尚未这样做，请单击工具选项卡，展开自动化和 AI 类别，然后添加要使用的虚拟坐席操作。确保将其放在脚本中的正确位置。如果未看到预期的操作，请验证脚本媒体类型是否正确。例如，如果要为语音虚拟坐席创建脚本，则该脚本必须为电话脚本。

3. 双击该操作以打开 虚拟坐席中心。

   查看图像

   
4. 在左侧的列中，找到要分配给操作的虚拟坐席，然后单击它旁边的选择选项 。
5. 单击关闭。

更改转录配置文件

所需的权限：查看脚本、创建/编辑脚本

转录配置文件允许您使用与虚拟坐席提供程序所提供的转录服务不同的转录服务。每个虚拟坐席可以拥有一个转录配置文件。如果使用语音虚拟坐席并需要更改转录配置文件，则只需按照本节中的步骤操作。

1. 在 Studio 中，打开或创建一个脚本或新增一个虚拟坐席操作（如果尚未添加）。
2. 双击该虚拟坐席操作可打开 虚拟坐席中心。
3. 在 虚拟坐席中心 页面左侧的虚拟坐席配置应用程序列表中，单击要修改的应用程序。
4. 在虚拟坐席应用程序属性页面的中心，单击语音选项卡。

5. 在转录选项下，选择使用 CXone 转录配置文件（如果尚未选择）。

6. 选择您希望此虚拟坐席集成使用的逐个转录配置文件。如果您要使用的选项不存在，您可以添加它。

7. 单击保存。
8. 在虚拟坐席应用程序属性页面的“测试”部分，使用麦克风选项测试转录服务。

测试虚拟坐席

所需的权限：查看脚本、创建/编辑脚本

您可以测试虚拟坐席的多个方面，以确保一切都按预期进行。您可以从 虚拟坐席中心 中的虚拟坐席应用程序的属性页面运行测试。您可以：

• 验证虚拟坐席应用程序是否已正确配置为与虚拟坐席提供程序进行通信。
• 添加自定义负载 JSON 以测试虚拟坐席对自定义负载数据的处理。
• 触发欢迎意图事件以测试虚拟坐席如何开始对话。
• 触发自定义意图事件来测试您为虚拟坐席创建的任何自定义事件。
• 触发超时事件以测试虚拟坐席在联系超时时如何响应。
• 测试虚拟坐席如何处理DTMF 当用户在电话按键上按下或敲击某个键时产生的信号音。 输入。

下图是 虚拟坐席中心 中虚拟坐席应用程序的属性页面示例。它会显示“配置”和“语音”选项卡以及“测试”窗格。

1. 在 Studio 中，打开或创建一个脚本或新增一个虚拟坐席操作（如果尚未添加）。
2. 双击该虚拟坐席操作可打开 虚拟坐席中心。
3. 单击从左侧列表中选择要测试的虚拟坐席的配置应用程序。

4. 在“测试”窗格中，在键入消息字段中输入测试消息，然后按 Enter 键发送。您还可以单击麦克风 并对着计算机的麦克风讲话。

5. 单击以欢迎意图开始以从头开始测试对话。虚拟坐席以其默认的欢迎消息进行响应。您可以输入测试消息。

6. 单击更多选项 测试虚拟坐席的其他方面。

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

   字段	详细信息
   添加自定义有效负载 JSON	选择以测试向虚拟坐席发送自定义有效负载 JSON。 在“测试 + 添加”页面上显示的添加自定义有效负载 JSON  文本框中输入自定义有效负载。每行后按 Enter 键。 准备好测试自定义有效负载时，发送一条测试消息。测试完自定义负载后，单击“添加自定义有效负载 JSON”窗格上的关闭。
   触发欢迎意图事件	选择以测试默认欢迎意图 联系人所说/输入内容背后的含义或目的；联系人想要沟通或完成的内容。虚拟坐席发送欢迎消息。输入要回复的消息。
   触发自定义意图事件	选择以测试自定义意图事件。在出现的弹出窗口中输入事件名称，然后单击触发。虚拟坐席会为您输入的意图发送消息。发送响应来测试意图。
   触发超时事件	选择以查看默认超时意图。虚拟坐席发送其配置的超时响应消息。
   DTMF 输入	选择测试语音虚拟坐席对 DTMF 当用户在电话按键上按下或敲击某个键时产生的信号音。 音调的响应。输入DTMF 字符，然后单击输入以查看虚拟坐席对这些字符的响应。

7. 单击重置重新开始测试。

8. 如果需要根据测试结果进行更改，您可以：

   • 修改虚拟坐席的 Studio 脚本。
   • 在虚拟坐席中心中修改虚拟坐席应用程序中的配置设置。
   • 在虚拟坐席提供程序的控制台中修改虚拟坐席的配置设置。单击 虚拟坐席中心 中应用程序属性页面上的大方形按钮。本部分开头的示例显示了带有提供程序按钮的 Google Dialogflow CX 应用程序。它上面有一个 图标，指示该链接打开了一个外部站点。
9. 在每次更改脚本或任何配置设置后全面测试虚拟坐席。
10. 完成测试后，单击关闭。