【Salesforce】Amazon Connect - Universal Packageのアップグレード注意点（v5.24以前 → v5.27）

概要

「Amazon Connect - Universal Package」 とは、Salesforce上でCTI Adapter を利用するためにインストールするSalesforce管理パッケージです。
Amazon ConnectとSalesforceを連携させることで、電話・顧客対応業務をSalesforce上で一元管理できるようになります。

本記事では、v5.24以前からv5.27へアップグレードする際の注意点と手順をまとめました。

注意点

• 対象バージョン：v5.24以前 → v5.27（2025年5月時点）
• v5.24.3を経由した2段階アップグレードが推奨されており、これをスキップするとアップグレード時にエラーになります
• 本手順に従うことで、古い未使用のApexクラスやVisualforceページが安全に削除され、パッケージがクリーンな状態に保たれます

v5.24.3を経由せずにv5.27へアップグレードを行う場合

そのままアップグレードしようとすると下記のようなエラーが発生し、アップグレードできません。
このエラー回避対応のためにパッチあてを行い、後述に記載のアップグレード手順に沿って進める。

この設定の背景については、公式リリースノート（2025年4月リリース）に明記されています。

(※ キャプチャは日本語訳にしております)

アップグレード手順

ステップ1：v5.24.3へのアップグレード

まず、上記キャプチャのリンクである「パッチ」からv5.24.3 をインストールします。

ステップ2：バージョン確認

1. Salesforceの「設定」画面を開きます
2. クイック検索バーで「インストール済みパッケージ」と入力し、該当ページにアクセスします
3. 「Amazon Connect - Universal Package」のバージョンが5.24.3になっていることを確認します

ステップ3：v5.27へのアップグレード

次に、以下のリンクからv5.27にアップグレードします。
Amazon Connect - Universal Package v5.27 をインストール
(※ 当作業時の最新バージョンは5.27)

ステップ4：再度バージョン確認

同様に、「インストール済みパッケージ」からv5.27に更新されていることを確認します。

ステップ5：動作確認

• Amazon Connect CTIの通話起動・通話記録・通話後処理など、一通りの機能が問題なく動作するか確認します
• カスタムCTIフローやLightningコンポーネントを利用している場合、それらもテストしてください

参考リンク

• Amazon Connect Salesforce CTI Adapter リリースノート（公式）

まとめ

• 2段階アップグレードが必要なバージョンですので、直接v5.27にアップグレードできないため注意が必要です

• 今回のアップグレードでは未使用リソースの削除が含まれており、パフォーマンス改善や管理性の向上が期待できます