Chapter 23. Connecting to Twitter

Procedure

1. In Fuse Online:

   1. In the left panel, click Settings.
   2. On the Settings page, near the top, to the right of the callback URL, click to copy the callback URL for your installation of Fuse Online to the clipboard. You will need this URL later in this procedure.
   3. To the right of the Twitter entry, click Register to display the Consumer API Key and ConsumerAPI Secret Key fields.

2. In another browser tab, go to your Twitter developer account, sign in if you need to, and do the following:

   1. In the upper right, next to the name of your developer project, click the down caret and click Apps.
   2. In the upper right, click Create an app.
   3. In the App name field, enter a name such as My Fuse Online Client.
   4. In the Application description field, enter a tip such as For leveraging tweets.
   5. In the Website URL field, paste the URL that you copied at the beginning of this procedure and remove api/v1/credentials/callback from the end of the URL.
   6. Select Enable Sign in with Twitter.
   7. In the Callback URLs field, paste the URL again. It should be something like this: https://app-proj912876.7b63.fuse-ignite.openshiftapps.com/api/v1/credentials/callback.
   8. A 100-character description of how you plan to use this app is required. For convenience, you can copy and paste: This is a demo application so that I can evaluate how to integrate Twitter with my enterprise applications.
   9. Click Create.
   10. Click Create again to confirm that you reviewed the developer terms.
   11. At the top of the page for the app you just created, click the Keys and tokens tab.
   12. Copy the consumer API key.
3. Return to your Fuse Online Settings page and paste the Twitter consumer API key into the Fuse Online Twitter Consumer API Key field.
4. Return to the Twitter Keys and tokens tab and copy the consumer API secret key.
5. Return to your Fuse Online Settings page and paste the Twitter consumer API secret key into the Fuse Online Twitter Consumer API Secret Key field.
6. Click Save and then click Ok.

Procedure

1. In Fuse Online, in the left panel, click Connections to display any available connections.
2. In the upper right, click Create Connection to display the available connectors. A connector is a template that you use to create one or more connections.
3. Click the Twitter connector.

4. Click Connect Twitter to display a Twitter authorization page. You might need to log in to Twitter before you see the authorization page.

   If Connect Twitter does not appear, then your Fuse Online environment is not registered as a Twitter client application. See Registering Fuse Online as a Twitter client application. When you try to create a Twitter connection and your Fuse Online environment is not registered as a Twitter client application, then Fuse Online displays multiple fields that prompt for authorization information. While you can create a Twitter connection by entering values in these fields, it is not recommended.

5. Click Authorize app to return to Fuse Online.
6. In the Connection Name field, enter your choice of a name that helps you distinguish this connection from any other connections. For example, enter Twitter Connect 1.
7. In the Description field, optionally enter any information that is helpful to know about this connection. For example, enter Sample Twitter connection that uses my Twitter login credentials.
8. In the upper right, click Create to see that the connection you created is now available. If you entered the example name, you would see that Twitter Connect 1 appears as a connection that you can choose to add to an integration.

Procedure

1. Click the Twitter connection that you want to add to the integration. When the integration uses the selected connection to connect to Twitter, Fuse Online uses the credentials defined in that connection.

2. Click the action that you want the selected connection to perform. A Twitter connection that you add to an integration performs only the action you choose.

   • Mention triggers execution of the integration when a tweet contains your handle.
   • Search triggers execution of the integration when a tweet contains text that you specify.
3. Optionally, enter the configuration information that Fuse Online prompts for. For example, the Search action prompts you to specify how often to search and keywords to search for.
4. Click Done to add the connection to the integration.