Skill Type
| Status | ||||
|---|---|---|---|---|
|
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 | ||
|---|---|---|
| ||
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
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. |
Field | Type | Description | ||||||
|---|---|---|---|---|---|---|---|---|
Twitter API KEY
|
| Enter your Twitter Example: | ||||||
Comma Separated List Of Twitter Handles to Follow
|
| This is a comma-separated list of Twitter handles that you want to search for tweets from. Example: | ||||||
Comma Separated List Of Hashtags to follow |
| This is a comma-separated list of hashtags that will be used to search Tweets. Example: | ||||||
Spoken Phrase When Listing The Tweets Found |
| Output phrases that can be customized to change the tone or wording of the verbal response. The default is | ||||||
Spoken Phrase When No Tweets Found |
| Output phrases when no tweets were found. The default is | ||||||
Spoken Phrase Before Reading the Content |
| Output phrase when the user tells the Digital Person to read a tweet. The default is | ||||||
Spoken Phrase When Only One Tweet Found Before Reading It |
| Output phrase when only one tweet is found (either there was only one or Max Number Of Tweets was set to one). | ||||||
Spoken Phrase When It Can’t Handle the Request. |
| Output phrases when a matching tweet is not found. The default is | ||||||
Max Number of Tweets To Return |
| Specifies the number of tweets returned. It can be a number between 1 to 5. The default value is |
Obtaining your Twitter Bearer Token
Register for a developer account:
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.
Register here: Sign Up
Create a Twitter App within the developer portal
Add your Twitter App to a Project
Access your Bearer Token
Navigate to the developer portal
Expand the ‘Projects and Apps’ dropdown
Open the App associated with the Bearer Token you would like to find or regenerate
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 |
|---|