4Set Up and Administer Oracle CX Sales Integration

Integrate with Oracle CX Sales

Integrate CX Sales with Oracle DataFox to enrich your accounts, find and prioritize target companies, and source more opportunities. There are steps for you to do in both applications.

  • Enrich and sync your account from Oracle DataFox. To do so, connect to Oracle CX Sales, map fields, and bulk-sync accounts.

  • Enable the integration in Oracle CX Sales and enable smart talking points.

By integrating with Oracle CX Sales, you can also view details of your enriched accounts from Oracle Sales Assistant.

Before You Start

Before you integrate CX Sales with Oracle DataFox, create a user account in CX Sales with the sales administrator job role. This task is optional, but Oracle recommends that you create this user before you begin. To create a user account in CX Sales, see Create Application Users.

Note: Ensure you use the CX Sales user account that's created directly within the application, and not use single sign-on. Accounts linked with single sign-on don't have access to the APIs.

Connect to Oracle CX Sales

  1. Sign in to Oracle DataFox.

  2. Click your user name, and then click Settings.

  3. Click Oracle CX Sales under Integrations.

  4. Enter the URL instance and credentials for the sales admin account you just created.

  5. Click Next.

  6. Click the Refresh icon next to the CX Sales Field column to get the most updated list of Oracle CX Sales fields.

  7. On the Field Mapping tab, map the corresponding fields. Mapping ensures you control the data that you want to enrich in your accounts.

    Field Mapping

    While you’re mapping your fields, note these important points:

    • If you don’t find a corresponding field mapping, create a custom field to map. See Adding Objects and Fields in Application Composer for information on how to create new fields.

      Note: If you’re mapping a custom field, the names must exactly match.
    • The Overwrite Existing Data field is selected by default. All the selected CX Sales fields are overwritten by Oracle DataFox fields during the syncing process.

    For a list of field mappings, see Field Mappings.

  8. Click Done.

  9. Contact Oracle Support to match all your CX Sales accounts with the corresponding companies in Oracle DataFox and complete the rest of the setup.

You’re now ready to do more with your Oracle DataFox account.

Field Mappings

Here’s the full list of standard Oracle DataFox fields available for enrichment. This table represents the default mapping of Oracle DataFox Field to Oracle CX Sales Field. Use the Field Type and Max Width columns to ensure your fields are defined appropriately.

You can choose another existing Account field or create a custom field.

Note: Fields unavailable in Oracle CX Sales fields are marked as Custom fields. For these fields, create a custom field in Oracle CX Sales and map it to the Oracle DataFox field.

See Add Objects and Fields in Application Composer for information on how to create new fields.

Oracle DataFox Field Oracle CX Sales Field Description Example Output Field Type Max Width
DataFox ID

DataFoxCompanyId

The Oracle DataFox company ID whose data is being enriched into this account. 51815684e8945ea3240e6a09 String 80
Legal Name

Custom field

The legal name of the company. Oracle DataFox doesn’t always have data for this attribute. Panera Bread Co String 300
URL URL Company's website. panerabread.com String 2000
Street1 AddressLine1 The first part of the street address. 3630 S Geyer Road String 240
Street2 AddressLine2 The second part of the street address. Suite 100 String 240
City City The city where the company operates from. St. Louis String 60
State State The state where the company operates from. MO String 60
Country Country The country where the company operates from. US String 2
Zipcode PostalCode The postal code of the company’s address. 63127 String 60
Phone Number RawPhoneNumber The company’s phone number. 13149841000 String 60
Description

Description

A short description of the company. Panera Bread Co. engages in the operation of retail bakery cafes under the trade names of Panera Bread, Saint Louis Bread Co. String 2000
Number of Employees EmployeesTotal An estimate of total employees in the company. 21000 Number NA
Revenue Estimate

CurrentFiscalYearPotentialRevenueAmount

Note: If this default mapping is used, then the currency type is also updated in PreferredFunctionalCurrency.
An estimate of the company’s annual revenue. 2837845000 Number NA
Stock Ticker StockSymbol The company’s stock symbol. PNRA String 20
Keywords

Keywords

A comma delimited list of the company’s top keywords. bakery, restaurant, b2c, food and beverage, hospitality, categories, cafes String 2000
Industry

Custom field

The industry category of the company. Hospitality String 300
Subindustry

Custom field

The subindustry category of the company. Food Services and Drinking Places String 300
NAICS Code

Custom field

The NAICS (North American Industry Classification System) code. 722511 String 300
NAICS Code Description

Custom field

Link to the company profile in the DataFox web application. Full-service Restaurants String 300
DataFox Company URL

Custom field

Link to the company profile in the DataFox web application. http://app.datafox.com/panera-bread String 300
Linkedin URL

Custom field

The company’s LinkedIn ID number. http://www.linkedin.com/company/90 String 300
Crunchbase URL

Custom field

The company’s Crunchbase slug. https://www.crunchbase.com/organization/panera-bread String 300
Twitter Handle

