tweet 4.0.2

an Abbot package for Slack by Serious Business

A Twitter skill for Abbot

Abbot is a programmable bot that turns your team chat into a shared command center. We handle all the boilerplate of building and running these conmmands so that you can focus on making tools that help you ship faster.

We built Abbot because we saw the power of this style of work (called ChatOps), when we worked at GitHub. ChatOps made it possible for GitHub to work productively without meetings, while globally distributed. We think it's a pretty great way to work, so we made it easy to use in Slack, Discord, and Microsoft Teams.

You can read more about Abbot here, check out our blog, or take a look at some of the other cool packages available as a one-click install from Abbot's Package Directory.

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: https://ab.bot/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

Sign in to add this to Slack You need an account to install this package with Abbot. Signing in with Slack will create an account if you don't have one already.

Not using Slack? No worries! Abbot works in Slack and Discord.

It's free to get started!

Details

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

?	Display shortcuts
Cmd+K	Display shortcuts when a form input has focus.
t	Jump to skill
ctrl+t	Jump to skill when a form input has focus.
Esc	Dismiss modal. Also used to remove focus from a text input to enable keyboard shortcut.
g m	Go to the My Bot page
g s	Go to the skills list
g p	Go to the package directory
g a	Go to the About page
g d	Go to the Docs site
g l	Go to Activity Log

About Abbot

README

Authentication

Try it!

Usage

Authentication

Code

Version History

Details

Keyboard Shortcuts

Jump to Skill