構成手順に従う前に、 まずアプリケーションに移動して、リリース ノートWebex App Salesforce Packageの最新バージョンをダウンロードする必要があります。

要件

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

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

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

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

Control Hub のユーザー アクセス

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

• Without Pro Pack—When you have the basic Control Hub, you can choose to allow or deny access to all integrations for all of your users.

• With Pro Pack—With Pro Pack, you have advanced functionality to manage access to integrations for users.

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

Calling

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

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

If you're working with Webex for Salesforce version 1.18 or earlier, before you can work with Webex Calling within Salesforce, you'll need to configure a Salesforce authorization. Follow the sections in this article to get up and running.

These procedures apply to customers using version 1.18 and earlier of the Webex Salesforce integration. See the updated instructions for versions 1.19 and later:Configure a Salesforce authorization (1.19 and later) in the Install and administer tab

1. Create a Connected App

To create a new Connected App:

1. In Setup, search for App Manager and then choose New Connected App.

   

2. Enter a Connected App Name, for example, MyExampleApp.
3. Enter a Contact Email address.
4. Check Enable OAuth Settings.
5. Specify a placeholder Callback URL (we’ll update this later), for example, https://localhost/placeholder.

   

6. Scroll down and choose the following OAuth Scopes:
   • Full access (full)
   • Perform requests at any time (refresh_token, offline_access)

   

   The Perform requests at any time scope allows Named Credentials to refresh your access token when a session expires.

7. Scroll to the bottom of the page and click Save and then click Continue.
8. In the next page, scroll to API (Enable OAuth Settings) and click Manage Consumer Details.

   

   You may need to reauthenticate with Salesforce.

9. Make a note of the Consumer Key and the Consumer Secret.

   

2. Create an Auth Provider

Next you'll need to create an authentication provider, which facilitates the authentication with your Salesforce organization.

To create an auth provider:

1. In Setup, search for Auth and select Auth. Providers.[新規] をクリックします。

   

2. Select Salesforce as the Provider Type.
3. Enter a name for the Auth provider, for example, ApexMDTAPI.
4. Paste in the Consumer Key and Consumer Secret you saved when configuring your Connected app.
5. Enter the following scopes in Default Scopes, full refresh_token offline_access.
6. Leave everything else blank and click Save.

   

7. Copy the Callback URL from the Salesforce Configuration section.

   

8. Edit your Connected App and replace the placeholder URL with the Callback URL you copied from the Salesforce Configuration above.

   

9. Save your Connected App.

   You may need to wait up to 10 minutes to allow the settings to take effect and propagate throughout Salesforce’s infrastructure.

3. Create a named credential

You'll then need to create a named credential.

To create a named credential:

1. In Setup, search for Named and select Named Credentials. Click New Legacy.

   

2. Enter the following value for Label, ApexMDTAPI.
3. For the URL, enter your organization’s instance URL, for example, https://na1.salesforce.com, or, if you are using My Domain, your fully qualified My Domain domain name, for example, https://mycompany.my.salesforce.com.
4. For Identity Type, choose Named Principal.
5. For Authentication Protocol choose OAuth 2.0.
6. For Authentication Provider, choose the auth provider you created earlier.
7. For Scope, enter, full refresh_token offline_access.
8. Enable Start Authentication Flow on Save.

   

9. In Callout Options, enable Allow Merge Fields in HTTP Body and then click Save.

   

10. You’ll be prompted to login to your organization. After you login, you’ll see an Allow Access dialog.許可をクリックします。
11. You’ll then be redirected the Named Credential Screen and the Authenticated Status will indicate Authenticated as your-email@domain.com.

4. Create your site in the Webex Admin Screen

Finally, continue to the next topic in the Calling tab, Create site for calling, below.

Please follow the naming conventions above during site configuration.

For Webex for Salesforce integrations version 1.19 and later, follow the instructions in this article to remove any existing Webex Connected App for authorizations, named credentials, and auth providers, and then create a new Webex Connected App for Salesforce authorization.

These procedures apply to customers using version 1.19 and later of the Webex Salesforce integration. For instructions for versions 1.18 and earlier, see Configure a Salesforce authorization (1.18 and later) in the Install and administer tab

Remove any existing Webex Connected apps, named credentials, and auth providers

If you have previously created a Webex Connected App authorizations, named credential, or auth provider, you’ll need to remove them before continuing. Otherwise, continue to Create a new Webex Connected App below.

Remove your existing Webex Connected app:

1. In the upper right corner of your Salesforce landing page, select the gear icon and choose Setup.
2. In the Quick Find text box enter App Manager and select it from the list.
3. Scroll to your Webex Connected App in the list, click the down arrow icon at the right of the entry and choose View.
4. Select Delete and then select Delete again when asked to confirm.

Remove any existing Webex Named Credentials:

1. In the Quick Find text box enter Named Credentials and select it from the list.
2. 2. Click the down arrow at the right of the Webex named credentials entry and choose Delete.
3. 3. Choose Delete again when asked to confirm.

Remove any existing Webex Auth Providers:

1. In the Quick Find text box enter Auth. Providers and select it from the list.
2. Select the Del link at the beginning of the Webex auth provider entry.
3. Select OK when asked to confirm.

Continue to the next section to create a new Webex Connected App for Salesforce authorization.

Create a new Webex Connected App for Salesforce authorization

To create a new Webex Connected App for Salesforce authorization:

1. In the upper right corner of your Salesforce landing page, select the gear icon and choose Setup.
2. Retrieve your domain URL: in Quick Find, search for and select Domains, and save the URL from My Domain.

1. In the Quick Find text box enter App Manager and select it from the list.
2. Enter a Connected App Name, for example, Webex Salesforce Authorization.
3. Enter an email address for Contact Email.
4. Check Enable OAuth Settings.
5. Enter two callback URLs using the URL you retrieved earlier, one per line, and adding /apex/ webexsfdcauth and /apex/ cisco_webex__webexsfdcauth as suffixes. 例:

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

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

6. Choose the following scopes from the Available OAuth Scopes list in Selected OAuth Scopes:
   • Full access (full)
   • Perform requests at any time (refresh_token, offline_access)
7. Uncheck Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows.
8. Save the Connected App and make a note of the generated Consumer Key and Consumer Secret for later use.

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

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

To enable or disable call history:

1. [Webex 管理] に移動します。
2. Scroll down to Webex Call History.
3. Switch the toggle to the desired setting, either enabled or disabled.

   When enabled, Call History is available to all users and profiles.

For CUCM and Broadworks users, the following functionality is unsupported:

• Receiving inbound calls in the Salesforce global dialer (Webex App will still receive inbound calls)
• Viewing call durations in the Salesforce call log window after successfully placing an outbound call
• Ending calls via the button in the Salesforce call log window after successfully placing an outbound call
• Automatically populating call durations in the Salesforce call log window after ending an outbound call

For all Salesforce integrations, note the following limitation:

• Salesforce enforces an event count limitation (25,000) which may cause integrations to fail under heavy usage. Salesforce packages are available to increase that limit. 詳細については、https://developer.salesforce.com/docs/atlas.en-us.platform_events.meta/platform_events/platform_event_limits.htm を参照してください。

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

Webex 管理ページから ウェビナー データのインポートの設定 インターフェイスが利用 できます。

ウェビナーのインポートが有効になると、権限のあるユーザーは Webex ウェ ビナー ウィジェットを使用して Webex ウェビナー のデータをインポート することができます。

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

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

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

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

   

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

Webex Webinar の時間範囲表示を設定する

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

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

   

2. Webex ウェビナー パネルを見つけ、ホームページの Webex ウェビナー ウィジェットで過去と今後予定されるウェビナーを表示したい日数を入力します。

   

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

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

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

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

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

   

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

   

   For the Object, you can choose from the following standard Salesforce objects in addition to any available configured Custom objects:

   • 連絡先
   • Leads

   Choose the Insert New Records for every Webinar toggle if you want all imported Webinar participants to be created as new object records, unless they have already been imported for the same Webinar (based on the selected primary key). Existing records will not be updated, even if the primary key matches, unless they are imported for the same Webex Webinar.

   For those standard objects, you can choose to link them to your Salesforce campaigns as:

   • Campaign Members: Imported Leads and Contacts are available in a target Salesforce Campaign's Campaign Members section, which is a standard Salesforce feature. (Available in version 1.16 and later)
   • Webex Webinar Campaign Members: Imported Leads and Contacts are available in a target Salesforce Campaign's Webex Webinar Campaign Members section, which is a custom Webex feature.
   • Both Campaign Members and Webex Webinar Campaign Members: Imported Leads and Contacts are available in both locations within a Salesforce Campaign. (Available in version 1.16 and later)

   Any other Custom object you choose from the list will be imported into the target Salesforce Campaign's Webex Webinar Campaign Members section.

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

   

   For the Primary key, choose an available field that will be unique to each record. 例えば、Mark という名前の連絡先が多い場合がありますが、各連絡先には一意のメールアドレスが付きます。

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

   All Salesforce object fields must be mapped to corresponding webinar fields as shown above.

   Only standard questions from Webex webinar registration forms can be mapped to Salesforce fields. Custom Webex webinar questions are not supported.

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

   

   マッピングはアップデートされたパネルに表示されます。

   

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

   いつでもここに戻ってプライマリキーを変更できますが 、すでにシステムにインポートされたレコードのプライマリキーは更新されません。結果として、重複する可能性が生じ、プライマリ キーを一般的に変更します。

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

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

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

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

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

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

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

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

1. [すべてのプロファイル とユーザーに対しウェビナー インポートを有効にする] が無効 になっている必要 があります。

   

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

   

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

     

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

     

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