From Bright Pattern Documentation
Jump to: navigation, search
• 5.2 • 5.3 • 5.8

Enabling SFDC Data Access from Scenarios

The server-side integration is implemented using Saleforce.com (SFDC) web services via the SFDC REST API (http://wiki.developerforce.com/page/REST_API).

Bright Pattern Contact Center authenticates with Salesforce using the Web Server OAuth Authentication flow. The refresh token mechanism is used to obtain and refresh the access token.


In Salesforce Lightning

Step 1: Create a new connected app

  1. In Salesforce Lightning, go to Platform Tools > Apps > App Manager.
  2. At the top of the Lightning Experience App Manager, under Connected Apps, click New.


Create new app


Step 2: Configure the connected app

To configure the connected app, enter the following details on the New Connected App page.

Basic information

Sfdc-integration-guide-image13.png


  • Connected App Name - Set any unused name as a Web App Name
  • API Name - Set any unused name as an API Name
  • Contact Email - Supply contact email


API (Enable OAuth Settings)

  1. Check the Enable OAuth settings at API (Enable OAuth Settings) > Enable OAuth Settings

    1. Callback URL - https://<your-brightpattern-domain>/admin/salesforcecallback.html
    2. Select Available OAuth Scopes.

      Sfdc-integration-guide-step2.png


  2. Then access and manage your data (API).

  3. Full access (full)

  4. Perform requests on your behalf at any time (refresh_token, offline_access).

  5. Click Save.


Note: The SFDC updates for these parameters take a few minutes to propagate through the system--wait five minutes while SFDC updates these settings internally.


Step 3: Update the earlier created Bright Pattern Contact Center/Salesforce.com integration account

  1. Log in to the Bright Pattern Contact Center Administrator application, and go to Configuration > Call Center Configuration > Integration Accounts > Salesforce.com.

  2. In the integration account properties, add the consumer key and consumer secret obtained from the connected app created above.
    1. In Salesforce.com, go to App Setup > Apps > Connected Apps, and select the connected app created earlier.
    2. Copy the Consumer key and Consumer secret directly from the connected app.

      Sfdc-integration-guide-image15.png


  3. Go back to Contact Center Administrator, and paste the the consumer key and secret into the integration account properties.


Step 4: Update the security profile to include the new connected app

  1. In Salesforce.com, go to Administration > Users to get to the All Users page.

  2. A list of users will be shown. In the Profiles column, click System Administrator.

    Click the Administrator profile


  3. The Profile Detail page will open. Click Edit.

    Edit the System Adminstrator profile


  4. In Connected App Access, check the connected app created earlier.

    SFDC-Admin-Connected-App-50.PNG


  5. Click Save.


Step 5: Update the Bright Pattern Contact Center Administrator application

In Contact Center Administrator application, open the Salesforce integration account that you added previously. Go to Configuration > Call Center Configuration > Integration Accounts > Salesforce.com.


SFDC-Data-Scenarios-50.PNG


Under Data Access from Scenarios, specify the following data:

  • Sandbox environment - If your SFDC environment is a sandbox, select the Sandbox environment checkbox.
  • Consumer key - The consumer key
  • Consumer secret - The consumer secret
  • Refresh token - Click the Request token button to get a new token


The Salesforce integration account configuration should now be complete. You can use the Check limits button to see the SFDC limits associated with this account.


Step 6: Edit your Salesforce.com scenario

In the Scenario Builder application, edit your Salesforce.com scenario to include the following scenario blocks. These blocks allow your contact center to access SFDC data and enable screen pop:


Bright Pattern Contact Center Administrator provides a scenario template for a simple inbound workflow involving look-ups and screen pop of SFDC data.


In Salesforce Classic

Step 1: Create a new connected app

To create a new connected app:

  1. In Salesforce Classic, go to Build > Create > Apps.
  2. At the bottom of the Apps list, under Connected Apps, click New.


Create new app


Step 2: Configure the connected app

To configure the connected app, enter the following details on the New Connected App page.

Basic information

Sfdc-integration-guide-image13.png


  • Connected App Name - Set any unused name as a Web App Name
  • API Name - Set any unused name as an API Name
  • Contact Email - Supply contact email


API (Enable OAuth Settings)

  1. Check the Enable OAuth settings at API (Enable OAuth Settings) > Enable OAuth Settings

    1. Callback URL - https://<your-brightpattern-domain>/admin/salesforcecallback.html
    2. Select Available OAuth Scopes.

      Sfdc-integration-guide-step2.png


  2. Then access and manage your data (API).

  3. Full access (full)

  4. Perform requests on your behalf at any time (refresh_token, offline_access).

  5. Click Save.


Note: The SFDC updates for these parameters take a few minutes to propagate through the system--wait five minutes while SFDC updates these settings internally.


Step 3: Update the earlier created Bright Pattern Contact Center/Salesforce.com integration account

  1. Log in to the Bright Pattern Contact Center Administrator application, and go to Configuration > Call Center Configuration > Integration Accounts > Salesforce.com.

  2. In the integration account properties, add the consumer key and consumer secret obtained from the connected app created above.
    1. In Salesforce.com, go to App Setup > Apps > Connected Apps, and select the connected app created earlier.
    2. Copy the Consumer key and Consumer secret directly from the connected app.

      Sfdc-integration-guide-image15.png


  3. Go back to Contact Center Administrator, and paste the the consumer key and secret into the integration account properties.


Step 4: Update the security profile to include the new connected app

  1. In Salesforce.com, from Administer (or Administration > Setup), select Manage Users > Profiles.

  2. Click System Administrator.

  3. Click Edit.

  4. In Connected App Access, check the connected app created earlier.

    Sfdc-integration-guide-image17.png


  5. Click Save.


Step 5: Update the Bright Pattern Contact Center Administrator application

In Contact Center Administrator application, open the Salesforce integration account that you added previously. Go to Configuration > Call Center Configuration > Integration Accounts > Salesforce.com.


SFDC-Data-Scenarios-50.PNG


Under Data Access from Scenarios, specify the following data:

  • Sandbox environment - If your SFDC environment is a sandbox, select the Sandbox environment checkbox.
  • Consumer key - The consumer key
  • Consumer secret - The consumer secret
  • Refresh token - Click the Request token button to get a new token


The Salesforce integration account configuration should now be complete. You can use the Check limits button to see the SFDC limits associated with this account.


Step 6: Edit your Salesforce.com scenario

In the Scenario Builder application, edit your Salesforce.com scenario to include the following scenario blocks. These blocks allow your contact center to access SFDC data and enable screen pop:


Bright Pattern Contact Center Administrator provides a scenario template for a simple inbound workflow involving look-ups and screen pop of SFDC data.


< Previous | Next >
< Previous | Next >