Twitter Integration
SAS_IntegrationNotRESTIntroduction
You can integrate third-party systems with Service Apps in many ways. The method you select will depend on business requirements, architectural and security constraints as well as the characteristics specific to each third-party application or service. You can use the REST, CSV, Online CSV data sources and the HTML Script widget.
This document describes a standard integration process that has already been implemented in a customer context.
To find out more about this integration, please do not hesitate to contact your EasyVista contact, or your service provider and integrator.
Integration Summary
Twitter is a microblogging tool managed by Twitter Inc. It enables users to send and read short messages, known as tweets, free of charge online, by instant messaging or by SMS. These messages are currently limited to 140 characters.
See the Twitter Glossary.
This easy-to-implement integration enables you to embed a Twitter timeline, also known as a collection of tweets directly in an 
app. You can do this by inserting the HTML code of the Twitter widget from Twitter Inc. in a HTML Script widget (integration process 1). You can also do this by inserting the Twitter Widget ID in an Twitter widget (integration process 2).
The Twitter Inc. widget is used to embed:
- Four different timelines, all of which look and feel like timelines on twitter.com: User Timeline (only user public tweets), Favorites, List Timeline, Search Timeline
- Single tweets, e.g. @EasyVista tweet
- Profiles, e.g. EasyVista profile
- Handles, e.g. @easyvista
- Hashtags, e.g. #ServiceApps
| Integration Data Feed (direction) | Authentication Type | Integration Connector Options | ||
|---|---|---|---|---|
|
|
N/A |
Html Script widget Twitter widget |
SaaS Version of Third-Party Product |
On-premise Version of Third-Party Product |
|---|---|
|
|
Step-by-step integration process
The two integration processes are quite similar. To help you decide which to use:
- Integration process 1, via the HTML Script widget:
- Is used to embed more and different Twitter objects.
- Is used to define the height/width of Twitter Inc. widgets for certain objects such as profiles, public lists, favorites, handles, using the Twitter Inc. widget configuration wizard. You can modify this subsequently in the Design pane of the graphic editor.
- Does not require you to know the Twitter Widget ID.
- Integration process 2, via the Twitter widget:
- Is used mainly to embed Search Timelines from Twitter Inc. widgets, e.g. #EasyVista or @EasyVista.
- Cannot be used to define the height/width of Twitter Inc. widgets.
- Requires you to know the Twitter Widget ID.
Process 1: How to embed a Twitter timeline via a HTML Script widget
See the Twitter Help Center: How to embed a timeline.
See the Twitter Glossary.
Twitter Inc. provides timeline widgets. You can use a Plug & Play configuration wizard to embed a tweet or a collection of tweets in your apps. Using this method, you can embed a Twitter timeline in in three easy steps:
- Step 1: Check the list of requirements
- Step 2: Select a Twitter timeline and retrieve the HTML code of the corresponding Twitter Inc. widget
- Step 3: Embed the HTML code of the Twitter Inc. widget in an app to display the timeline
Step 1: Check the list of requirements.
Before you can embed Twitter timelines, you must have a Twitter account with the relevant login and password.
Step 2: Select a Twitter timeline and retrieve the HTML code of the corresponding Twitter Inc. widget.
Follow steps 1 to 5 in the article called How to embed a timeline available on the Twitter Help Center.
Step 3: Embed the HTML code of the Twitter Inc. widget in an app to display the timeline.
1. Go to and open the app you want.
2. Display the Twitter timeline as described in step 2 using a HTML Script widget:
- Click
in the Objects pane. Open the Basic category and click and drag the HTML Script widget to the Design pane. - Rename the widget so you can easily identify it.
- Paste the HTML code obtained in step 2 in the HTML Code field.
- If required, add a header in Theme > Header.
- Adjust the height and width of the widget in the Design pane.
3. Click 
to switch to preview mode and check the visual layout of the Twitter timeline and that it is working correctly.
Process 2: How to embed a Twitter timeline via an 
Twitter widget
See the Twitter widget.
1. Retrieve the Twitter Widget ID from the Twitter timeline you want.
To obtain the Twitter Widget ID of a tweet quickly, you can click anywhere on it (except for the tags). The URL will appear in the URL bar of your Web browser. You can then copy the ID found at the end of the URL.
 @EasyVista account tweet URL |
Twitter Widget ID |
|---|---|
| https://twitter.com/EasyVista/status/775322164258017280 | 775322164258017280 |
2. Embed the Twitter widget ID ID in the Twitter widget.
Note: In the current Twitter 2016 interface, only the selection of a Search widget will enable you to use the wizard to create and save Twitter Inc. widgets in the list of widgets.
Use case
You want to embed a single tweet from a timeline in an app and allow users to follow the associated Twitter account using the Follow button. This is an illustration of integration process 1 via a HTML Script widget.
1. Open the Twitter Inc. widget configuration wizard. See the procedure in the article called How to embed a timeline available on the Twitter Help Center.
Next:
- Enter the URL of the tweet in the relevant field (1).
To obtain the URL of a tweet quickly, you can click anywhere on it (except for the tags). You can then copy the URL that will appear in the URL bar of your Web browser.
- You can select the type of display you want. Click one of the options (2) to obtain the code to be inserted in your app.
- If required, configure the widget by clicking the set customization options link (3).
- Click [ COPY CODE ].
2. Open your app and display the Twitter timeline via a HTML Script widget. See the procedure.
- For Profile, Public List, Favorites and Handles, the widget configuration wizard enables you to specify the height and width of Twitter Inc. widgets using the set customization options link. The HTML code generated contains the data-width and data-height tags with their selected values. You can modify them subsequently in the HTML Script widget inserted in your app.
- In the configuration wizard, the minimum height and width are respectively 200 and 220 pixels. If you want the Twitter Inc. widget to be resized automatically in your app based on the size of the user's device, you should set the height and width to 100%.