Custom field

The company’s Twitter handle. panerabread String 300
Account Score AccountScore The numeric value indicating score for an account, enabling you to prioritize your accounts. 250 Number NA
Account Scoring Tier

AccountScoringTier

A tier is an admin-defined grouping of scores. The admin can set threshold for Tier 1, 2, etc. so that all of sales and marketing have a shared understanding of account priority. Tier 1 String 30
EIN TaxpayerIdentificationNumber The unique identifier for IRS (US only). 42723701 String 20
CIK

Custom field

The unique identifier for SEC (US only). 0000724606 String 100
UK Registration

Custom field

The unique identifier for Companies House (United Kingdom's registrar of companies). 12345678 String 100
Year Founded YearEstablished The year in which the company was established. 1981 Integer NA
Last Synced Date LastEnrichmentDate The most recent date when this account was last enriched or synced. 2019-08-20T18:04:02.461Z Date NA

DataFox Slug

Custom field

The name of the company as used in the DataFox URL.

https://app.datafox.com/companies/[slug]/overview

pandora

String

60

Global Ultimate Parent DataFox ID

Custom field

The ID of the highest level of the parent company (worldwide).

5130efce8989846a36001c9e

String

80

Global Ultimate Parent DataFox Slug

Custom field

Name of the highest level of the parent company (worldwide) as used in the DataFox URL.

sirius

String

60

Global Ultimate Parent Name

Custom field

Name of the highest level of the parent company (worldwide).

Sirius XM Radio, Inc.

String

300

Global Ultimate Parent Revenue Estimate

Custom field

The revenue estimate for the highest level of the parent company (worldwide).

15590000000

Number

NA

Global Ultimate Parent Number of Employees

Custom field

Employee estimate for the highest level of the parent company (worldwide).

27000

Number

NA

Domestic Parent DataFox ID

Custom field

The ID of the highest level of parent Company (in this Company's jurisdiction or country).

5130efce8989846a36001c9e

String

80

Domestic Parent DataFox Slug

Custom field

Name of the highest level of the parent company (in this Company's jurisdiction or country) as used in the DataFox URL.

sirius

String

60

Domestic Parent Name

Custom field

Name of the highest level of the parent company (in this Company's jurisdiction or country).

Sirius XM Radio, Inc.

String

300

Domestic Parent Revenue Estimate

Custom field

The revenue estimate for the highest level of the parent company (in this Company's jurisdiction or country).

15590000000

Number

NA

Domestic Parent Number of Employees

Custom field

Employee estimate for the highest level of parent Company (in this Company's jurisdiction or country).

27000

Number

NA

Bulk Sync Accounts

You can update thousands of accounts each day in Oracle CX Sales with the latest company data from Oracle DataFox. By default, up to 10,000 accounts are updated each day, but you can adjust the account limit and frequency. You can set up the sync account limit and frequency using bulk syncs.

You can view the total number of accounts synced, when and who initiated the sync, and status of the sync using the Bulk Sync History section.

To set the bulk-sync frequency and view the sync history for your accounts, navigate to Settings > Integrations > Oracle CX Sales > Bulk Syncs.

Bulk Syncs tab Settings Page for Oracle CX Sales

It’s recommended you set the frequency based on the number of accounts in your Oracle CX Sales to ensure all the accounts are synced on a regular basis.

For example, let’s say you have 60,000 Oracle CX Sales accounts and you set the bulk sync frequency to sync 10,000 accounts each day. This means that all your accounts are synced at least once a week.

You could also set the frequency to 5000 accounts per day to sync data only once in two weeks.

Enable Oracle DataFox Features in CX Sales

You must enable the Oracle DataFox integration in CX Sales for your accounts to be enriched.

  1. Sign in to Oracle CX Sales.

  2. Go to the Setup and Maintenance work area.

  3. On the Setup page, select Sales as the offering.

  4. From the Functional Area list, select Integrations. You can enable a functional area if it's not listed. For details, see Configure Offerings.

  5. Click the task Manage DataFox Data Enrichment Integration.

  6. On the Manage DataFox Data Enrichment Integration page, enter your Oracle DataFox credentials.

  7. Click Save and Close.

You have enabled Oracle DataFox data integration. Here’s what you can do next.

  • Enable your salespeople to enrich specific accounts from the Edit Account page.

  • View smart talking points from Oracle Sales Assistant.

Enable Account Enrichment from Oracle CX Sales

Your salespeople can enrich specific accounts from their CX Sales application instead of waiting for the nightly Oracle DataFox sync jobs.

To enable the option to enrich data from CX Sales, navigate to the Manage DataFox Data Enrichment Integration task and select Enable Data Enrichment from DataFox.

Your salespeople can now go to the Edit Account page, click the Actions list, and then select Enrich Account, as shown in the screenshot.

Enrich Account in Oracle CX Sales

View Smart Talking Points in Oracle Sales Assistant

Your salespeople can get signals and account scores in Oracle Sales Assistant. To know how to opt out of specific signals, see the Set Up Signal Alerts section in the Configure Sales Assistant topic.

Enable Smart Talking Points in Oracle CX Sales

Your salespeople can use the Smart Talking Points feature in Oracle CX Sales to prioritize target accounts and get the latest information on prospects. Salespeople can view the account score and news signals in the Account Intelligence tab on the Accounts page. You can also enable the tab on the Opportunities page so that salespeople can access this information.

You must create a mashup for smart talking points using Application Composer to enable the feature in Oracle CX Sales. Before you start, it’s important to understand what a mashup is. It’s a way to integrate another web application so that your users can view and use that application without leaving Oracle CX Sales. For more information, see Overview of Mashups.

Here’s what you must do before you create a mashup in Oracle CX Sales:

  • Ensure that you have access to Application Composer. Usually, the Sales Administrator job role provides access to Application Composer, but the permissions may be set up differently for your company.

  • Create a sandbox and set it as active. For more information, see Create and Activate Unified Sandboxes.

    • After you activate the sandbox, ensure you activate Application Composer. To do so, go to the Create Sandbox page, and select Application Composer in the All Tools section.

Follow these steps to set up Oracle CX Sales with Account Intelligence mashup content:

  1. Use the URL parameter to register Account Intelligence as an external web application. For details, see Register Your Web Application.

  2. Embed the registered Account Intelligence tab into the Summary tab. For details, see Embed the Web Application as a New Subtab.

Register Your Web Application

  1. In Application Composer's Common Setup menu, or on the Overview page, click Mashup Content.

  2. On the Web Applications page, click Register Web Application.

  3. Enter the name of the web application you want to integrate. For example, Account Intelligence.

    Note: Oracle recommends that you name the web application as Account Intelligence. However, you may choose a different name.
  4. Select the type of application as Parameter-based.

  5. Enter the web application URL that's sent to you when you begin using Oracle DataFox, in the URL Definition field. If you don't have it, contact Oracle Support.

  6. Optionally, you can also perform these actions:
    • Hide the Account Score section if your company isn’t using account scoring. To do so, in the URL Definition field, append the ?accountScore=0 value after you specify the URL. You can use any value other than 1 to hide the Account Score section, however the preferable value is 0. Your salespeople continue to see the Account Score section, if you append ?accountScore=1 after you specify the URL or don’t specify this parameter at all.

    • Filter the types of signals you want your salespeople to see by using the signalsFilter parameter. To do so, in the URL Definition field, append ?signalsFilter=<signal tags> after you specify the URL.

    • Hide the Account Score section and also filter the signal types. To do so, in the URL Definition field, append ?signalsFilter=<signal tags>&accountScore=0 after you specify the URL.

      For example, to hide the Account Score section and remove the news on signals where companies exhibit, present, or attend an event, append ?signalsFilter=conference-exhibitor,conference-presenter,conference-attendee&accountScore=0 after the URL definition.

      For more information on signal types and tags, see Overview of Company Signals.

  7. In the URL Parameters section, click Add and specify companyId as the parameter for the web application.

    Note: Your application displays the URL parameters that you add here at the time of embedding the web application into an actual page, where you can specify the page values for the URL parameter. The parameter name is case-sensitive.

    This image illustrates the Register Web Application screen with the companyId parameter.

    Register Web Application
  8. Click Save and Close. The mashup content is created.

You have successfully registered the web application as a mashup content.

Embed the Web Application as a New Subtab

Here's a simple example of how you can embed your web application as a new subtab. For more information on extending applications, see Add Objects and Fields in Application Composer.

  1. In Application Composer, navigate to Standard Objects > Account > Pages.

  2. In the Details Page Layout section, click the Duplicate Details Page Layout icon.

  3. Enter a name for the new layout and select Standard Layout from the Source Layout list.

  4. Click Save and Close. The layout for the new subtab is created.

  5. In the Details Page Layout section, click the layout you just created.

  6. Scroll to the bottom of the layout and click Add to add a subtab.

  7. On the Create Subtab page, select Mashup Content, and click Next.

  8. Select the Account Intelligence mashup content you created earlier and click Insert.

  9. Enter a display label. Oracle recommends you set this as Account Intelligence.

  10. From the URL Parameters list, map the parameter companyId to the value DataFox ID. If you have set a different value for the DataFox company ID, select that value from the list.

    This screenshot displays the mapping screen where you can map companyId to the value from the Value list.

    Edit Subtab Screen
  11. Optionally, add an icon for the subtab.

  12. Click Save and Close.

  13. Optionally, from the Additional Layouts page, select any other layout that you want to embed the mashup into. To do so, move the layout from the Available Layouts list to the Selected Layouts list.

  14. Click Save and Close.

After you review and publish the Sandbox configuration, you can view the smart talking points in Oracle CX Sales. This screenshot shows the account score and news signals in the Account Intelligence tab on the Edit Account page.

Smart Talking Points on the Edit Accounts page