Preliminary Oracle Eloqua setup for your integration

Important: The Salesforce native integration was deprecated February 1, 2021. We recommend using the the Salesforce Integration app in its place. Learn more in our product notice.

Before you begin the Salesforce integration, complete these preliminary tasks in Oracle Eloqua:

Note: Before you complete the preliminary integration setup in Oracle Eloqua, complete the tasks in Preliminary Salesforce setup for your integration. You must be a member of the Customer Administrator security group in Oracle Eloqua to access the integration functionality and perform the configuration tasks.

Confirming access to Oracle Eloqua integrations

You must confirm that you have access to Oracle Eloqua's integration functionality. If you discover integration is not enabled in your Oracle Eloqua instance, please log in to My Oracle Support and create a service request.

To confirm access to the integration area in Oracle Eloqua

  1. Click Settings An image of the Settings menu icon, which is represented by a black cog..
  2. Click Integration under Platform Extensions.

    If the feature is not available, the screen indicates that you have to contact support.

    An image of the Enable Integration message on the Integration Status tab.

Run the integration wizard for the first time

The CRM Integration Setup Wizard helps start the integration process. The wizard will verify the connection to Salesforce and setup the default configuration. Later, you disable some of these default configurations so that you can customize the integration with Salesforce.

Note: The CRM Integration Setup Wizard only needs to be run one time.

Before you begin:

To run the integration wizard:

  1. Click Settings An image of the Settings menu icon, which is represented by a black cog..
  2. Click Integration under Platform Extensions. If you have not run the CRM Integration Setup Wizard yet, the CRM Integration Setup window is displayed.
  3. Click the Configuration tab.
  4. Enter the user name and password for the Salesforce user created for the integration. This is the user that Oracle Eloqua will use to connect with Salesforce.
  5. To use a testing environment for the integration instead of your production instance, select the Use Sandbox check box. After you complete the integration, reset the user to your production environment and resend the data.

    Note: If you are using the Enterprise trim of Oracle Eloqua, you can request a sandbox. If you have the Basic or Standard trims, this is an add-on function. For more information on how to request access to the Replication Sandbox, please contact your account representative.

  6. Enter the email address for the administrator who should be informed of critical errors in the Notification Email field. You can enter multiple email addresses by separating them with a semi-colon (;).

    An image of the CRM Integration Setup window.

  7. Click Start CRM Integration.

    The wizard sets up a standard CRM integration with Salesforce. Oracle Eloqua displays the progress of the setup. The following table provides details about each setup step.

    Setup stepDetails
    Validate CRM login Checks that the CRM user name and password are accurate and that Oracle Eloqua can communicate with the Salesforce system.
    Setup Eloqua business logicSets up the integration logic in Oracle Eloqua, which dictates the following:
    • When a lead in Salesforce doesn’t exist, Oracle Eloqua creates a new lead in Salesforce.
    • When a lead in Salesforce exists, Oracle Eloqua updates the lead in Salesforce.
    • When a contact in Salesforce exists, Oracle Eloqua updates the contact in Salesforce. It is recommended that you do not create contacts or accounts from Oracle Eloqua.

    Note: This logic will be updated and customized using automated programs in Program Builder.

    Examine CRM system configuration and field namesPulls all of the data objects and associated fields from Salesforce for integration purposes.

    Note: The wizard attempts to create the necessary external calls to set up your integration and presents errors for fields that are not accessible. Ensure that the specified fields are accessible to the Salesforce user as readable and writable fields. You cannot re-run the wizard, but you can manually update the external calls to select and map the fields. If these fields are not part of your set of integrated fields, then you can ignore this error.

    Setup Eloqua data push and pull settingsSets up external calls in Oracle Eloqua to update Salesforce and synchronize data back from Salesforce to Oracle Eloqua.
    Setup Automatic Data Syncs from CRM system

    Sets up the auto synchs to pull data from Salesforce.

    Create web links

    Creates the Oracle Eloqua web links Contact Activity Overview and Lead Activity Overview, which can be added to page layouts in Salesforce. This step also detects the current custom links on the lead and contact entities within Salesforce.

    Enable CRM integrationCompletes the CRM integration process and enables internal events and external calls.

After you finish: Disable the internal and external queues and auto synchs.

Disabling the internal and external queues

The CRM Integration Setup Wizard set up the processes to support the transfer of data between Oracle Eloqua and Salesforce. You must disable these processes so that you can customize the integration. Disabling these processes stops importing and exporting data during the configuraiton.

To disable the internal and external queues:

  1. Click Settings An image of the Settings menu icon, which is represented by a black cog..
  2. Click Integration under Platform Extensions.
  3. Click the Status tab. Click Reporting, then click Integration Reporting. The statuses of the internal and external event queues are displayed.

    An image of the CRM Integration Reporting window.

    If Pause is displayed for either of the queues, the data transfer is active.
  4. Click Pause.

Disabling auto synchs

The CRM Integration Setup Wizard set up the processes to import data from Salesforce. You must disable the auto synchs to stop the imports during the configuration. For more information about auto-synchs, see Native CRM integration: auto-synchs.

To disable auto synchs:

  1. Click Settings An image of the Settings menu icon, which is represented by a black cog..
  2. Click Integration under Platform Extensions.
  3. Click the Inbound tab. Click Management and then click Auto Synchs.

    An image of the Auto-Synchs window.

  4. For each auto synch in the list, select Disable Auto Synch from the drop-down list.

After you finish: Continue to Configuring data imports from Salesforce

Learn more

Configuring data imports from Salesforce

Managing native CRM integration auto synchs

Integrating Oracle Eloqua with Salesforce