Salesforce 連携を Comm ウィジェット 2.0 にアップグレードする

要件：

Comm ウィジェット 2.0 をご利用いただくには、BPCC 5.36.0 以降が必要です。

Comm ウィジェット 2.0 は Salesforce Lightning（Sales Cloud および Service Cloud）でのみサポートされており、Salesforce Classic ではサポートされていません。

Universal Repeater からの移行

AppExchange から新しいパッケージをインストールする

インストールページを開く前に、ブラウザで対象の SFDC 組織にログインし、AppExchange にパッケージのインストール先を認識させてください。
AgentExchange ストアから、以下のパッケージリストのリンクを開いてください。
[今すぐ入手] をクリックしてください。リストに組織が表示されない場合は、その組織のタブを更新して、もう一度お試しください。
[本番環境にインストール] を選択してください。

注：これは、Developer Edition 組織を含む、サンドボックス以外のすべての組織に対する SFDC の一般的なラベルです。
「このアプリは、お使いの Salesforce エディションに対応していません」という警告が表示された場合は、無視してください。これは Developer Edition 組織向けの標準的なメッセージです。
「利用規約を読み、同意します」のチェックボックスにチェックを入れ、「確認してインストール」をクリックしてください。
テスト中のアクセスを制限するには、アクセスレベルとして「管理者専用にインストール」を選択してください。
[インストール] をクリックし、パッケージのインストールが完了するまでお待ちください。

エンティティ ID に関する問題のトラブルシューティング

この時点で、「このエンティティ ID を持つサービスプロバイダーは既に存在します」というエラーメッセージが表示される場合があります。これは、新しいパッケージの接続アプリケーションと同じエンティティ ID を使用する接続アプリケーションが、通常は旧統合由来のものとして、組織に既に存在していることを示しています。


	アクティブな統合で使用されている既存の接続アプリケーションを削除または変更しないでください。そうすると、現在のウィジェットが動作しなくなる可能性があります。

この問題を解決する最も安全な方法は、エンティティ ID の競合が発生しない別のクリーンな組織（例：新規の無料 Developer Edition）でインストールをテストすることです。

やむを得ず同じ組織でテストを行う必要があり、かつ旧設定が本番環境で稼働していない場合は、既存の接続アプリケーションのエンティティ ID を手動で変更（[設定] > [アプリケーションマネージャー] > 該当する接続アプリケーション > [表示/編集]）し、新しいパッケージ用にその識別子を解放することができます。

インストールが成功したら、[設定] > [インストール済みパッケージ] を確認してください。古いパッケージと新しいパッケージが、異なる名前空間プレフィックス（例：BrightPattern と BrightPatternV2）を持つ別々のエントリとして表示され、競合することなく独立して動作していることを確認できます。

新しいウィジェット用のコールセンターを設定する

[設定] > [クイック検索] > [コールセンター] を選択します。通常、新しいパッケージは、Comm ウィジェット 2.0 の URL（https://tenant.brightpattern.com/agent/crmembedded/adapters/lightning.html の形式）を含むコールセンターレコードを自動的に作成します。
作成されたコールセンターを開き、以下の点を確認してください：
1. URL が、正しい Bright Pattern インスタンスの実際のドメインを指していること。
2. 「Salesforce 互換モード」が「Lightning」に設定されていること。
[コールセンターユーザーの管理] タブで [ユーザーの追加] をクリックし、テストユーザーまたはロールを追加してください。


	ユーザーは、一度に 1 つのコールセンターにのみ割り当てることができます。Comm ウィジェット 2.0 を使用する新しいコールセンターにユーザーが追加されると、そのユーザーは Universal Repeater を使用する以前のコールセンターから自動的に削除されます。これは、ウィジェットのバージョンを切り替える際の標準的な仕組みです。

ウィジェットがユーティリティバーに表示されることを確認する

対象の Lightning アプリケーションに、標準の Salesforce コンポーネントである「Open CTI ソフトフォン」が既に設定されている場合は、新しいユーティリティ項目を手動で追加する必要はありません。特定のパッケージバージョンに紐づいていないため、ユーティリティバーには、ログイン中のユーザーに現在割り当てられているコールセンターが自動的に表示されます。

手動でウィジェットを追加する必要がある場合は、既定のアプリケーション（例：標準の「Sales」アプリケーション）ではなく、このユーティリティ項目が設定されている特定の Lightning アプリケーション（[設定] > [アプリケーションマネージャー] > 対象のアプリケーション > [編集] > [ユーティリティ項目]）を開くようにしてください。そうしないと、ウィジェットパネルが表示されません。

ユーザーアクセスに関する問題のトラブルシューティング

アプリケーションが開かない場合や、テストユーザーのアプリケーションランチャーに「結果なし」と表示される場合、原因として考えられるのは、ユーザーのライセンスとプロファイルの組み合わせ、およびアプリケーションの許可プロファイルリストです。

[設定] > [ユーザー] に移動し、対象ユーザーのレコードを開いて [編集] を選択してください。
「ユーザーライセンス」を「Salesforce Platform」（または、正常に動作しているテストユーザーが使用しているライセンス）に変更し、適合するプロファイル（例：Standard Platform User）を選択して、「保存」をクリックしてください。

注：[ユーザーライセンス] フィールドによって、選択可能なプロファイルが制限されます。制限付きライセンス（例：「Force.com - App Subscription」）では、カスタムアプリケーションを表示できない限定的なプロファイルのみが付与されます。
正しいプロファイルが設定されていても、そのプロファイルがアプリケーション自体のアクセスリストに明示的に追加されていない限り、アプリケーションが表示されない場合があります。[設定] > [アプリケーションマネージャー] > 該当のアプリケーション > [編集] > [ユーザープロファイル] > プロファイルを追加 > [保存] の順に操作してください。
ページを更新し、テストユーザーとしてアプリケーションランチャー経由でアプリケーションを再度開いてみてください。

最終確認

テストユーザーとして、コールセンター用の新しい Lightning アプリケーションを開き、ユーティリティバーの「電話」パネルを展開してください。「Agent Desktop — Powered by Bright Pattern」のログイン画面が表示されれば、新しい Comm ウィジェット 2.0 が接続済みで、正常に動作しています。

複数のウィジェットバージョンの同時使用

Universal Repeater ウィジェットと Comm ウィジェット 2.0 ウィジェットは別々のパッケージとしてインストールされるため、同じ Salesforce 組織内で並行して実行できます。これは、段階的な移行やテストに役立ちます。ユーザーは一度に 1 つのコールセンターにしか割り当てられないため、ウィジェットのバージョンを切り替えるには、ユーザーまたはロールを目的のコールセンターレコードに再割り当てするだけで済み、その他の設定は不要です。

同じ SFDC 環境で異なるバージョンのウィジェットを実行するには：

前述の手順に従って、Comm ウィジェット 2.0 アプリケーションパッケージをダウンロードしてください。
https://example.brightpattern.com/agent/crmembedded/adapters/lightning.html という形式の Agent Desktop URL を使用して、新しい SFDC コールセンターを設定します。
これを必要なユーザーロール（既存のロールまたは新しく作成したロール、例：「NewWidgetUser」）に割り当ててください。
上記の手順で既存のロールを使用した場合は、Universal Repeater ウィジェットを含む元のコールセンターオブジェクトを開き、そのユーザーロールの割り当てを削除してください。< 前へ | 次へ >