Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Twitter Skill will search the tweets of all Twitter users specified by the configuration for the phrase used by the end-user. End-users can request more tweets, go back, or ask to view one of them again. Tweets with images are displayed when the user views them. If there are links in the tweet, they are clickable but removed when reading.

Excerpt
hiddentrue

The Twitter skill searches and displays tweets containing the phrase requested by the user.

This Skill is:

  • Built and owned by Soul Machines Ltd.

  • Only supported in English.

  • Powered by the Twitter API

Note

Important: Twitter Skill and Facebook Skill cannot be part of the same project at this time because they both respond to the same user requests.

Sample conversation:

  • “User: Show me tweets about [Topic]”

  • “Skill: I found several tweets on that topic. Please indicate which you want to view.

  • “User: Tell me about the third one”

  • “Skill: Ok, here you go. (Shows Tweet as a card)”

Demo Video

twitter-skill-demo.mp4

Prerequisites

For you to take advantage of the Twitter skill, your user interface must support cards or be able to capture and interpret @commands and make use of the variables included in the response JSON. This is built into the default theme but would require custom frontend development if you are using custom UI. If card support is not supported, you should set the Max Number Of Tweets To Return setting to 1 so the Digital Person will just read the first tweet rather than asking for which you want to view.

Configuration

Provide the following information in the Twitter Skill configuration screen:

Field

Type

Description

Twitter API KEY
(required)

TEXT

Enter your Twitter API key

Example: 'AAAAAAAAAAAAAAAAAAAAIs1WAEAAAAA8Y%2FWRkuVupWSSJtHzKL%2FK1HUycg%3D7zuBB6eJWvglysdrprxxxxxxxxxxx'

Comma Separated List Of Twitter Handles to Follow

(required)

TEXT

This is a comma-separated list of Twitter handles that you want to search for tweets from.

Example: 'WHO, CDC'

Comma Separated List Of Hashtags to follow

TEXT

This is a comma-separated list of hashtags that will be used to search Tweets.

Example: #vegan

Spoken Phrase When Listing The Tweets Found

TEXT

Output phrases that can be customized to change the tone or wording of the verbal response. The default is 'I found several tweets on that topic.  Please indicate which you want to view.'

Spoken Phrase When No Tweets Found

TEXT

Output phrases when no tweets were found. The default is 'Sorry, I've had a problem looking up answers for {0}'

Spoken Phrase Before Reading the Content

TEXT

Output phrase when the user tells the Digital Person to read a tweet. The default is 'Ok. Here you go.'

Spoken Phrase When Only One Tweet Found Before Reading It

TEXT

Output phrase when only one tweet is found (either there was only one or Max Number Of Tweets was set to one). 'From Twitter'

Spoken Phrase When It Can’t Handle the Request.

TEXT

Output phrases when a matching tweet is not found. The default is 'Sorry, I did not understand that'

Max Number of Tweets To Return

NUMBER

Specifies the number of tweets returned. It can be a number between 1 to 5. The default value is 3.

Obtaining your Twitter API Key

  1. Register for a developer account:

    1. You need to register a Twitter account that has administrative access to your organization’s Twitter page. It is advised to keep this account separate from your personal Twitter account.

    2. Register here: Sign Up

  2. Create a Twitter App within the developer portal

    1. Add your Twitter App to a Project

  3. Access your API Key and Secret

    1. Navigate to the developer portal

    2. Expand the ‘Projects and Apps’ dropdown

    3. Open the App associated with the API Key and Secret you would like to find or regenerate

    4. Navigate to the Keys and tokens tab

Contents

Table of Contents