設定手順を実行する前に、まずリリースノートにアクセスし、最新バージョンの Webex アプリ Salesforce パッケージをダウンロードする必要があります。

要件

Salesforce エンタープライズ エディション

このインテグレーションでは、少なくとも Salesforce エンタープライズ エディションをインストールする必要があります。 詳細については、「Salesforce エディション」をご覧ください。

Salesforce.org の「私のドメイン」

Lightning コンポーネントを使用するには、「私のドメイン」を組織内に展開する必要があります。 詳細については、Salesforce の「私のドメイン」のドキュメントを参照してください。

Control Hub のユーザー アクセス

組織内のインテグレーションへのユーザー アクセスを構成する必要があります。

• Pro Pack がない場合 - 基本 Control Hub を使用している場合、すべてのインテグレーションへのすべてのユーザー アクセスを許可または拒否することを選択できます。

• Pro Pack がある場合 - Pro Pack では、ユーザーのインテグレーションへのアクセスを管理するための高度な機能が使用できます。

詳細については、「インテグレーションへのユーザー アクセスを設定する」を参照してください。

通話

• Webex Calling は Salesforce 内の通話コントロールで、着信と発信が完全にサポートされています。

• Webex (Unified CM) での通話は部分的にサポートされています。 発信コールのときにのみ、Salesforce へのロギング ポップアップが表示されます。 着信の場合、Webex アプリの着信音が鳴りますが、Salesforce での通話のインターセプトは行えないため、ロギング ポップアップは表示されません。

Webex for Salesforce バージョン 1.18 以前を使用している場合、Salesforce 内で Webex Calling を使用する前に、Salesforce 認証を設定する必要があります。 この記事のセクションに従って、起動して実行してください。

これらの手順は、バージョン 1.18 以前の Webex Salesforce インテグレーションを使用している顧客に適用されます。 バージョン 1.19 以降の更新された手順を参照してください。 [インストールと管理] タブで Salesforce 認証 (1.19 以降) を設定します。

1. 接続済みアプリの作成

新しい接続済みアプリを作成するには:

1. ［設定］で［アプリマネージャ］を検索し、［新規接続済みアプリ］を選択します。

   

2. 接続済みアプリ名（MyExampleAppなど）を入力します。
3. 連絡先メール アドレスを入力します。
4. [OAuth 設定を有効にする] にチェックを入れます。
5. プレースホルダーのコールバック URL を指定します（後で更新します）。たとえば、https://localhost/placeholder などです。

   

6. 下にスクロールして、次の OAuth スコープを選択します。
   • フルアクセス（full）
   • いつでもリクエストを実行する (refresh_token, offline_access)

   

   Perform requests at any time scope により、セッションが期限切れになったときに、名前付き資格情報がアクセス トークンを更新できます。

7. ページの一番下までスクロールし、［保存］をクリックし、次に［続行］をクリックします。
8. 次のページで、[API (Enable OAuth Settings)] までスクロールし、[コンシューマー詳細の管理]をクリックします。

   

   Salesforce で再認証する必要がある場合があります。

9. コンシューマーキーとコンシューマーシークレットをメモします。

   

2. 認証プロバイダの作成

次に、認証プロバイダを作成する必要があります。これにより、Salesforce 組織での認証が容易になります。

認証プロバイダを作成するには:

1. 「設定」で「認証」を検索し、「認証」を選択します。 プロバイダー。 [新規] をクリックします。

   

2. [プロバイダーのタイプ]として[Salesforce]を選択します。
3. 認証プロバイダの名前を入力します（ApexMDTAPIなど）。
4. Connectedアプリの設定時に保存したコンシューマーキーとコンシューマーシークレットに貼り付けます。
5. Default Scopes、full refresh_token offline_accessに次の範囲を入力します。
6. その他はすべて空欄にし、「保存」をクリックします。

   

7. [Salesforce の設定]セクションからコールバック URLをコピーします。

   

8. 接続済みアプリを編集し、プレースホルダー URL を上のSalesforce 設定からコピーしたコールバック URLに置き換えます。

   

9. 接続済みアプリを保存します。

   設定が有効になり、Salesforce のインフラストラクチャ全体に伝播できるように、最大 10 分待つ必要がある場合があります。

3. 名前付きクレデンシャルを作成する

次に、名前付きのクレデンシャルを作成する必要があります。

名前付きクレデンシャルを作成するには:

1. [設定]で、[名前]を検索し、[名前のクレデンシャル]を選択します。 [新規レガシー] をクリックします。

   

2. ラベルのApexMDTAPIに次の値を入力します。
3. URLには、組織のインスタンスURL（https://na1.salesforce.comなど）を入力します。または、マイドメインを使用している場合は、完全修飾されたマイドメインドメイン名（https://mycompany.my.salesforce.comなど）を入力します。
4. IDタイプの場合は、「ネームドプリンシパル」を選択します。
5. 認証プロトコルの場合は、「OAuth 2.0」を選択します。
6. 認証プロバイダの場合、先ほど作成した認証プロバイダを選択します。
7. Scopeの場合はfull refresh_token offline_accessと入力します。
8. [保存] で [認証フローの開始] を有効にします。

   

9. [コールアウトオプション（Callout Options）] で、[HTTP 本文のマージフィールドを許可（Allow Merge Fields in HTTP Body）] を有効にして、[保存] をクリックします。

   

10. 組織にログインするようにプロンプトが表示されます。 ログインすると、[アクセスを許可] ダイアログが表示されます。 [許可] をクリックします。
11. その後、［ネームドクレデンシャル］画面にリダイレクトされ、［認証ステータス］に［your-email@domain.comとして認証済み］と表示されます。

4. Webex 管理画面でサイトを作成する

最後に、下のCallingタブCreate site for callingの次のトピックに進みます。

サイト設定の際は、上記の命名規則に従ってください。

Webex for Salesforce インテグレーション バージョン 1.19 以降の場合、この記事の指示に従って、承認、名前付き資格情報、および認証プロバイダ用の既存の Webex Connected アプリを削除し、新しい Webex Connected App for Salesforce 認証を作成します。

これらの手順は、バージョン 1.19 以降の Webex Salesforce インテグレーションを使用する顧客に適用されます。 バージョン 1.18 以前の手順については、「インストールと管理」タブの「Salesforce 認証の設定 (1.18 以降)」を参照してください。

既存の Webex Connected アプリ、名前付き資格情報、および認証プロバイダを削除する

以前に Webex Connected アプリの認証、名前のクレデンシャル、または認証プロバイダを作成している場合は、継続する前に削除する必要があります。 それ以外の場合は、下の新しい Webex 接続アプリを作成してください。

既存の Webex Connected アプリを削除します。

1. Salesforce ランディングページの右上隅にある歯車アイコンを選択し、[設定] を選択します。
2. ［クイック検索］テキストボックスに「アプリマネージャ」と入力し、リストから選択します。
3. リストの Webex 接続済みアプリまでスクロールし、エントリの右側にある下矢印アイコンをクリックして、[表示] を選択します。
4. 「削除」を選択し、確認を求められたら「削除」を再度選択します。

既存の Webex の名前付き資格情報を削除します。

1. 「クイック検索」テキストボックスに「名前付き資格情報」と入力し、リストから選択します。
2. 2. Webex の名前付き資格情報エントリの右側にある下矢印をクリックし、[削除] を選択します。
3. 3. 確認を求められたら、もう一度削除を選択してください。

既存の Webex 認証プロバイダを削除する:

1. 「クイック検索」テキストボックスに「認証」と入力します。 プロバイダー を選択し、リストから選択します。
2. Webex 認証プロバイダのエントリの先頭にある Del リンクを選択します。
3. 確認を求められたらOKを選択します。

次のセクションに進み、新しい Webex Connected App for Salesforce 認証を作成します。

Salesforce 認証用の新しい Webex Connected アプリを作成する

Salesforce 認証用の新しい Webex 接続アプリを作成するには:

1. Salesforce ランディングページの右上隅にある歯車アイコンを選択し、[設定] を選択します。
2. ドメイン URL を取得する: ［クイック検索］で［ドメイン］を検索して選択し、［マイドメイン］からURLを保存します。

1. ［クイック検索］テキストボックスに「アプリマネージャ」と入力し、リストから選択します。
2. 接続されたアプリ名（Webex Salesforce 認証など）を入力します。
3. 連絡先メールのメールアドレスを入力します。
4. [OAuth 設定を有効にする] にチェックを入れます。
5. 先ほど取得した URL を使用して 2 つのコールバック URL を入力し、1 行に 1 つ、接尾辞として /apex/ webexsfdcauth と /apex/ cisco_webex__webexsfdcauth を追加します。 例:

   https://my-company.my.salesforce.com/apex/webexsfdcauth

   https://my-company.my.salesforce.com/apex/cisco_webex__webexsfdcauth（https://my-company.my.salesforce.com/apex/cisco_webex__webexsfdcauth）

