翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Connect Cases イベントストリームのセットアップ

このトピックでは、ケースイベントストリームを設定および使用する方法について説明します。オンボーディング手順の一部では、Amazon Connect Cases APIsを呼び出す必要があります。

ステップ 1: Amazon Connect インスタンスを作成し、Customer Profiles を有効にする

ステップ 2: Amazon Connect インスタンスに Cases ドメインを追加する

手順については、Amazon Connect コンソールを使用してケースを有効にする を参照してください。

を使用してケースドメインを追加する場合はAPI、Amazon Connect Cases APIリファレンスCreateDomainAPI」の「」を参照してください。

ステップ 3: ケーステンプレートを作成する

ケーステンプレートを作成する 「ステップ 6: ケースイベントストリームをテストする」では、テンプレートを使用します。

を使用してケーステンプレートを作成する場合はAPI、Amazon Connect Cases APIリファレンスCreateTemplateAPI」の「」を参照してください。

ステップ 4: ケースイベントストリームとセットアップを有効にしてSQSキューにイベントを受信する

次のコマンドを実行して、Cases ドメインのケースイベントストリームを有効にします。このコマンドの実行後、ケースが作成または更新されると、イベントがアカウントの EventBridge サービスのデフォルトバスに発行されます (Cases ドメイン AWS リージョン と同じ にある必要があります）。

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

デフォルトでは、Amazon Connect Cases によって発行されたイベントには、templateId、caseId、caseArn、approximateChangeTime などのケースに関するメタデータのみが含まれます。次のコマンドを実行して、(イベントの生成時点における) ケースに関する詳細情報を取得して、イベントに含まれるようにすることができます。

# 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 バス上の Amazon Connect Cases イベントのターゲットとして設定して、すべてのケースイベントが後で処理するために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 defualt 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: ケースイベントストリームをテストする

Amazon Connect エージェントアプリケーションを使用して、次のことを行います。

Amazon SQSコンソールに移動し、新しく作成されたケースのケースイベント (タイプ: CASE.CREATED) がSQSキューで使用可能であることを確認します。同様に、上記で作成したケースを変更し、対応するケースイベント (タイプ: CASE.UPDATED) をSQSキューに取得できます。問い合わせをケースに関連付けて、ケースにコメントを残し、それらのアクションのケースイベントを取得することもできます。

ステップ 6: ケースイベントストリームのユースケース

ケースイベントストリームは、ケースの作成、ケースの更新、連絡先のケースへの関連付け、ケースへのコメントの追加のたびに、イベントを発行します。これらのイベントは次の目的で使用できます。

例えば、 EventBridge （ステップ 4 に示すように) の SQS ターゲットを使用してケースイベントをSQSキューに一時的に保存し、Lambda 関数を使用して のイベントを処理しSQSて、ケースが更新されたときに E メールを送信したり、ケースにリンクされたタスクを自動的に解決したりするなどのカスタムアプリケーションを構築できます。同様に、 の Firehose ターゲットを使用してケースイベント EventBridge を S3 バケットに保存しETL、 AWS Glue には 、アドホック分析には Athena、ダッシュボード QuickSight には Amazon を使用できます。