Versions Compared

Key

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

Skill Type

Status
colourGreen
titleINTENT MATCHER

Overview

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:

Note

Correction coming soon: In the Twitter Skill configuration screen, you should enter the Twitter Bearer Token in place of Twitter API Key. The UI label will be updated soon.

Image Modified

Field

Type

Description

Twitter API KEY
(required)

Status
colourRed
titlerequired

TEXT

Enter your Twitter API key Bearer Token

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

Comma Separated List Of Twitter Handles to Follow(required)

Status
colourRed
titlerequired

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

Bearer Token

  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. Bearer Token

    1. Navigate to the developer portal

    2. Expand the ‘Projects and Apps’ dropdown

    3. Open the App associated with the

API Key and Secret
    1. Bearer Token you would like to find or regenerate

Navigate to the Keys and tokens tab
    1. Generate a Bearer Token. Save it in a safe spot as you won’t be able to view them once you close the modal.

Contents

Table of Contents