【Amazon Connect Salesforce CTI Adapter】着信ポップアップの設定と動作(v5.22)

CTI Adapter for Salesforceの機能で着信時に顧客レコードをポップアップできるのですが、バージョン 5.22で指定方法が変わったようです。変更点を確認します。

概要
現状確認
- CTIフローを確認
- 電話を着信させる
修正パターン1
- 動作確認
修正パターン2
- 動作確認
まとめ

概要

顧客レコードポップアップについては下記ポストで機能確認・紹介しています。
この際はバージョン 5.19でしたが、2024年6月現在のバージョン 5.22 ではそのままの設定では動作しないようです。
確認して、従来と同等の動作をするように設定変更します。

blog.serverworks.co.jp

現状確認

バージョン5.22で動作を確認します。
なお、5.19から5.22へバージョンアップ、または5.22を新規インストールしてみましたが、いずれも同じ挙動でした。
どちらのパターンも同じ対応になると思います。

CTIフローを確認

着信時のCTIフローを確認します。
下記はCTIアダプターインストール時に自動設定される Default Voice Contact onConnecting を編集している画面です。
「検索とスクリーンポップ」ブロックが設定され、検索パラメータとして $.contact.parsedNumber.phone と指定されていることが確認できます。

電話を着信させる

着信時のフロー動作ログを確認します。

エラーが見えます。

"code": "INVALID_PARAM",
"description": "パラメーター searchParams に無効な値が渡されました。A string length greater than 2 was expected, but string of length 2 was found instead。"

searchParamsへ渡された値が短すぎるようです。指定している $.contact.parsedNumber.phone の $.contact オブジェクトを確認してみます。

{
    "contactId": "xxxxxxxxxxxxxxxxxx",
    "originalContactId": "xxxxxxxxxxxxxxxxxx",
    "type": "voice",
    "status": {
        "type": "connecting",
        "timestamp": "2024-06-05T10:35:07.626Z"
    },
    "statusDuration": 41,
    "queue": {
        "queueARN": "arn:aws:connect:ap-northeast-1:....",
        "name": "BasicQueue",
        "queueId": "arn:aws:connect:ap-northeast-1:...."
    },
    "queueTimestamp": "2024-06-05T10:35:07.262Z",
    "attributes": {
    },
    "isSoftphoneCall": true,
    "isInbound": true,
    "isConnected": false,
    "isTransfer": false,
    "parsedNumber": {
        "country": "JP",
        "countryCallingCode": "81",
        "nationalNumber": "9011112222",
        "number": "+819011112222",
        "__countryCallingCodeSource": "FROM_NUMBER_WITH_PLUS_SIGN"
    },
    "phone": "9011112222",
    "country": "JP",
    "formattedPhoneNumber": "9011112222",
    "formattedPhoneNumberE164": "+819011112222",
    "rawPhoneNumber": "+819011112222",
    "channel": "Voice",
    "callType": "inbound"
}