Twitter autoresponder bot

1_Twitter autoresponder bot.md

Twitter autoresponder bot

By Daniel15 (dan.cx) This is a very simple Twitter autoresponder bot. It requires PECL OAuth extension to be installed (run "pecl install oauth", or if on Windows, grab php-oauth.dll. If using cPanel you can install it via WHM). The authentication is designed for command-line usage, it won't work too well via a web browser. You'll have to sign up for an application on Twitter's site to get the consumer key and secret.

Could be modified to be more advanced (match regular expressions to answer questions, etc.)

Questions? See my blog post - http://dan.cx/blog/2011/06/twitter-autoreply-bot-dbznappa

Modified 2013-06-13 - Twitter API 1.0 discontinued, modified to use Twitter API 1.1

example.php

#!/usr/bin/php
<?php
date_default_timezone_set('Australia/Melbourne');
require('TwitterAutoReply.php');

// Consumer key and consumer secret
$twitter = new TwitterAutoReply('******', '************************');
// Token and secret
$twitter->setToken('********-*******************', '*****************8');
$twitter->addReply('over 9000', 'WHAT?! NINE THOUSAND?!');
$twitter->addReply('over nine thousand', 'WHAT?! NINE THOUSAND?!');
$twitter->run();
?>

TwitterAutoReply.php

<?php
// Twitter autoreply
// By Daniel15 <http://dan.cx/>
// Modified 2013-06-13 to support Twitter API 1.1

class TwitterAutoReply
{
	// Constants
	const SEARCH_URL = 'https://api.twitter.com/1.1/search/tweets.json?q=%s&since_id=%s';
	const UPDATE_URL = 'https://api.twitter.com/1.1/statuses/update.json';
	const VERIFY_URL = 'https://api.twitter.com/1.1/account/verify_credentials.json';
	const REQUEST_TOKEN_URL = 'https://twitter.com/oauth/request_token';
	const ACCESS_TOKEN_URL = 'https://twitter.com/oauth/access_token';
	const AUTH_URL = 'http://twitter.com/oauth/authorize';
	
	// Variables
	private $_replies = array();
	private $_oauth;
	private $_screenName;
	
	// Methods
	public function __construct($consumer_key, $consumer_secret)
	{
		$this->_oauth = new OAuth($consumer_key, $consumer_secret, OAUTH_SIG_METHOD_HMACSHA1, OAUTH_AUTH_TYPE_URI);
		$this->_oauth->disableSSLChecks();
	}
	
	public function setToken($token, $secret)
	{
		$this->_oauth->setToken($token, $secret);
	}
	
	public function addReply($term, $reply)
	{
		$this->_replies[$term] = $reply;
	}
	
	public function run()
	{
		echo '========= ', date('Y-m-d g:i:s A'), " - Started =========\n";
		// Get the last ID we replied to
		$since_id = @file_get_contents('since_id');
		if ($since_id == null)
			$since_id = 0;
			
		// This will store the ID of the last tweet we get
		$max_id = $since_id;
		
		// Verify their Twitter account is valid
		if (!$this->verifyAccountWorks())
		{
			// Get a request token and show instructions
			$this->doAuth();
			die();
		}
		
		// Go through each reply
		foreach ($this->_replies as $term => $reply)
		{
			echo 'Performing search for "', $term, '"... ';
			$this->_oauth->fetch(sprintf(self::SEARCH_URL, urlencode($term), $since_id));
			$search = json_decode($this->_oauth->getLastResponse());
			echo 'Done, ', count($search->statuses), " results.\n";
			// Store the max ID
			if ($search->search_metadata->max_id_str > $max_id)
				$max_id = $search->search_metadata->max_id_str;
			
			// Now let's go through the results
			foreach ($search->statuses as $tweet)
			{
				// Ensure we don't reply to ourself!
				if ($tweet->user->screen_name == $this->_screenName)
					continue;

				$this->sendReply($tweet, $reply);
				sleep(1);
			}
		}
		
		file_put_contents('since_id', $max_id);
		echo '========= ', date('Y-m-d g:i:s A'), " - Finished =========\n";
	}
	
