This guide will go over the installation and configuation of the "Tweet Sender" app.
The Tweet Sender app allows you to send a tweet to a contact in Eloqua. IF the twitter handle associated to a contact is follow the authorized Twitter account, a Direct Message (DM) can be sent to the Twitter handle. You can personalize the tweet with up to 2 fields from the contact.
It is assumed that users of this guide are comfortable with Program Builder OR Campaign Canvas. This app is supported on ALL versions of Eloqua.
As well, you will need an account on cloudconnectors.eloqua.com to use this connector. Sign up at http://cloudconnectors.eloqua.com
How to Install the App
As of the writing of this guide, this app is not available on Appcloud.eloqua.com, and must be installed from cloudconnectors.eloqua.com (please see this article to understand the difference).
Visit this URL and click on the "Install Connector" button, and follow the steps (NOTE, your Eloqua user will need to be an adminstrator user in order to install):
Using the Connector
The connector is triggered off a contact. It can be triggered from either Program Builder OR Campaign Canvas.
The tweet sender is used the same as a regular action in Canvas. Double click or drag "Send to Cloud Connector" from the left hand navigation (under the Actions header). The step will appear. Double click the step, and select "Tweet Sender" from the list:
Click the icon to the right in order to start configuration.
The tweet sender executes as a regular action step in program builder.
Create a step in the program where you want the step to execute
Set the action of the step to: “Cloud Connector”
You will be provided with a list of Cloud Connectors that have been created. Select the correct one from the list:
Click the "Configure" button.
Configuring the Tweet Sender
If you are not already logged into Cloudconnectors.eloqua.com, you will be to do so:
On the next screen, you will be prompted to input the information for an Eloqua user. Please ensure the user has API access:
On the next screen, (configuration) you will need to do 2 things:
- Authorize a twitter account (this is the account that the Tweet will be sent from)
- Define the Twitter Message.
Click on the "Authorize Account" button. This will bring you to a Twitter login screen. Please login with the correct account, and click the "Authorize App" button.
Here is where you input what the message looks like. URL's will automatically be shortned (using the T.CO shortner), and message longer then 140 characters will be truncated. You have the following configuration options available:
Direct Message - To make this a Direct Message (DM) place a lowercase d at the start of the tweet.
Twitter Handle - to include someone's Twitter handle, include the following ||TwitterID||. If you want to @message them, place it as such @||TwitterID||
Personalization from Contact fields - You can include personalization from up to 2 contact fields. The fields are defined in the "Mappings Area". To include the personalization, please insert: ||Pers1|| and ||Pers2||
Under the mappings area, you will map 3 fields from the contact:
Twitter ID - this is the field the Twitter handle
Twitter Personalization Field 1 - This is the field that stores the personalization message ||Pers1||
Twitter Personalization Field 2 - This is the field that stores the personalization message ||Pers2||
NOTE - Although you do not need to use both personalizations, you do need to map a field into them
Enabling the Step:
Remember, in order for this app to be live, you need to enable both the program/canvas AND the app. To enable the app, click on the "Credentials" tab, and then click the "Enable Step" button: