View a markdown version of this page

设置 Connect 客户案例活动流 - Amazon Connect Customer
步骤 1：创建 Connect 客户实例并启用客户档案步骤 2：添加 Cases 域步骤 3：创建案例模板步骤 4：启用案例事件流并设置为将事件接收到 SQS 队列中步骤 5：测试案例事件流步骤 6：案例事件流的使用案例

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

设置 Connect 客户案例活动流

本主题介绍如何设置和使用案例事件流。某些入门步骤要求您调用 Connect 客户案例 API。

步骤 1：创建 Connect 客户实例并启用客户档案

  1. 确保在 AWS 区域 其中一个有案例可用的 Connect 客户实例中有一个正常运行的 Connect Customer 实例。请参阅不同区域的案例可用性。

  2. 启用 Connect 客户档案。有关说明，请参阅为您的 Connect 客户实例启用客户档案。

    Connect 客户案例需要客户档案，因为每个案例都必须与客户档案服务中的客户资料相关联。

第 2 步：将案例域添加到您的 Connect 客户实例

有关说明，请参阅使用 Connect 客户控制台启用案例。

如果您想使用 API 添加案例域，请参阅 Connect 客户案例 CreateDomainAPI 参考中的 API。

步骤 3：创建案例模板

创建案例模板。在步骤 6：测试案例事件流中，您将使用该模板。

如果您想使用 API 创建案例模板，请参阅 Connect 客户案例 CreateTemplateAPI 参考中的 API。

步骤 4：启用案例事件流并设置为将事件接收到 SQS 队列中

运行以下命令，为您的 Cases 域启用案例事件流。运行此命令后，创建或更新案例时，事件将发布到您账户中 EventBridge 服务的默认总线（该总线必须与您的案例域 AWS 区域 相同）。

aws connectcases put-case-event-configuration --domain-id dad5efb6-8485-4a55-8241-98a88EXAMPLE --event-bridge enabled=true

默认情况下，Connect 客户案例发布的事件仅包含有关案例的元数据templateId，例如caseIdcaseArn、approximateChangeTime、、等。您可以运行以下命令来获取有关要包含在事件中的案例（在生成事件时）的更多信息。

注意

如果您想在事件中包含自定义字段，请使用自定义字段 ID。有关如何查找自定义字段 ID 的说明，请参阅查找自定义字段 ID。

# You can include any other field defined in your cases domain in the fields section.
# To list the fields that are defined in your cases domain, call the Cases ListFields API.
# To include case fields that you create (custom fields) in the event, enter the custom field ID.
aws connectcases put-case-event-configuration --domain-id YOUR_CASES_DOMAIN_ID --event-bridge "{
    \"enabled\": true, 
    \"includedData\": {
       \"caseData\": {
          \"fields\": [
          {
          \"id\": \"status\"
          },
          {
          \"id\": \"title\"
          },
          {
          \"id\": \"customer_id\"
          },
         {
          \"id\": \"your custom field ID\"
          }
        ]
      },
      \"relatedItemData\": {
      \"includeContent\": true
      }
    }
  }"

接下来，创建 Amazon SQS 队列并将其设置为 EventBridge 总线上的 Connect 客户案例事件的目标，以便将所有案例事件传送到 SQS 队列以供日后处理。

# Create an SQS queue
aws sqs create-queue --queue-name case-events-queue --attributes "{\"Policy\": \"{ \\\"Version\\\": \\\"2012-10-17\\\", \\\"Statement\\\": [{ \\\"Sid\\\": \\\"case-event-subscription\\\", \\\"Effect\\\": \\\"Allow\\\", \\\"Principal\\\": { \\\"Service\\\": \\\"events.amazonaws.com\\\"}, \\\"Action\\\": \\\"SQS:SendMessage\\\", \\\"Resource\\\": \\\"*\\\"}]}\"}"

# Create an rule on the EventBridge default bus that represents the case events
aws events put-rule --name case-events-to-sqs-queue --event-pattern "{\"source\": [\"aws.cases\"]}" --state ENABLED

# Ask event bridge to publish case events to the SQS queue.
aws events put-targets --rule case-events-to-sqs-queue --target "[{
\"Id\": \"target-1\",
\"Arn\": \"arn:aws:sqs:The AWS Region of your Amazon Connect instance:your AWS account ID:case-events-queue\"
}]"

步骤 5：测试案例事件流

使用 Connect 客户代理应用程序可以：

  1. 接受聊天联系人。

  2. 创建客户资料并将其与聊天联系人相关联。

  3. 创建案例。

    注意

    在您接受联系人并将该联系人与客户资料相关联之前，案例选项卡上的创建案例按钮处于非活动状态。

导航至 Amazon SQS 控制台，检查您的 SQS 队列中是否有针对新创建案例的案例事件（类型：CASE.CREATED）。同样，您可以修改上一步中创建的案例，并在 SQS 队列中获取相应的案例事件（类型：CASE.UPDATED）。您可以将联系人与问题相关联，并对问题发表评论，以同样获取针对这些操作的案例事件。

步骤 6：案例事件流的使用案例

每当创建案例、更新案例、联系人与案例关联以及对案例添加评论时，案例事件流都会发布事件。您可以将这些事件用于：

  • 指标、分析和控制面板

  • 构建通知用户（例如，发送电子邮件）的应用程序

  • 根据特定类型的案例更新触发的自动操作

例如，您可以使用 SQS 目标 EventBridge （如步骤 4 所示）将案例事件临时存储在 SQS 队列中，并使用 Lambda 函数处理 SQS 中的事件以构建自定义应用程序，例如在客户案例更新时向其发送电子邮件、自动解决与案例相关的所有任务等。同样，你可以使用上的 Firehose 目标将案例事件存储 EventBridge 到 S3 存储桶中，然后使用 ETL，Athena AWS Glue 用于临时分析，Quick 用于仪表板。