Overview
Our Eloqua Integration allows you to connect directly to Eloqua's REST API, and create/update a contact in the Eloqua platform. We do this using the Create Contact API.
This method of integration is the most secure, but requires you to have user access into Eloqua to be able to read/write contacts.
More information on these types can be found here. This document outlines the process to set up both Types.
If you would like to post to an Eloqua form, we don't have a direct integration for this. You can however use HTTP Integration Example: Eloqua Forms.
Prerequisites
Depending on the Authentication Type you will be using, you will need two different sets of information.
Basic Authentication - You will need the following:
1. Username
2. Password
3. Site (Company Name on Eloqua login page)
4. REST API Fields - (for core data fields you need the names. For custom fields, you need the IDs)
5. API URL
OAuth2.0 - You will need the following:
1. Eloqua Connected App created for OAuth flow
2. Eloqua Connected App Client ID
3. Eloqua Connected App Client Secret
4. Username (one time use)
5. Password (one time use)
6. Site (Company Name on Eloqua login page) (one time use)
7. API URL
For both configurations, your Eloqua user account must have permissions to Manage Contacts.
Setup
1. Navigate to your chosen campaign, and go to Processr > Integration. Click Add Job, then select Integrate with Eloqua.
2. The configuration window will now open.
a) Configuring the Basic Authentication Type
As standard the Basic Authentication is pre-selected. To continue with the Basic Authentication method simple leave the field 'authentication_type' as 'basic' and fill out the rest of the fields using your prerequisites.
b) Configuring the OAuth Authentication Type
To complete the setup of the OAuth Authentication Type, there are a few more steps to complete.
Next to the field 'authentication_type' select the field and remove the word 'basic' and a dropdown will appear. From the dropdown select 'oauth'
Once selected, click out of the fields to allow the settings to update.
Note: you will notice that the field 'site' is removed and the button 'Get Eloqua Token' button appears
Enter the rest of your client details from your prerequisites. You will also notice that as you add the Eloqua details the 'Get Eloqua Token' button will become available. This button will generate the Eloqua OAuth Token.
After selecting 'Get Eloqua Token' you will be taken through to the Eloqua instance. Here you will need to login with the details provided to you by the client to confirm the connection.
Once you have logged in you will get a message asking you to confirm the connection. Select Accept.
Finally, you will be shown the Eloqua OAUTH Token screen which confirms that the connection is successful.
5. The next step is to enter the clients' field names. The core data field names are entered into the mapping section, as below.
Please note: The clients' field names should be entered on the left and the matching Convertr field names are entered on the right.
You can find the names of the core data fields on the Eloqua documentation, and select the ones you need.
6. If you also wish to map to custom fields, in the customValues section you will need to fill in each item as follows:
- id: the ID of the field you wish to map in Eloqua; this can be found within the Eloqua instance.
- field: this is the field name within Convertr to map to.
7. Once you have completed the mapping, the integration is complete and ready to test. It will look like the below:
