通过集成自定义参与者，自定义聊天流体验 - Amazon Connect
为加入自定义参与者的客户激活计时器故障排除技巧

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

通过集成自定义参与者，自定义聊天流体验

您可以将其他解决方案（例如自动程序）与 Amazon Connect 聊天集成，以创建自定义的聊天流体验。

以下概述了如何自定义聊天流体验。聊天对话开始后，为每个聊天分段实施这些步骤。我们建议在聊天流程APIs中添加一个调用 AWS Lambda 函数区块来调用。

重要

在 调用 AWS Lambda 函数 数据块之前添加一个 播放提示 数据块。只有当 Invoke AWS Lambda 区块是入站聊天流程中的第一个区块时，才需要这样做。

  1. 启用实时聊天消息流。

  2. 致电 Amazon Connect CreateParticipantAPI，为聊天联系人添加自定义参与者 (ParticipantRole=CUSTOM_BOT)。

    1. 有关如何创建用于调用 Amazon Connect 的SDK客户端的信息APIs，请参阅以下主题：

    2. 保留从ParticipantToken中获得的CreateParticipant来电CreateParticipantConnection。 CreateParticipantConnection返回 aConnectionToken，您可以使用它来呼叫其他 Amazon Connect 参与者APIs。

      致电CreateParticipantConnection为自定义参与者创建连接时：

      • 将 ConnectParticipant 设置为 True，可将自定义参与者标记为已连接，以进行消息流式传输。

      • 通过致电后续TypeCONNECTION_CREDENTIALS的 Amazon Connect 参与者服务APIs。

      • 应在调用 CreateParticipant 后的 15 秒内调用 CreateParticipantConnection。

  3. 将参与者添加到联系人后，他们可以使用 Amazon Connect 参与者服务与客户交换消息APIs。

  4. 要断开参与者的连接，请致电 DisconnectParticipantAPI。

注意

  • 如果联系人已有座席或 Amazon Lex 自动程序，则无法将自定义参与者添加到聊天中。

  • 当座席或 Amazon Lex 自动程序加入联系人时，自定义参与者将断开连接。

  • 一个联系人只能有一个自定义参与者。

建议配置自定义参与者可以与联系人聊天的时长：

  • 为 ParticipantRole = CUSTOM_BOT 设置 Wait 数据块上的 Timeout 属性。

  • 如果自定义自动程序参与者在超时之前没有断开连接，该联系人将被路由到已超时分支。这样，您就可以决定接下来运行哪个数据块来解决客户的查询了。

注意

如果联系人被路由到已超时分支，他们就不会断开与该联系人的连接。您必须致电 DisconnectParticipantAPI以断开参与者的连接。

为加入自定义参与者的客户激活计时器

您可以为加入自定义参与者（例如自定义机器人）的客户激活计时器。这使您能够检测客户何时停止响应，这样您就可以终止机器人对话并执行流程中的下一步。通过终止闲置的参与者，您可以减少未响应的客户与自定义参与者互动的打开聊天的数量。

执行以下步骤以集成 Idle Partication 自定义机器人扩展，并可选择设置自定义计时器值。这些步骤假设您已经使用自定义参与者功能进行聊天。

  1. 在自定义参与者加入聊天之前，请UpdateParticipantRoleConfigAPI为客户调用。

    1. 计时器仅为客户激活。自定义参与者没有闲置参与者或自动断开连接的计时器。

    2. 您可以选择调用的方法。API

    3. 在此步骤中配置的计时器值将在聊天的整个生命周期内保留。如果您想为客户和客服互动设置不同的计时器值，请参阅步骤 2。

    4. 如果您的客户端已经以这种方式进行设置，则无需采取任何其他操作即可集成您的自定义参与者。

  2. （可选）要配置在客户和客服互动期间与客户和自定义参与者互动期间不同的计时器和计时器值，请执行以下操作：

有关聊天计时器的更多信息，请参阅为聊天参与者设置聊天超时。

启动计时器

在自定义参与者使用与客户建立连接后，客户将开始计时器CreateParticipantConnectionAPI。

当不兼容的参与者加入与自定义参与者的聊天时会发生什么

以下是代理或 Lex 机器人参与者加入与自定义参与者的聊天并且他们是不兼容的参与者时会发生的情况：

  1. 自定义参与者将自动断开与聊天的连接。

  2. 所有先前处于活动状态的计时器都将终止，并为连接的参与者创建新的计时器（如果配置了计时器）。

  3. 每个新的计时器还会使用最新配置进行更新（如果需要）。这实际上为聊天中的新活跃参与者建立了一个新的 “空闲会话”。

与等待区块计时器的互动

空闲计时器不会影响Wait区块的工作方式。

聊天联系人进入等待区块时启动的等待屏蔽计时器继续工作。如果 Wai t block 计时器过期，则无论是否有任何闲置的参与者计时器处于活动状态，该联系人都会恢复流程并沿着 Time Expired 分支向下传送。

故障排除技巧

如果您在呼叫自定义参与者时收到了 CreateParticipantConnectionAPI，请检查是否在 15 秒钟内呼叫CreateParticipantConnectionAPI了该参与者CreateParticipantAPI。ResourceNotFoundException