Amazon Connectから問い合わせ追跡レコード(CTR)をエクスポート

2022/04/28

Amazon Connectから発信した電話に出たのか、出なかったのかを確認したく、たどり着いた手段の一つがCTR(問い合わせ追跡レコード)のエクスポートでした。

Python SDKのboto3でAmazon ConnectのAPIから取得できないかと思い、describe_contactで試してみたものの、接続日時、切断理由がレスポンスには含まれておらずでした。

そこで、まずはCTRをS3バケットにエクスポートしてみて確認しました。
結果、接続日時、切断理由が取得できていました。
電話に出なかったときは接続していないので接続日時がnullでした。
切断理由も取得できましたが、接続日時で判定できそうなので今回は切断理由の値を詳しく調べるのはやめておきました。
ただし、Kinesis Firehoseなので、最大60秒のタイムラグが発生します。
これが許容できればありですね。

それでは設定です。

Amazon Connectで該当インスタンスを選択しました。

左ペインで[Data streaming]を選択して、「データストリーミングの有効化」をチェックしました。
送信先はKinesis Firehoseを選択しました。
FirehoseはS3バケットへ送信するよう作成済みです。

今回の要件ではエージェントイベントは発生しないので、未選択のままで作成しました。

AWS Lambda(Python)で生成した文字をAmazon Connectで音声を設定して発信する

電話を発信してみて、少し待ってからS3バケットを見るとCTRのオブジェクトが送信されていました。

マネジメントコンソールからオブジェクトを選択して[アクション]-[S3 Selectを使用したクエリ]でフォーマットをJSONにして確認しました。

電話に出なかったときのCTR

ConnectedToSystemTimestampがnullになっています。
発信先電話番号も含まれるので取り扱い注意ですね。
発信した際のレスポンスにContactIdが含まれるので、ContactIdで検索できます。

{
  "AWSAccountId": "123456789012",
  "AWSContactTraceRecordFormatVersion": "2017-03-10",
  "Agent": null,
  "AgentConnectionAttempts": 0,
  "AnsweringMachineDetectionStatus": null,
  "Attributes": {
    "ReminderText": "電話で発信した音声テキスト"
  },
  "Campaign": {
    "CampaignId": null
  },
  "Channel": "VOICE",
  "ConnectedToSystemTimestamp": null,
  "ContactDetails": {},
  "ContactId": "743c92b6-e84e-46da-a2d0-381ec0604307",
  "CustomerEndpoint": {
    "Address": "+819012345678",
    "Type": "TELEPHONE_NUMBER"
  },
  "DisconnectReason": "CUSTOMER_DISCONNECT",
  "DisconnectTimestamp": "2022-04-28T09:14:13Z",
  "InitialContactId": null,
  "InitiationMethod": "API",
  "InitiationTimestamp": "2022-04-28T09:13:13Z",
  "InstanceARN": "arn:aws:connect:ap-northeast-1:123456789012:instance/1f483564-cc9f-4b1b-8fba-3e7412d81d3e",
  "LastUpdateTimestamp": "2022-04-28T09:15:20Z",
  "MediaStreams": [
    {
      "Type": "AUDIO"
    }
  ],
  "NextContactId": null,
  "PreviousContactId": null,
  "Queue": null,
  "Recording": null,
  "Recordings": null,
  "References": [],
  "ScheduledTimestamp": null,
  "SystemEndpoint": {
    "Address": "+815098765432",
    "Type": "TELEPHONE_NUMBER"
  },
  "TransferCompletedTimestamp": null,
  "TransferredToEndpoint": null,
  "VoiceIdResult": null
}

{

"AWSAccountId": "123456789012",

"AWSContactTraceRecordFormatVersion": "2017-03-10",

"Agent": null,

"AgentConnectionAttempts": 0,

"AnsweringMachineDetectionStatus": null,

"Attributes": {

"ReminderText": "電話で発信した音声テキスト"

"Campaign": {

"CampaignId": null

"Channel": "VOICE",

"ConnectedToSystemTimestamp": null,

"ContactDetails": {},

"ContactId": "743c92b6-e84e-46da-a2d0-381ec0604307",

"CustomerEndpoint": {

"Address": "+819012345678",

"Type": "TELEPHONE_NUMBER"

"DisconnectReason": "CUSTOMER_DISCONNECT",

"DisconnectTimestamp": "2022-04-28T09:14:13Z",

"InitialContactId": null,

"InitiationMethod": "API",

"InitiationTimestamp": "2022-04-28T09:13:13Z",

"InstanceARN": "arn:aws:connect:ap-northeast-1:123456789012:instance/1f483564-cc9f-4b1b-8fba-3e7412d81d3e",

"LastUpdateTimestamp": "2022-04-28T09:15:20Z",

"MediaStreams": [

{

"Type": "AUDIO"

}

"NextContactId": null,

"PreviousContactId": null,

"Queue": null,

"Recording": null,

"Recordings": null,

"References": [],

"ScheduledTimestamp": null,

"SystemEndpoint": {

"Address": "+815098765432",

"Type": "TELEPHONE_NUMBER"

"TransferCompletedTimestamp": null,

"TransferredToEndpoint": null,

"VoiceIdResult": null

}

電話に出たときのCTR

ConnectedToSystemTimestampに日時値があります。
これで判定できそうです。

{
  "AWSAccountId": "123456789012",
  "AWSContactTraceRecordFormatVersion": "2017-03-10",
  "Agent": null,
  "AgentConnectionAttempts": 0,
  "AnsweringMachineDetectionStatus": null,
  "Attributes": {
    "ReminderText": "電話で発信した音声テキスト"
  },
  "Campaign": {
    "CampaignId": null
  },
  "Channel": "VOICE",
  "ConnectedToSystemTimestamp": "2022-04-28T09:15:09Z",
  "ContactDetails": {},
  "ContactId": "fa23008d-f42c-4293-8721-11ec1382d038",
  "CustomerEndpoint": {
    "Address": "+819012345678",
    "Type": "TELEPHONE_NUMBER"
  },
  "DisconnectReason": "CONTACT_FLOW_DISCONNECT",
  "DisconnectTimestamp": "2022-04-28T09:15:12Z",
  "InitialContactId": null,
  "InitiationMethod": "API",
  "InitiationTimestamp": "2022-04-28T09:15:04Z",
  "InstanceARN": "arn:aws:connect:ap-northeast-1:123456789012:instance/1f483564-cc9f-4b1b-8fba-3e7412d81d3e",
  "LastUpdateTimestamp": "2022-04-28T09:16:18Z",
  "MediaStreams": [
    {
      "Type": "AUDIO"
    }
  ],
  "NextContactId": null,
  "PreviousContactId": null,
  "Queue": null,
  "Recording": null,
  "Recordings": null,
  "References": [],
  "ScheduledTimestamp": null,
  "SystemEndpoint": {
    "Address": "+815098765432",
    "Type": "TELEPHONE_NUMBER"
  },
  "TransferCompletedTimestamp": null,
  "TransferredToEndpoint": null,
  "VoiceIdResult": null
}