{"id":453,"date":"2012-01-20T22:13:50","date_gmt":"2012-01-21T03:13:50","guid":{"rendered":"http:\/\/www.mageuzi.com\/blog\/?p=453"},"modified":"2012-01-21T13:34:22","modified_gmt":"2012-01-21T18:34:22","slug":"my-little-twitter-bot","status":"publish","type":"post","link":"http:\/\/www.mageuzi.com\/blog\/2012\/01\/20\/my-little-twitter-bot\/","title":{"rendered":"My Little Twitter Bot"},"content":{"rendered":"

It all started when @ndoto replied to one of my \u00e2\u20ac\u0153eeyup\u00e2\u20ac\u009d tweets<\/a> saying that he wished there was a Big Macintosh Twitter bot<\/a> that would reply with an \u00e2\u20ac\u0153eeyup\u00e2\u20ac\u009d if you sent a tweet containing \u00e2\u20ac\u0153eeyup\u00e2\u20ac\u009d.<\/p>\n

For those who aren\u00e2\u20ac\u2122t in the know, Big Macintosh is a character on the cartoon My Little Pony: Friendship is Magic<\/em>. It\u00e2\u20ac\u2122s a slight re-imagining of the original show, headed by the same creative mind behind Foster\u00e2\u20ac\u2122s Home for Imaginary Friends<\/em> \u00e2\u20ac\u201c an awesome show with clever writing. Needless to say, that same maturity (but kid-appeal) carries over to the new My Little Pony. I suppose I should clarify that I\u00e2\u20ac\u2122m not enough of a fan to call myself a brony, but I do think the show is about 20% cooler than most other things on television \u00e2\u20ac\u201c and Big Macintosh is by far my favorite character. :)<\/p>\n

I\u00e2\u20ac\u2122ve always wanted to make a Twitter bot, so I jumped at the opportunity. In this post, I\u00e2\u20ac\u2122d like to share some of the technical details, and decision making, that brought @BigMacinbot<\/a> to life.<\/p>\n

<\/p>\n

The first thing I had to decide was how I was going to interface with Twitter. From my experience with Trowl<\/a>, I figured I could throw together a simple C# program, running on my home computer, using the Twitter library I had already created. The downside, though, is that if my internet connection went down, or my computer powered off, the bot would go quiet. So instead, I decided to write a PHP script, and host it on my remote server space. I\u00e2\u20ac\u2122d also use cron to automatically run the script every five minutes. Finally, since I was already familiar with the Twitter API, I didn\u00e2\u20ac\u2122t feel the need to write the API calls from scratch. I used a PHP Twitter library, tmhOAuth<\/a>, that had everything I needed, and was simple to use.<\/p>\n

With that decided, I turned my attention to how the bot, itself, would work. It seemed very simple at first: search Twitter, then send a reply to every tweet containing \u00e2\u20ac\u0153eeyup\u00e2\u20ac\u009d. As I kept thinking about it, though, I realized just how annoying that would be. If someone used that phrase often enough, they\u00e2\u20ac\u2122d end up being spammed by the bot. The point of this was to have a bit of fun, not annoy people. <\/p>\n

To confirm my suspicions, I created a very simple script that just did the \u00e2\u20ac\u0153search Twitter\u00e2\u20ac\u009d part, and emailed the results. I let this run over the course of a couple days and, indeed, more people than I expected used \u00e2\u20ac\u0153eeyup\u00e2\u20ac\u009d — and used it frequently. With this in mind, I started to create a set of rules that a tweet would have to pass through before the bot would send a reply:<\/p>\n

Big Macintosh\u00e2\u20ac\u2122s Rules of Agreement
<\/font><\/strong><\/p>\n

    \n
  1. Tweet was sent within the last two hours. <\/li>\n
  2. Not a retweet <\/li>\n
  3. Tweet says \u00e2\u20ac\u0153eeyup\u00e2\u20ac\u009d somewhere. (Twitter name cannot contain \u00e2\u20ac\u0153eeyup\u00e2\u20ac\u009d.) <\/li>\n
  4. User isn\u00e2\u20ac\u2122t being ignored. If a user really doesn\u00e2\u20ac\u2122t like Big Macinbot, they can reply with \u00e2\u20ac\u0153nope\u00e2\u20ac\u009d, and they\u00e2\u20ac\u2122ll never receive another reply. <\/li>\n
  5. The user has never received a reply from Big Macinbot, or they haven\u00e2\u20ac\u2122t received a reply recently. The definition of \u00e2\u20ac\u0153recently\u00e2\u20ac\u009d is based on probability. If the last time the user received a reply was within two weeks, Big Macinbot looks to see how long ago it was. The closer to two weeks, the more likely a reply will be sent. After two weeks, a reply is definitely sent. Here is the code, for those interested: <\/li>\n<\/ol>\n
    \n
    \n
       1:<\/span> $diff = time() \u00e2\u20ac\u201c $previous_reply_timestamp;<\/pre>\n
    <\/p>\n
       2:<\/span> $prob = ($diff \/ 1209600) * 100; \/\/ Number of seconds in two weeks.<\/span><\/pre>\n
    <\/p>\n
       3:<\/span>  <\/pre>\n
    <\/p>\n
       4:<\/span> $rand = rand(1,100);<\/pre>\n
    <\/p>\n
       5:<\/span>  <\/pre>\n
    <\/p>\n
       6:<\/span> if<\/span> ($rand > 1 && $rand < $prob)<\/pre>\n
    <\/p>\n
       7:<\/span> {<\/pre>\n
    <\/p>\n
       8:<\/span>     return<\/span> true<\/span>;<\/pre>\n
    <\/p>\n
       9:<\/span> }<\/pre>\n
    <\/div>\n<\/div>\n
    Coding these rules wasn\u00e2\u20ac\u2122t too difficult \u00e2\u20ac\u201c the trickiest part was building a simple database to keep track of users, and when their last reply was sent. Relying on a database makes the script a bit more complex, but the ability to stagger Big Macinbot\u00e2\u20ac\u2122s replies makes it worthwhile.<\/p>\n
    After implementing this base functionality, I wondered what should happen if someone replied to Big Macinbot. Most other bots, as far as I knew, didn\u00e2\u20ac\u2122t do anything if you replied or mentioned them. But I didn\u00e2\u20ac\u2122t want to miss out on a chance to give this bot a little more personality \u00e2\u20ac\u201c it would still respond with \u00e2\u20ac\u0153eeyup\u00e2\u20ac\u009d, but the interaction could be fun. Since I was already checking mentions for ignore requests, I just added another case that sent a reply back if it was a normal mention. To build upon the goal of adding some more personality, I actually have Big Macinbot choose from three random responses: Eeyup. \/ Eeyup! \/ \u00e2\u20ac\u00a6 Eeeyup?<\/p>\n
    Another reason for the random responses is to try and get around Twitter\u00e2\u20ac\u2122s \u00e2\u20ac\u0153duplicate status\u00e2\u20ac\u009d error \u00e2\u20ac\u201c Twitter denies a status posting if it\u00e2\u20ac\u2122s the same as your previous status. Unfortunately, it seems as though Twitter doesn\u00e2\u20ac\u2122t just check your last status, like I thought, but all of your recent statuses. So right now, once someone exhausts the three random responses, Big Macinbot goes quiet due to Twitter errors.<\/p>\n
    At the beginning, though, I wasn\u00e2\u20ac\u2122t even sure if anyone would bother replying. Everything else was in place, and seemed to be working, so it was time to move forward. On Saturday, January 14, 2012, Big Macinbot came to life.<\/p>\n
    The Reaction<\/strong><\/p>\n
    I have to admit that about halfway through coding the bot \u00e2\u20ac\u201c about the time that I was perfecting the Rules of Agreement \u00e2\u20ac\u201c I wondered if I should keep going. I started to think that no one was going to like the bot; that everyone would block and it would be done within a week or two.<\/font><\/p>\n
    Well, all I can say is that Twitter bronies are awesome! Not only does everyone seem to love Big Macinbot, but they reply to and follow the bot on a regular basis. It has been fun seeing the reactions, and the general love for Big Macintosh. I\u00e2\u20ac\u2122ve had the pleasure of discovering a few very nice folks, too, so that has been a wonderful bonus. :)<\/font><\/p>\n
    Because of Big Macinbot\u00e2\u20ac\u2122s popularity, I\u00e2\u20ac\u2122ve been making regular tweaks and updates to how he works, and I\u00e2\u20ac\u2122m currently working on a suggestion to have Big Macinbot reply to everyone when being mentioned. I never expected him to gain such a following, but I\u00e2\u20ac\u2122m really happy he did, because I think he\u00e2\u20ac\u2122s a really fun bot! I just hope Twitter doesn\u00e2\u20ac\u2122t suspend the account \u00e2\u20ac\u201c I\u00e2\u20ac\u2122ve tried to be light on Twitter\u00e2\u20ac\u2122s resources, and follow best practices, so hopefully they\u00e2\u20ac\u2122ll let him keep going. Eeyup!<\/font><\/p>\n
    I\u00e2\u20ac\u2122d like to finish this post with some of my favorite reactions and replies to Big Macinbot. Thank you again to everypony for such a wonderful welcome to Twitter! If anyone has suggestions, or questions about what I wrote about here, please feel free to post a comment, or send me a message at @mageuzi<\/a>! :)<\/font><\/p>\n
    \n
    @AH_Dylon<\/a> Dude, I just had an encounter with the best Twitterbot ever.@BigMacinbot<\/a>. So legit.<\/p>\n
    \u00e2\u20ac\u201d Chris P. Come here! (@tictac472_FTW) January 14, 2012<\/a><\/p><\/blockquote>\n