	private function sendReply($tweet, $reply)
	{
		try
		{
			echo '@', $tweet->user->screen_name, ' said: ', $tweet->text, "\n";
			$this->_oauth->fetch(self::UPDATE_URL, array(
				'status' => '@' . $tweet->user->screen_name . ' ' . $reply,
				'in_reply_to_status_id' => $tweet->id_str,
			), OAUTH_HTTP_METHOD_POST);
		}
		catch (OAuthException $ex) 
		{
				echo 'ERROR: ' . $ex->lastResponse;
				die();
		}
	}
	
	private function verifyAccountWorks()
	{
		try
		{
			$this->_oauth->fetch(self::VERIFY_URL, array(), OAUTH_HTTP_METHOD_GET);
			$response = json_decode($this->_oauth->getLastResponse());
			$this->_screenName = $response->screen_name;
			return true;
		}
		catch (Exception $ex)
		{
			return false;
		}
	}
	
	private function doAuth()
	{
		// First get a request token, and prompt them to go to the URL
		$request_token_info = $this->_oauth->getRequestToken(self::REQUEST_TOKEN_URL);
		echo 'Please navigate to the following URL to get an authentication token:', "\n";
		echo self::AUTH_URL, '?oauth_token=', $request_token_info['oauth_token'], "\n";
		echo 'Once done (and you have a PIN number), press ENTER.';
		fread(STDIN, 10);
		
		echo 'PIN Number: ';
		$pin = trim(fread(STDIN, 10));
		
		// Now let's swap that for an access token
		$this->_oauth->setToken($request_token_info['oauth_token'], $request_token_info['oauth_token_secret']);
		$access_token_info = $this->_oauth->getAccessToken(self::ACCESS_TOKEN_URL, null, $pin);
		
		echo 'Success, ', $access_token_info['screen_name'], ' has authorized the application. Please change your setToken line to something like the following:', "\n";
		echo '$twitter->setToken(\'', $access_token_info['oauth_token'], '\', \'', $access_token_info['oauth_token_secret'], '\');';
		die();
	}
	
	public function testTweet()
	{
		$this->_oauth->fetch(self::UPDATE_URL, array(
			'status' => 'Test from TwitterAutoReply',
		), OAUTH_HTTP_METHOD_POST);
	}
}
?>

I modified the code is now?

All those errors are unrelated, they're PHP errors. You'll have to fix your PHP installation :) php5ts.dll is a core component of PHP. If you're getting php5ts.dll errors, you may need to reinstall PHP. Regards, Daniel Lo Nigro http://dan.cx/ | http://twitter.com/Daniel15

…

On Thu, Mar 8, 2012 at 8:12 AM, axfelix < ***@***.*** > wrote: I have a feeling this may be me/Windows issues, but I'm getting lots of "file not found" errors when I try to run this: php5ts.dll -- downloaded, and added extension to php.ini; still not being found. oci.dll -- download, put in sys32; still not being found. sqlite3.dll -- downloaded, and added extension to php.ini; still not being found. aspell-15.dll -- download, put in sys32; still not being found. libcs.dll -- can't download; apparently entails some weird old Sybase dependency. Any ideas? --- Reply to this email directly or view it on GitHub: https://gist.github.com/820281

Hey Daniel,

Great work! Very easy to read and by following the comments here I was able to implement an alternative to PECL OAuth since my Dreamhost account doesn't seem to have it available.

