Abbot - "tweet v4.0.2" by Serious Business

by Serious Business

A Twitter skill for Abbot

Tweet, retweet, like, and follow all from chat with the tweet skill!

The tweet skill makes it easy to manage a brand or team twitter account from Chat. Use Abbot’s built-in access controls to limit who can tweet from the twitter account. This allows a team to manage a twitter account without members having access to the credentials for the Twitter account.

Authentication

The tweet skill acts as a Twitter client for a single Twitter account per chat room. To authenticate that account, start with:

@abbot tweet auth – This will initiate the process and return an authorization URL.
Visit the authorization URL in your browser and authorize Abbot to tweet on your behalf. After authorizing the account, the browser will show you a 7-digit PIN. You’ll use that PIN in the next step
@abbot tweet auth {pin} – Replace with the PIN from the previous step. This completes the authorization flow. Now you can tweet from the chat room.

Try it!

Once you have authentication set up, tweet away!

@abbot tweet I just set up the tweet skill in Abbot and can tweet from chat!

Abbot will respond with a link to the tweet.

@abbot tweet {the text of your tweet} — sends a tweet

@abbot tweet length {the text of your tweet} — returns the number of characters in your text

@abbot tweet RT {a link to a tweet to retweet} — retweets a tweet

@abbot tweet reply {tweet link} {text of reply} — replies to a tweet

@abbot tweet follow {username} — follows an account

@abbot tweet unfollow {username} — unfollows an account

@abbot tweet like {link to tweet} — likes a tweet (can also use FAV or FAVE)

## Authentication

@abbot tweet auth – to authenticate the Twitter user this skill will manage in the current room.

@abbot tweet auth {pin} – to complete the authentication process. The pin is supplied by Twitter after you authenticate to Twitter in the browser.

@abbot tweet auth user – to find out which Twitter account the current room is authorized to manage.