6. [選択済みOAuthスコープ(Selected OAuth Scopes)] の [使用可能なOAuthスコープ(Available OAuth Scopes)] リストから次のスコープを選択します。
   • フルアクセス（full）
   • いつでもリクエストを実行する (refresh_token, offline_access)
7. サポートされる認証フローのCode Exchange（PKCE）拡張機能の証明キーが必要のチェックを外します。
8. 接続されたアプリを保存 し、後で使用するために生成されたコンシューマーキーとコンシューマーシークレットをメモします。

新しいパックが公開されたら、「Salesforce に Webex アプリをインストールする」の手順に従ってください。 最初に古いバージョンをアンインストールする必要はなく、設定した内容が失われることもありません。

新しいインストール パックの情報とダウンロード場所については、「Webex Salesforce インテグレーションのリリース ノート」をご覧ください。

通話履歴を有効または無効にするには:

1. Webex 管理に移動します。
2. Webex 通話履歴まで下にスクロールします。
3. トグルを、有効または無効のいずれかで、必要な設定に切り替えます。

   有効にすると、すべてのユーザーとプロファイルで通話履歴を利用できます。

CUCM および Broadworks ユーザーの場合、次の機能はサポートされていません。

• Salesforce グローバル ダイヤラーで着信コールを受信する (Webex アプリは引き続き着信コールを受信します)
• アウトバウンドコールを正常に配置した後、Salesforce の通話ログウィンドウで通話期間を表示する
• 発信コールを正常に配置した後、Salesforce 通話ログウィンドウのボタンを使用して通話を終了する
• 発信コールを終了した後、Salesforce の通話ログウィンドウに通話期間を自動的に入力する

すべての Salesforce インテグレーションでは、次の制限事項に注意してください。

• Salesforce はイベント数の制限 (25,000) を強制します。これにより、使用量が多い場合にインテグレーションが失敗する可能性があります。 Salesforce パッケージは、その制限を増やすために利用できます。 詳細については、https://developer.salesforce.com/docs/atlas.en-us.platform_events.meta/platform_events/platform_event_limits.htmを参照してください。

Webex Webinars Import Webinar Data 設定パネルを使用して、承認された Salesforce ユーザーは、Webex ウェビナーの招待者、登録者、および出席者をリードや連絡先などの Salesforce オブジェクトに直接インポートできます。

ウェビナー データのインポート構成インターフェイスは、Webex 管理ページから入手できます。

ウェビナーのインポートが有効になると、承認されたユーザーはWebex Webinarsウィジェットを使用してWebexウェビナーデータをインポートできます。

Salesforce ユーザーに Webex ウェビナーの権限を割り当てる

ユーザーが Webex ウェビナーのインポート機能にアクセスする前に、それぞれに Webex インポート管理者 権限を割り当てる必要があります。

ユーザーに権限を割り当てるには:

1. [Salesforce と Webex アプリの統合] に移動します。
2. 記事の下部にある［管理］タブを選択し、［アクセスの提供］を開きます。

   

3. 手順に従って、Salesforce ユーザー アカウントに Webex インポート管理者 権限を追加します。

Webex ウェビナーの時間範囲表示を設定する

表示される Webex ウェビナーの時間範囲を設定するには:

1. [Salesforce アプリ] ボタンをクリックし、検索フィールドに Webex を入力して、[Webex 管理者] を選択します。

   

2. Webex ウェビナー パネルを見つけ、ホーム ページの Webex ウェビナー ウィジェットに過去および今後のウェビナーを表示する日数を入力します。

   

Webex ウェビナーのインポート フィールド マッピングの設定を続行します。

Webex ウェビナーのインポート フィールド マッピングの設定

Webex ウェビナー インポート設定を使用して、Salesforce オブジェクトと Webinar オブジェクト フィールド間のマッピングを定義します。 たとえば、Salesforce Contact オブジェクトの姓名を、ウェビナーの招待者、登録者、および出席者の並列フィールド名にマッピングできます。 名と姓。

Webex ウェビナーのインポート設定を構成するには:

1. [Webex 管理] ページで、[ウェビナー データのインポート] パネルまで下にスクロールします。

   

