前提条件
Saleforce API Version ： v55.0
serverlessrepo-AmazonConnectSalesforceLambda ： 5.19.0
この記事は、2022/10頃に書かれています。
AmazonConnectのGUIの問題（その内VerUpで解消されるかも？）だったり、自分の理解不足の問題だったりするので、備忘以外の何物でもないかもしれません。
同じハマり方をした人に届いたらいいな？と自分への備忘も兼ねて
トラブルの内容
公式のインストール手順書は下記の通り
前提として
の有効化が必要である。
この手順通りに設定してもデータ連携ができなかった。というのが、今回の記事の主旨になります。
初見の視点で手順書からは分かりにくい前提や、躓きやすい事を、備忘録として書き残しておきます。
問題の内容
今回は、エラーメッセージらしきエラーはありません。
- Firehoseでのストリーミング出力設定から、DataStreamへの切り替えがGUIで出来ない？（疑惑）
- コンタクトチャネル分析（ContactLens）のDataStreamとコンタクト追跡レコード（CTR）のDataStreamは共用できない。
後者の、『DataStreamは共用できない』は、それ以上でも、それ以下でもないので、後述は省略します。
（しいて言えば、コンタクト追跡レコード（CTR）のデータ連携は、Firehose→S3トラガー式の連携も提供して欲しいとAWSへ要望を出すか、提供されたLambdaを元に自作してしまうか、、、、なレベル）
CLI 調査に必要なコマンドのドキュメント詳細の在処
- 現状の設定情報確認をする
- CLIからストリームを紐づける
- CLIからストリーム紐づけを解除する
最後に信じるべきは、GUIではなくCLIである。久々にコレを痛感させられた出来事
検証（ 未設定 → Firehose ）への切り替え
未設定の状態からFirehose経由の出力するのは問題なし
aws connect list-instance-storage-configs --instance-id AmazonConnectインスタンスID --resource-type CONTACT_TRACE_RECORDS
{
"StorageConfigs": [
{
"AssociationId": "自動採番",
"StorageType": "KINESIS_FIREHOSE",
"KinesisFirehoseConfig": {
"FirehoseArn": "arn:aws:firehose:ap-northeast-1:AWSアカウントID:deliverystream/Firehoseストリーム名"
}
}
]
}
検証（ Firehose → DataStream ）への切り替え
CLIで設定情報を確認すると。。。
aws connect list-instance-storage-configs --instance-id AmazonConnectインスタンスID --resource-type CONTACT_TRACE_RECORDS
{
"StorageConfigs": []
}
何も割当たってない。。。。
『ちょっ、まっ！』コマンドの結果を見て、驚きの声が隠せませんでした。
（気が付くまでに結構な時間が溶けた）
勿論、このままでは『コンタクト追跡レコード』のデータ連携は出来ません。
なので、GUIでの設定は諦めて、CLIで設定をかけます。
ストリーム割りてのコマンド実行と結果
aws connect associate-instance-storage-config --instance-id AmazonConnectインスタンスID --resource-type CONTACT_TRACE_RECORDS --storage-config StorageType=KINESIS_STREAM,KinesisStreamConfig={StreamArn=arn:aws:kinesis:ap-northeast-1:AWSアカウントID:stream/ストリーム名}
{
"AssociationId": "自動採番"
}
設定情報の確認
aws connect list-instance-storage-configs --instance-id AmazonConnectインスタンスID --resource-type CONTACT_TRACE_RECORDS
{
"StorageConfigs": [
{
"AssociationId": "自動採番",
"StorageType": "KINESIS_STREAM",
"KinesisStreamConfig": {
"StreamArn": "arn:aws:kinesis:ap-northeast-1:AWSアカウントID:stream/ストリーム名"
}
}
]
}
ふぅ、CLIなら無事に設定がかかるようです。
CLIで設定をかけたら、無事にSalesforceへデータ連携も出来ました。
検証（ DataStream → Firehose ）への切り替え
こちらは、どうでしょうか、、、
GUIで再度割り当てて、CLIで設定内容を確認します。
設定情報の確認
aws connect list-instance-storage-configs --instance-id AmazonConnectインスタンスID --resource-type CONTACT_TRACE_RECORDS
{
"StorageConfigs": [
{
"AssociationId": "自動採番",
"StorageType": "KINESIS_FIREHOSE",
"KinesisFirehoseConfig": {
"FirehoseArn": "arn:aws:firehose:ap-northeast-1:AWSアカウントID:deliverystream/Firehoseストリーム名"
}
}
]
}
こちらの場合は、大丈夫のようですね。
まとめ
- コンタクト追跡レコードは、一度でもFirehose出力の設定をかけるとCLIを使わないとDataStreamへの変更ができない
- Firehoseへの出力設定は、GUIを利用して設定することが可能
GUIで切り替えられるんだったら、Firehoseの出力も試してみるか、、、と安易な気持ちで試したらDataStream連携への設定に戻らなくなって困ったけど、何とかなった話しでした。
おまけ（CLIを叩くのに付与したロールとポリシー）
ほぼほぼデバックの為のCLI実行だったので。。。
- AmazonConnect_FullAccess(組み込みポリシー)
- カスタムポリシー
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": "iam:PutRolePolicy",
"Resource": "arn:aws:iam::AWSアカウントID:role/*"
}
]
}
を付与して実行しました。
ストレージ系の割当変更の実行には、"iam:PutRolePolicy"も必要なようです。
AmazonConnect トラブルシュートシリーズ
AWSの相談・お困りごとありましたら、、、
AWSの活用方法や、お困りごとの相談、随時、お仕事の受付しております。