# Description: A Twitter Skill for Abbot. # # Package URL: /packages/aseriousbiz/tweet # USAGE: # `@abbot tweet {the text of your tweet}` — sends a tweet # `@abbot tweet length {the text of your tweet}` — returns the number of characters in your text # `@abbot tweet RT {a link to a tweet to retweet}` — retweets a tweet # `@abbot tweet reply {tweet link} {text of reply}` — replies to a tweet # `@abbot tweet follow {username}` — follows an account # `@abbot tweet unfollow {username}` — unfollows an account # `@abbot tweet like {link to tweet}` — likes a tweet (can also use FAV or FAVE) # # AUTHORIZATION # ————– # `@abbot tweet auth` – to authenticate the Twitter user this skill will manage in the current room. # `@abbot tweet auth {pin}` – to complete the authentication process. The pin is supplied by Twitter after you authenticate to Twitter in the browser. # `@abbot tweet auth user` – to find out which Twitter account the current room is authorized to manage. import re import requests from requests_oauthlib import OAuth1 from urllib.parse import quote_plus ABBOT_TWITTER_CLIENT_URL = ‘https://abbot.run/twitter-client-proxy/trigger/yvX1lQH_rgvNjdtwFbmt1Tg7’ secret_key = str(bot.room.cache_key) + “|SKILL_SECRET” def get_skill_secret(): return bot.brain.read(secret_key) SKILL_SECRET = get_skill_secret() def fetch_auth_url(): “””Make a request to the Abbot Twitter Client for an Auth URL””” data = { ‘endpoint’: ‘auth’ } r = requests.post(url=ABBOT_TWITTER_CLIENT_URL, json=data) r.raise_for_status() return r.json() def set_auth_pin(pin): “”” Make a request to the Abbot Twitter Client to supply the authorization PIN for pin based authorization https://developer.twitter.com/en/docs/authentication/oauth-1-0a/pin-based-oauth “”” data = { ‘endpoint’: ‘pin’, ‘pin’: pin, ‘skill_secret’: SKILL_SECRET } r = requests.post(url=ABBOT_TWITTER_CLIENT_URL, json=data) r.raise_for_status() return r.json() def get_user(): “”” Retrieves the current authenticated user. “”” data = { ‘endpoint’: “account/verify_credentials.json”, ‘method’: “GET”, ‘skill_secret’: SKILL_SECRET } r = requests.post(url=ABBOT_TWITTER_CLIENT_URL, json=data) r.raise_for_status() return r.json() def reply_with_current_user(): try: user = get_user() if user is None: bot.reply(“No Twitter user is authorized for this room or the authorization has been revoked. `@abbot tweet auth` to authorize a Twitter account”) return username = user.get(“screen_name”) bot.reply_with_image(user.get(“profile_image_url_https”), “The twitter user [@” + username + “](https://twitter.com/” + username + “) is attached to this room.”) except: bot.reply(“No Twitter user is authorized for this room or the authorization has been revoked. `@abbot tweet auth` to authorize a Twitter account”) def write_skill_secret(secret): bot.brain.write(secret_key, secret) def delete_skill_secret(): bot.brain.delete(secret_key) def get_tweet_id(link): “””Try to extract a tweet id from a link””” # A representative tweet link: https://twitter.com/haacked/status/842543742523334656 pattern = re.compile(r’twitter\.com\/(.*)\/status(?:es)?\/([^\/\?]+)’, re.IGNORECASE) match = pattern.findall(link) try: if match: item = match[0] screen_name = item[0] tweet_id = item[1] return screen_name, tweet_id else: return None, None except: return None, None def prep_reply_text(screen_name, text): “””Replies have to contain the original tweeter’s screen_name””” if screen_name in text: return text else: if “@” in screen_name: return screen_name + ” ” + text else: return “@{} {}”.format(screen_name, text) def send(action, **kwargs): “””Make a request to the Abbot Twitter Client””” if kwargs: querystring = “&”.join([“{}={}”.format(k, quote_plus(v)) for (k, v) in kwargs.items()]) endpoint = “{}?{}”.format(action, querystring) else: endpoint = action data = { ‘endpoint’: endpoint, ‘method’: ‘POST’, ‘skill_secret’: SKILL_SECRET } r = requests.post(url=ABBOT_TWITTER_CLIENT_URL, json=data) r.raise_for_status() return r.json() def tweet(cmd, param, words): if cmd == “RT”: screen_name, tweet_id = get_tweet_id(param) if tweet_id: results = send(“statuses/retweet/{}.json”.format(tweet_id)) bot.reply(“Retweeted @{}!”.format(screen_name)) else: bot.reply(“That doesn’t look like a link to a valid Tweet.”) elif cmd == “REPLY”: screen_name, tweet_id = get_tweet_id(param) if screen_name and tweet_id: # The original user’s screen_name must be included in the tweet text. reply_text = prep_reply_text(screen_name, ” “.join(words[2::])) # 0 is “RT”, 1 is the tweet link results = send(“statuses/update.json”, status=reply_text, in_reply_to_status_id=tweet_id) bot.reply(“Nice! I replied to {}’s tweet”.format(screen_name)) else: bot.reply(“That doesn’t look like a valid Tweet.”) elif cmd == “FOLLOW”: results = send(“friendships/create.json”, screen_name=param) bot.reply(“Aww yeah! Followed {}!”.format(results.get(“name”))) elif cmd == “UNFOLLOW”: results = send(“friendships/destroy.json”, screen_name=param) bot.reply(“Okay, I unfollowed {}.”.format(results.get(“name”))) elif cmd == “LENGTH”: charcount = len(bot.arguments) if charcount <= 280: bot.reply(“:white_check_mark: Your tweet is {} characters long.”.format(len(bot.arguments))) else: bot.reply(“:warning: Uh oh! This is over 280 characters and might be too long. Try and see, I guess…”) elif cmd in [“FAV”, “FAVE”, “LIKE”]: screen_name, tweet_id = get_tweet_id(param) if tweet_id: results = send(“favorites/create.json”, id=tweet_id) bot.reply(“Hot dog, I just liked {}’s tweet!”.format(screen_name)) else: bot.reply(“That doesn’t look like a link to a valid Tweet.”) else: # Replace @@haacked with @haacked. This gives us an escape hatch when a twitter username matches Slack. tweet_text = re.sub(r'(?:(?<=^)|(?<=\s))@@([a-zA-Z0-9_]{1,15})’, r’@\1′, bot.arguments) # if tweet_text contains a subscring of the form <@U.?> then reply that it is not valid if re.search(r'<@U.+?>’, tweet_text): bot.reply(“Whoops, it looks like you intended to include a Twitter username that just happens to match a Slack username. You can use `@@` in that case. For example, for Twitter user `@haacked` you can specify `@@haacked`”) else: results = send(“statuses/update.json”, status=tweet_text) user = results.get(“user”) screen_name = user.get(“screen_name”) tweet_id = results.get(“id”) bot.reply(“:boom: just tweeted it! :point_right: https://twitter.com/{}/status/{}”.format(screen_name, tweet_id)) # Main dispatch logic def main(): words = bot.arguments.split(” “) cmd = words[0].upper() param = None if cmd == “AUTH”: if len(words) == 1: # Initiate Auth. response = fetch_auth_url() skill_secret = response.get(“skill_secret”) auth_url = response.get(“auth_url”) write_skill_secret(skill_secret) bot.reply(“Please [click here](” + auth_url + “) to authenticate this skill with Twitter. After you authenticate, tell me the pin like so: `@abbot ” + bot.skill_name + ” auth {pin}` “) else: pin = words[1] if (pin == “clear”): delete_skill_secret() bot.reply(“Cleared authentication info for this room”) elif (pin == “user”): reply_with_current_user() else: # Confirm the PIN response = set_auth_pin(pin) success = response.get(“success”) if (success): reply_with_current_user() return bot.reply(response.get(“message”)) elif cmd == “USER”: reply_with_current_user() else: # Run the rest of the commands, but make sure SKILL_SECRET is set. if SKILL_SECRET is None: bot.reply(“To set up this skill, run `@abot ” + bot.skill_name + ” auth` to authenticate with the Twitter account you want to manage with this skill from this room”) return if len(words) > 1: param = words[1] tweet(cmd, param, words) else: bot.reply(“Try `@abbot help tweet` to learn how to use the `tweet` skill.”) main()

