Amazon Connect でメッセージストリーミングを有効にした後、Amazon SNS ペイロードを使用する - Amazon Connect
ペイロードのメッセージ属性SNS ペイロードの例

Amazon Connect でメッセージストリーミングを有効にした後、Amazon SNS ペイロードを使用する

メッセージのストリーミングを正常に有効化した後、目的の参加者 (エージェント、お客様、またはすべて) にメッセージを送信するため、それらをフィルタリングする必要がある場合があります。

参加者でメッセージをフィルタリングするには、特定の SNS ヘッダー属性 (MessageVisibility) を読み取り、メッセージが顧客専用、エージェントのみ、またはすべてを対象とするかどうかを判別します。

  • お客様のみに送信する: お客様が直接目にするすべてのコードについて、クライアントはお客様向けのメッセージをフィルタリングし、メッセージを転送するための次のロジックを構築する必要があります。

    if ( ( MessageVisibility == CUSTOMER || MessageVisibility == ALL)  && ParticipantRole != CUSTOMER )

  • エージェントのみに送信する: 

    if ( ( MessageVisibility == AGENT || MessageVisibility == ALL)  && ParticipantRole != AGENT )

カスタムのサブスクリプションフィルターポリシーを構築して Amazon SNS のフィルタリング機能を活用することもできます。これにより、メッセージフィルタリングロジックが SNS トピックのサブスクライバーから SNS サービス自体にオフロードされます。

ペイロードのメッセージ属性

Amazon SNS ペイロードの各メッセージ属性の説明を以下に示します。

  • InitialContactId: チャットの最初の問い合わせ ID。

  • ContactId: チャットの現在の問い合わせ ID。InitialContactId と ContactId はチャットまたはキュー間の問い合わせフローに新しいエージェントが存在したかどうかで異なる場合があります。

  • ParticipantRole: メッセージを送信した参加者。

  • InstanceId: Amazon Connect インスタンス ID。

  • AccountId: AWS アカウント ID。

  • Type: 使用できる値: EVENT、MESSAGE。

  • ContentType: 使用できる値: application/vnd.amazonaws.connect.event.typing、application/vnd.amazonaws.connect.event.participant.joined、application/vnd.amazonaws.connect.event.participant.left、application/vnd.amazonaws.connect.event.transfer.succeeded、application/vnd.amazonaws.connect.event.transfer.failed、application/vnd.amazonaws.connect.message.interactive、application/vnd.amazonaws.connect.event.chat.ended、その他。

  • MessageVisibility: 使用できる値: AGENT、CUSTOMER、ALL。

SNS ペイロードの例

{
  "Type" : "Notification",
  "MessageId" : "ccccccccc-cccc-cccc-cccc-ccccccccccccc",
  "TopicArn" : "arn:aws:sns:us-west-2:009969138378:connector-svc-test",
  "Message" :  "{\"AbsoluteTime\":\"2021-09-08T13:28:24.656Z\",\"Content\":\"help\",\"ContentType\":\"text/plain\",\"Id\":\"333333333-be0d-4a44-889d-d2a86fc06f0c\",\"Type\":\"MESSAGE\",\"ParticipantId\":\"bbbbbbbb-c562-4d95-b76c-dcbca8b4b5f7\",\"DisplayName\":\"Jane\",\"ParticipantRole\":\"CUSTOMER\",\"InitialContactId\":\"33333333-abc5-46db-9ad5-d772559ab556\",\"ContactId\":\"33333333-abc5-46db-9ad5-d772559ab556\"}",
  "Timestamp" : "2021-09-08T13:28:24.860Z",
  "SignatureVersion" : "1",
  "Signature" : "examplegggggg/1tEBYdiVDgJgBoJUniUFcArLFGfg5JCvpOr/v6LPCHiD7A0BWy8+ZOnGTmOjBMn80U9jSzYhKbHDbQHaNYTo9sRyQA31JtHHiIseQeMfTDpcaAXqfs8hdIXq4XZaJYqDFqosfbvh56VPh5QgmeHTltTc7eOZBUwnt/177eOTLTt2yB0ItMV3NAYuE1Tdxya1lLYZQUIMxETTVcRAZkDIu8TbRZC9a00q2RQVjXhDaU3k+tL+kk85syW/2ryjjkDYoUb+dyRGkqMy4aKA22UpfidOtdAZ/GGtXaXSKBqazZTEUuSEzt0duLtFntQiYJanU05gtDig==",
  "SigningCertURL" : "https://sns.us-west-2.amazonaws.com/SimpleNotificationService-11111111111111111111111111111111.pem",
  "UnsubscribeURL" : "https://sns.us-west-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-west-2:000000000000:connector-svc-test:22222222-aaaa-bbbb-cccc-333333333333",
  "MessageAttributes" : {
    "InitialContactId" : {"Type":"String","Value":"33333333-abc5-46db-9ad5-d772559ab556"},
    "MessageVisibility" : {"Type":"String","Value":"ALL"},
    "Type" : {"Type":"String","Value":"MESSAGE"},
    "AccountId" : {"Type":"String","Value":"999999999999"},
    "ContentType" : {"Type":"String","Value":"text/plain"},
    "InstanceId" : {"Type":"String","Value":"dddddddd-b64e-40c5-921b-109fd92499ae"},
    "ContactId" : {"Type":"String","Value":"33333333-abc5-46db-9ad5-d772559ab556"},
    "ParticipantRole" : {"Type":"String","Value":"CUSTOMER"}
  }
}