Configuring and using the

Twitter connector

Page 2 | Bizagi Connectors - A Digital Business Platform Copyright © 2020 Bizagi

Configuring and using the Twitter connectorOverviewThe Twitter connector for Bizagi is available for download at Bizagi Connectors Xchange.

Through this connector, you will be able to connect your Bizagi processes to a www.twitter.com account in order to use

the social networking Twitter services.

For more information about this connector's capabilities, visit Bizagi Connectors Xchange.

Before you startIn order to test and use this connector, you will need:

1. Bizagi Studio previously installed.

2. This connector previously installed, via the Connectors Xchange as described at

http://help.bizagi.com/bpmsuite/en/index.html?Connectors_Xchange.htm, or through a manual installation as

described at http://help.bizagi.com/bpmsuite/en/index.html?Connectors_install.htm.

3. An account at www.twitter.com and a twitter app (https://apps.twitter.com/).

Configuring the connectorIn order to configure the connector (i.e its authentication parameters), follow the steps presented at the Configuration

chapter in http://help.bizagi.com/bpmsuite/en/index.html?Connectors_install.htm.

For this configuration, consider the following authentication parameters:

· Authentication method: Custom.

Page 3 | Bizagi Connectors - A Digital Business Platform Copyright © 2020 Bizagi

· Consumer key: The API key of your specific Twitter app (as given at https://apps.twitter.com/app/[your_app_ID]/keys).

· Consumer secret: The API secret of your specific Twitter app (as given at https://apps.twitter.com/app/

[your_app_ID]/keys).

· Access token: Your Twitter account's access token (as given at https://apps.twitter.com/app/[your_app_ID]/keys).

· Access token secret: Your Twitter account's access token secret (as given at https://apps.twitter.com/app/

[your_app_ID]/keys).

Page 4 | Bizagi Connectors - A Digital Business Platform Copyright © 2020 Bizagi

Note that you will need to previously authorize your Twitter app at your Twitter account

(https://twitter.com/settings/applications).

Using the connectorThis connector features two available methods of Twitter's services: Posting a new tweet or search for tweets.

To learn overall how/where to configure the use of a connector, refer to http://help.bizagi.com/bpmsuite/en/index.html?

Connectors_Studio.htm.

When using the connector, make sure you consider the following details for each of the two available methods.

Posting a new tweetPost an status update in twitter (i.e, a new tweet).

Page 5 | Bizagi Connectors - A Digital Business Platform Copyright © 2020 Bizagi

To configure its inputs, consider:

· Message: The actual tweet content. Regular tweet rules apply, such as the maximum number of characters.

Page 6 | Bizagi Connectors - A Digital Business Platform Copyright © 2020 Bizagi

To configure its outputs when getting started and testing, you may map only the created_at part of the response.

Page 7 | Bizagi Connectors - A Digital Business Platform Copyright © 2020 Bizagi

Search for tweetsRetrieve tweets that match a given phrase or hashtag.

Page 8 | Bizagi Connectors - A Digital Business Platform Copyright © 2020 Bizagi

To configure its inputs, consider:

· Query: The phrase or hashtag to filter and search for tweets, as it can be inputted in twitter.com search box.

This means that usual wildcards and search characters apply as supported by Twitter (e.g, double quotes, minus or plus

sign, pound sign, etc).

· ResponseCount: The maximum amount of tweets to fetch.

Page 9 | Bizagi Connectors - A Digital Business Platform Copyright © 2020 Bizagi

To configure its outputs, consider:

· Statuses: Should match an existing collection of your process data model.

· created_at: Stores the date when the tweet was posted, and should be mapped to an attribute inside the collection.

· text: Stores the actual tweet content, and should be mapped to an attribute inside the collection.

· screen_name: Stores the name of the user who posted the tweet, and should be mapped to an attribute inside the

collection.

Page 10 | Bizagi Connectors - A Digital Business Platform Copyright © 2020 Bizagi