Skill - Twitter

Owned by Chitra Borker (Deactivated)
Last updated: May 08, 2024 by Brook Warner
3 min read

Skill Type

INTENT 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.

This Skill is:

  • Built and owned by Soul Machines Ltd.

  • Only supported in English

  • Powered by the Twitter API

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

Video-Twitter Skill Demo

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:

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.

 

Twitter Configuration

Field

Type

Description

Twitter API KEY
required

TEXT

 

Enter your Twitter Bearer Token

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

    1. Navigate to the developer portal

    2. Expand the ‘Projects and Apps’ dropdown

    3. Open the App associated with the Bearer Token you would like to find or regenerate

    4. Generate a Bearer Token. Save it in a safe spot as you won’t be able to view them once you close the modal.