Contents
- Introduction
- Integration Steps
- Prerequisites
- Installing a Managed Package
- Configuring Call Center Parameters
- Enabling Single Sign-On
- 1 Enabling Access to SFDC Data from Scenarios
- Importing Calling Lists and Exporting Campaign Results
- Customizing SFDC Activity Objects
- Configuring SFDC Data Screen-pop for Outbound Preview Campaigns
- Frequently Asked Questions
- Searching for a contact using the Salesforce.com Search block
- Locating or creating the screen-pop URLs for an SFDC Object
- Preventing the Salesforce.com screenpops from opening another tab
- Enabling the Service Console (or Service Cloud)
Enabling Access to SFDC Data from Scenarios
The server-side integration is implemented using SFDC web services via the SFDC REST API (http://wiki.developerforce.com/page/REST_API).
ServicePattern authenticates with Salesforce using the Web Server OAuth Authentication flow. The refresh token mechanism is used to obtain and refresh the access token.
Step 1. Create a new Connected App. Open Build (or App Setup), select Create | Apps | Connected Apps and Click New
The following details shall be provided to configure the Connect App:
Basic Information:
- 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):
- Check: API (Enable OAuth Settings) > Enable OAuth Settings
- Callback URL: https://<your-brightpattern-domain>:8443/admin/salesforcecallback.html
- Select Available OAuth Scopes:
- Access and manage your data (api)
- Full access (full)
- Perform requests on your behalf at any time (refresh_token, offline_access)
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 2. Update the earlier created ServicePattern Integration Account. From the ServicePattern Contact Center Administrator application, open Configuration > Call Center Configuration > Integration Accounts > Salesforce.com, and use the consumer key and consumer secret obtained from the App Created above. From App Setup, select Apps, click Connected Apps and select the App created earlier:
- Copy the Consumer key and Consumer secret
Available directly from the created SFDC Connected App, paste into the ServicePattern Integration Account:
- Authentication API URL: https://<your-sf-domain>.salesforce.com/services/oauth2/token (replace <your-sf-domain> with the domain details of your SFDC instance and update in the ServicePattern Integration Account).
Step 3. Update the Security Profile to include the new Connected App. From Administer (or Administration Setup), select Manage Users | Profiles and click System Administrator. Click Edit.
- Connected App Access: Check the Connected App created earlier
Click Save
Step 4. Update the ServicePattern Contact Center Administrator application, select Configuration > Call Center Configuration > Integration Accounts > Salesforce.com, and specify the following data:
- Fill the parameters and press the Request token button.
- If your SFDC environment is a sandbox, select the Sandbox environment checkbox
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 5. Use the following scenario blocks to access SFDC data and enable screen-pop:
- Salesforce.com Search to obtain SFDC data using either the Salesforce Object Query Language (SOQL) or Salesforce Object Search Language (SOSL)
- Saleforce.com Insert to insert new SFDC records (i.e., to create new instances of SFDC objects)
- Salesforce.com Update to update existing SFDC records
- Salesforce.com Delete to delete existing SFDC records
- Salesforce.com Screen-pop to display SFDC records on the Agent Desktop
- Attached Data to populate custom fields in SFDC activity history (see below)
ServicePattern provides a scenario template for a simple inbound workflow involving look-ups and screenpop of SFDC data.