Version	Created	Author	Release Notes	Installs
4.0.2	10/14/2021	haacked	Fix the usage text.	0
4.0.1	10/14/2021	haacked	Updated the usage text to reflect the new approach	0
4.0.0	9/22/2021	haacked	This release changes the key we use to store the Twitter token. Previously, we used the `room.name`. However, that is not stable if the room name changes. This release uses the `room.cache_key` property. This property attempts to retrieve the room id. If it doesn’t exist (on some platforms we don’t get one, looking at you MS Teams), it uses the room name.	0
3.1.2	9/18/2021	haacked	Makes the skill more resilient to upcoming potential breaking changes in the Python skill runner.	1
3.1.1	9/18/2021	haacked	When trying to include a twitter username that just happens to match a Slack username, Slack replaces the mention with its own mention syntax. This release catches that situation and prevents the tweet from going out. It provides an escape mechanism to mention accounts. Just use a double `@`. For example, `Hello @@haacked` will be tweeted as `Hello @haacked`.	0
3.1.0	7/26/2021	haacked	Add support for retrieving the current Twitter user that’s authorized for a room.	0
3.0.1	7/26/2021	haacked	Format the auth link nicely	0
3.0.0	7/26/2021	haacked	The skill no longer needs Twitter developer keys. Instead, run `@abbot tweet auth` to run through the authentication process with the account you want to manage.	0
2.1.2	7/23/2021	haacked	Only pass the endpoint portion of the URL to the Abbot Twitter Client	0
1.1.2	7/23/2021	haacked	No longer requires developer keys. Only a Twitter consumer key and consumer secret.	0
1.1.1	4/20/2021	Paul	Added the ability to reply! Reply to tweets with: @abbot tweet reply `tweet link` `text of your reply`	0
1.0.1	4/20/2021	Paul	Update usage text to make the package listing look nicer.	0
1.0.0	4/20/2021	Paul	First release!	0

Log In or Create Account
You need an account to install this package with Abbot. Signing in with Slack or Discord will create an account if you don’t have one already.

Details

Last updated: Thursday, 14 October 2021 00:11
Installs: 1 total install
Language: Python
License: MIT License

Abbot – “tweet v4.0.2” by Serious Business

README

Authentication

Try it!

Usage

Code

Version History

Details