[Originally posted by David Seaton on the Eloqua Artisan blog]


Essentially, Cloud Connectors allow anyone in the Eloqua community to build their own steps within Program Builder. If you're an interested developer, the instructions for building Cloud Connectors are here, but for now, we'll focus on installing one that's already built. Here's a step by step guide to getting your first Cloud Connector installed and ready to go.


1. Enable Eloqua Account

First you need to have your Eloqua account set up correctly. Please ensure that your company is enabled for API usage and that the user account you plan on using is enabled as an API user. To confirm your company has the API enabled please contact an Eloqua Product Specialist at 1 866 327 8764. If you are a customer administrator for Eloqua you can go to the user management tab and ensure that the user has the API User role enabled as well as one of Advanced User - Marketing or Basic User - Marketing User Role. Please feel free to contact an Eloqua Product Specialist if you require assistance setting up an account.


2. Enable Cloud Connector Account

The repository of Eloqua Cloud Connectors is located at https://cloudconnectors.eloqua.com. Think of it as the translator between Eloqua and the other piece (WebEx, Jigsaw, Adobe Connect, etc.) you're connecting to. Go to https://cloudconnectors.eloqua.com and create an account then proceed to step 3. [This site was formerly known as Black Starfish]



3. Find a Connector

With an API-enabled, account, you're now ready to set up a connector. If you have built one already, or have a third party you're working with, great. For this example, we'll use one of the connector prototypes that Eloqua has built, but the same sequence of steps is used for whatever connector you're looking to install.


Each connector is identified by a unique code, and a URL. These should either be displayed in the connector's setup screen, or provided to you by your Cloud Connector provider. You will need to copy the Unique Code and Configuration URL into Eloqua.



4. Install Connector In Eloqua

To install this Cloud Connector in Eloqua go to System Management and you will see the Cloud Connector Manager on the left side. (Setup -> Management -> System Management -> Cloud Connector Manager). Note: this requires that your account have Customer Administrator access level.


Name your Cloud Connector in the service name field, copy the Configuration URL from cloudconnectors.eloqua.com into the service URL field and copy the Unique Code from the provider into the Unique ID field. Click add - you have now created a Cloud Connector!




5. Implement Connector

With this Cloud Connector installed, it will now be an available option within a step in Program Builder. You can use it once, twice, or as many times as you like, as you would a normal Program Builder step. To implement the connector go to the Program Builder module in Eloqua. In a program you need only create a new step and set the default action to Cloud Connector. Then use the drop down menu to select the Cloud Connector you have created.



6. Configure Connector

While editing the default action of your cloud connector step you will need to configure the external program that the Cloud Connector connects to. Simply click on the configure button, login and a window will open that connects you to the login for the Cloud Connector's configuration screen.



You have now installed and configured your first Cloud Connector!