I swapped it out for tmhOAuth by downloading the source files (found here https://github.com/themattharris/tmhOAuth), including them at the top:

require_once('tmhUtilities.php');
require_once('tmhOAuth.php');

and swapping out the following in Daniels twitterautoreply.php:

in the __construct delete everything and paste the following:

$this->_oauth = new tmhOAuth(array(
'consumer_key' => '',
'consumer_secret' => '',
'user_token' => '',
'user_secret' => '',
'curl_ssl_verifypeer' => false,
));

and instead of using the fetch command (lines 79 & 89) you'll need to re-order the variables and feed it to the request command in tmhoauth. So at line 79 (of the source, will be different if you added the above code) switch this:

$this->_oauth->fetch(self::UPDATE_URL, array(
'status' => '@' . $tweet->from_user . ' ' . $reply,
'in_reply_to_status_id' => $tweet->id_str,
), OAUTH_HTTP_METHOD_POST);

with this:

$this->_oauth->request('POST',$this->_oauth->url('1/statuses/update'), array(
'status' => '@' . $tweet->from_user . ' ' . $reply,
'in_reply_to_status_id' => $tweet->id_str,
));

and at line 89 switch this:

$response = $this->_oauth->fetch(self::VERIFY_URL, array(), OAUTH_HTTP_METHOD_GET);

with this:

$response = $this->_oauth->request('GET',$this->_oauth->url('1/statuses/update'), array());

Hope this helps someone! Feel free to follow me @russ152 if you have any questions, suggestions.

Thanks again Daniel!

Hmmm, I will try to take a look at it a little later, but for now I'd verify that the URL is correct by echoing something at that location

…

Sent from my iPhone

On Jul 11, 2012, at 9:39 AM, ***@***.*** wrote: Hi rlamb2, I'm getting this error: # !/usr/bin/php Fatal error: Call to undefined method tmhOAuth::setToken() in /home/leylaca/public_html/lmrobot/TwitterAutoReply.php on line 36 help please. --- Reply to this email directly or view it on GitHub: https://gist.github.com/820281

I've got this running as an auto reply to anyone that has mentioned a specific account but it keeps replying to same ones over and over. Anyone got an idea how i can stop this?

@BenPalmer have you checked that it is successfully created the file 'since_id'? And the contents?

Anyway, the reason I was here was to thank Daniel for posting this - it just gave me a few leads to get something very similar up using Twitter-Async. I also dropped a conditional ... if (!$tweet->in_reply_to_status_id) ... into the innermost foreach loop so that it didn't auto-reply to @replies, only to brand new tweets. Nice and simple.

Pretty cool!! A year ago I forked and implemented a method to match regexp. Today I change the method 'sendReply' of my fork to match your one.

This bot still work?! Did you test lately?

@iskigow Yes, the bot is still functioning :) See http://twitter.com/DBZNappa

Hey Daniel, just an FYI that Twitter is deprecating v1 of the API very soon. Will need to update the URLs to fit.

11 days to update the API 1.1 URL, right?

Sorry about the delay @jasonclemons and @nobitargh, I updated the bot for v1.1 of the API a few days ago.

Daniel, do you know any way to enable multiple bots simultaneously instead of one? In the case here, each bot wheel separately. Is there any way when the 1000 replyes are exhausted, another bot take?

Hi, Daniel, how do you manage to to avoid your account being suspended?

Per your instructions, I did everything correctly but... I'm getting a PHP: Error parsing on line 3:
1./usr/bin/php
2.<?php
3.date_default_timezone_set('Australia/Melbourne');
4. require('TwitterAutoReply.php');

???

It's the "date_default_timezone_set('Australia/Melbourne');"

Help!

ERROR: {"errors":[{"code":86,"message":"This method requires a POST."}]}

helo sir, i wanna ask,
whether it should be i upload to host? just it,right?

and where must i changes?

Most of time i am getting this error
ERROR: {"errors":[{"code":187,"message":"Status is a duplicate."}]}
How i can ignore this..??

I get this errors :S
Notice: Use of undefined constant STDIN - assumed 'STDIN' in C:\Users\USER\Dropbox\Documentos\Desarrollo Web\xampp\htdocs\twitterbot\TwitterAutoReply.php on line 123

Warning: fread() expects parameter 1 to be resource, string given in C:\Users\USER\Dropbox\Documentos\Desarrollo Web\xampp\htdocs\twitterbot\TwitterAutoReply.php on line 123
PIN Number:
Notice: Use of undefined constant STDIN - assumed 'STDIN' in C:\Users\USER\Dropbox\Documentos\Desarrollo Web\xampp\htdocs\twitterbot\TwitterAutoReply.php on line 126

Warning: fread() expects parameter 1 to be resource, string given in C:\Users\USER\Dropbox\Documentos\Desarrollo Web\xampp\htdocs\twitterbot\TwitterAutoReply.php on line 126

Fatal error: Uncaught exception 'OAuthException' with message 'Invalid auth/bad request (got a 401, expected HTTP/1.1 20X or a redirect)' in C:\Users\USER\Dropbox\Documentos\Desarrollo Web\xampp\htdocs\twitterbot\TwitterAutoReply.php:130 Stack trace: #0 C:\Users\USER\Dropbox\Documentos\Desarrollo Web\xampp\htdocs\twitterbot\TwitterAutoReply.php(130): OAuth->getAccessToken('https://twitter...', '', '') #1 C:\Users\USER\Dropbox\Documentos\Desarrollo Web\xampp\htdocs\twitterbot\TwitterAutoReply.php(53): TwitterAutoReply->doAuth() #2 C:\Users\USER\Dropbox\Documentos\Desarrollo Web\xampp\htdocs\twitterbot\example.php(12): TwitterAutoReply->run() #3 {main} thrown in C:\Users\USER\Dropbox\Documentos\Desarrollo Web\xampp\htdocs\twitterbot\TwitterAutoReply.php on line 130

how i can do this with Twitter streaming API's.......I want to use streaming API's. Please suggest me..???

Hi Daniel..

Can it also work for shared hosting like Hawkhost? I don't know exactly if it has something like PECL OAuth or SSH Access.. THanks in advance..

@lionx - I'm not sure. Ask them if they can install PECL OAuth or use a modified version of this script that uses a different OAuth library.

Hi Daniel.. @Daniel15

!/usr/bin/php

Fatal error: Class 'OAuth' not found in C:\xampp\htdocs\Twitter-Keyword-AutoReply-master\TwitterAutoReply.php on line 24

how can i set up please !

How do i use this? what do i need to do this 24/7 even if my pc is off or is it for a webhost? does someone have a youtube tutorial? i want this very much!

Does not seem to run.

@Vanqaqi What errors are you encountering?

@TheSecretCandy You need a server you can upload the script onto. A webhost is fine if they have SSH access.

hi! is there a way to set this up so it replies with a specific tweet automatically to users I follow, regardless of WHAT they tweet?

So here's my contribution
Make sure it's not a retweet
Make sure it's not a reply

                  ` // Now let's go through the results
        foreach ($search->statuses as $tweet)
        {

            // Ensure we don't reply to ourself!
            if ($tweet->user->screen_name == $this->_screenName)
                continue;

            //@Amged Edits
            // Ensure it's not a retweet
            $pos = strpos($tweet->text, 'RT');
            if ( $pos === 0 )
            continue;

            //@Amged Edits
            //Ensure it's not a reply to a conversation
            if ($tweet->in_reply_to_status_id)
            continue;

            //@Amged Edits - Debug
            /*
            echo "<pre>";
            echo print_r($tweet);
            echo "</pre><br /> ---------------------<br />";
            */
            $this->sendReply($tweet, $reply);
            sleep(1);

        }` 

how to use in laravel ?

@OmgedOsman Good edits. I've made some major edits to your modified version. Allows for keyword filtering. If keyword is present tweet will be ignored.
$badstrings is a string array.
Usage: $twitter->addReply('Search for', 'Reply with', $badstrings)
Filtering isn't necessary, this will work too: $twitter->addReply('Search for', 'Reply with')

<?php
// Twitter autoreply
// By Daniel15 <http://dan.cx/>
// Modified 2013-06-13 to support Twitter API 1.1
//Modified 2017-04-29 to allow for advanced keyword filtering(@Silverstonery)
class TwitterAutoReply
{
	// Constants
	const SEARCH_URL = 'https://api.twitter.com/1.1/search/tweets.json?q=%s&since_id=%s';
	const UPDATE_URL = 'https://api.twitter.com/1.1/statuses/update.json';
	const VERIFY_URL = 'https://api.twitter.com/1.1/account/verify_credentials.json';
	const REQUEST_TOKEN_URL = 'https://twitter.com/oauth/request_token';
	const ACCESS_TOKEN_URL = 'https://twitter.com/oauth/access_token';
	const AUTH_URL = 'http://twitter.com/oauth/authorize';
	
	// Variables
	private $_replies = array();
	private $_oauth;
	private $_screenName;
	private $_badstrings = null; //@Silverstronery Edits: Declare Bad strings variable
	// Methods
	public function __construct($consumer_key, $consumer_secret)
	{
		$this->_oauth = new OAuth($consumer_key, $consumer_secret, OAUTH_SIG_METHOD_HMACSHA1, OAUTH_AUTH_TYPE_URI);
		$this->_oauth->disableSSLChecks();
	}
	
	public function setToken($token, $secret)
	{
		$this->_oauth->setToken($token, $secret);
	}
	
	public function addReply($term, $reply, $bad)
	{
		$this->_replies[$term] = $reply;
		$this->_badstrings = $bad;
	}
	
	public function run()
	{
		//echo '========= ', date('Y-m-d g:i:s A'), " - Started =========\n";
		// Get the last ID we replied to
		$since_id = @file_get_contents('since_id');
		if ($since_id == null)
			$since_id = 0;
			
		// This will store the ID of the last tweet we get
		$max_id = $since_id;
		
		// Verify their Twitter account is valid
		if (!$this->verifyAccountWorks())
		{
			// Get a request token and show instructions
			$this->doAuth();
			die();
		}
		
		// Go through each reply
		foreach ($this->_replies as $term => $reply)
		{
			echo 'Performing search for "', $term, '"... ';
			$this->_oauth->fetch(sprintf(self::SEARCH_URL, urlencode($term), $since_id));
			$search = json_decode($this->_oauth->getLastResponse());
			echo 'Done, ', count($search->statuses), " results.\n";
			// Store the max ID
			if ($search->search_metadata->max_id_str > $max_id)
				$max_id = $search->search_metadata->max_id_str;
			
			// Now let's go through the results
			foreach ($search->statuses as $tweet)
        {

            // Ensure we don't reply to ourself!
            if ($tweet->user->screen_name == $this->_screenName)
                continue;

            //@Amged Edits
            // Ensure it's not a retweet
            $pos = strpos($tweet->text, 'RT');
            if ( $pos === 0 ){
            continue;
            }
            
            //@Silverstonery Edits
            //Filter through tweets
            $good = true;
            if($this->_badstrings != null){
                foreach ($this->_badstrings as $badstring) {
                    //if (strstr($tweet->text, $badstring)) { //Alternate version(Difference in speed)
                    if (strpos($tweet->text, $badstring) !== false) {
                        $good = false; 
                    }
                }
            }
            
            if(!$good){
                continue;
            }
            
            //@Amged Edits - Debug
            /*
            echo "<pre>";
            echo print_r($tweet);
            echo "</pre><br /> ---------------------<br />";
            */
            $this->sendReply($tweet, $reply);
            sleep(8); //@Silverstonery edit. Prevent bot from getting disabled, increases speed because 5 minute bot timouts from twitter take longer to happen than 7 more seconds of waiting

        }
		}
		
		file_put_contents('since_id', $max_id);
		echo '========= ', date('Y-m-d g:i:s A'), " - Finished =========\n";
	}
	
	private function sendReply($tweet, $reply)
	{
		try
		{
			echo '@', $tweet->user->screen_name, ' said: ', $tweet->text, "\n";
			$this->_oauth->fetch(self::UPDATE_URL, array(
				'status' => '@' . $tweet->user->screen_name . ' ' . $reply,
				'in_reply_to_status_id' => $tweet->id_str,
			), OAUTH_HTTP_METHOD_POST);
		}
		catch (OAuthException $ex) 
		{
				echo 'ERROR: ' . $ex->lastResponse;
				die();
		}
	}
	
	private function verifyAccountWorks()
	{
		try
		{
			$this->_oauth->fetch(self::VERIFY_URL, array(), OAUTH_HTTP_METHOD_GET);
			$response = json_decode($this->_oauth->getLastResponse());
			$this->_screenName = $response->screen_name;
			return true;
		}
		catch (Exception $ex)
		{
			return false;
		}
	}
	
	private function doAuth()
	{
		// First get a request token, and prompt them to go to the URL
		$request_token_info = $this->_oauth->getRequestToken(self::REQUEST_TOKEN_URL);
		echo 'Please navigate to the following URL to get an authentication token:', "\n";
		echo self::AUTH_URL, '?oauth_token=', $request_token_info['oauth_token'], "\n";
		echo 'Once done (and you have a PIN number), press ENTER.';
		fread(STDIN, 10);
		
		echo 'PIN Number: ';
		$pin = trim(fread(STDIN, 10));
		
		// Now let's swap that for an access token
		$this->_oauth->setToken($request_token_info['oauth_token'], $request_token_info['oauth_token_secret']);
		$access_token_info = $this->_oauth->getAccessToken(self::ACCESS_TOKEN_URL, null, $pin);
		
		echo 'Success, ', $access_token_info['screen_name'], ' has authorized the application. Please change your setToken line to something like the following:', "\n";
		echo '$twitter->setToken(\'', $access_token_info['oauth_token'], '\', \'', $access_token_info['oauth_token_secret'], '\');';
		die();
	}
	
	public function testTweet()
	{
		$this->_oauth->fetch(self::UPDATE_URL, array(
			'status' => 'Test from TwitterAutoReply',
		), OAUTH_HTTP_METHOD_POST);
	}
}
?>