2. オブジェクトドロップダウンリストからSalesforceオブジェクトを選択します。

   

   オブジェクトでは、使用可能な設定済みのカスタムオブジェクトに加えて、次の標準的なSalesforceオブジェクトから選択できます。

   • 連絡先
   • リード

   インポートされたすべてのウェビナー参加者が（選択したプライマリキーに基づいて）同じウェビナーにすでにインポートされていない限り、新しいオブジェクトレコードとして作成する場合は、［すべてのウェビナーに新規レコードを挿入］トグルを選択します。 同じ Webex Webinar にインポートされない限り、プライマリ キーが一致しても、既存のレコードは更新されません。

   これらの標準オブジェクトについては、次のように Salesforce キャンペーンにリンクできます。

   • キャンペーンメンバー: インポートされたリードと連絡先は、Salesforce の標準機能であるターゲット Salesforce キャンペーンの [キャンペーンメンバー] セクションで使用できます。 (バージョン 1.16 以降で利用可能)
   • Webex ウェビナー キャンペーン メンバー: インポートされたリードと連絡先は、カスタム Webex 機能であるターゲットの Salesforce キャンペーンの Webex ウェビナー キャンペーンメンバー セクションで使用できます。
   • キャンペーンメンバーと Webex ウェビナー キャンペーンメンバーの両方: インポートされたリードと連絡先は、Salesforce キャンペーン内の両方のロケーションで使用できます。 (バージョン 1.16 以降で利用可能)

   リストから選択した他のカスタムオブジェクトは、ターゲットのSalesforce CampaignのWebex Webinar Campaign Membersセクションにインポートされます。

3. プライマリキー選択インターフェイスで、プライマリキーとして一意のフィールドを選択し、右矢印を使用して選択済みリストに移動します。

   

   プライマリキーの場合、各レコードに固有の使用可能なフィールドを選択します。 たとえば、ファーストネーム Mark と多くの連絡先があるかもしれませんが、各連絡先には固有のメール アドレスがあります。

4. [データ フィールド マッピング] インターフェイスで、選択した Salesforce オブジェクトからフィールドを選択し、ウェビナー オブジェクトに対応するフィールドにマッピングします。 必要に応じて、+新規フィールドボタンを使用して追加のフィールドを追加します。

   すべての Salesforce オブジェクト フィールドは、上記のように、対応するウェビナー フィールドにマッピングする必要があります。

   Webex ウェビナー登録フォームからの標準的な質問のみを Salesforce フィールドにマッピングできます。 カスタム Webex ウェビナーの質問はサポートされていません。

5. 右側のフィールドに隣接するゴミ箱アイコンを使用して、追加したフィールドを削除できます。
6. 完了したら保存をクリックし、プライマリキーを確認したら、確認ダイアログで保存をクリックします。

   

   マッピングは更新されたパネルに表示されます。

   

   ゴミ箱アイコンを使用してオブジェクトのマッピングを削除すると、追加の確認ダイアログが表示されたり、鉛筆アイコンを使用して既存のマッピングを変更したりできます。

   常にここに戻ってプライマリキーを変更することはできますが、すでにシステムにインポートされているレコードのプライマリキーは更新されません。 その結果、重複につながる可能性があるため、プライマリキーを慎重に修正します。

ウェビナー フィールド マッピングを設定したら、ウェビナー データ インポート機能にアクセスできるユーザーを選択します。

Salesforce ユーザーのウェビナー データのインポートを有効にする

ウェビナー フィールド マッピングが確立されると、ウェビナー データ インポート機能にアクセスできるユーザーを選択できます。 オプションには、正しい権限を持つすべてのユーザ アカウント、個々のユーザ アカウント、および特定の Salesforce プロファイルのメンバーであるユーザに対するグローバル アクセスが含まれます。

すべてのユーザーに対してウェビナー データのインポートを有効にする

Salesforce 組織の全員に対してウェビナー データのインポートを有効にするには、[すべてのプロファイル/ユーザーのウェビナー インポートを有効にする] を [有効] に切り替えます。

選択したユーザーまたはプロファイルのウェビナー データのインポートを有効にする

選択した個々のユーザ、または特定の Salesforce ユーザ プロファイルに一致する特定のユーザのセットに対して、ウェビナー データのインポートを有効にできます。

選択したユーザーまたはプロファイルのウェビナー データのインポートを有効にするには:

1. すべてのプロファイル/ユーザーのウェビナーのインポートを有効にするが無効になっていることを確認します。

   

2. [これらのプロファイル/ユーザーに対してのみウェビナーのインポートを有効にする] ドロップダウンから、[プロファイル] または [ユーザー] のいずれかを選択します。

   

   • プロファイルを追加するには、[プロファイル] を選択し、検索テキストボックスをクリックして、ドロップダウン リストから Salesforce のロールを選択します。 [追加] をクリックしてロールを追加します。

     

   • 個々のユーザを追加するには、[ユーザ（User）] を選択し、テキスト ボックスにユーザ名を入力します。 [追加] をクリックしてユーザーを追加します。

     

   ユーザーまたはプロファイルを削除するには、エントリの隣にあるゴミ箱アイコンをクリックします。