GroupMeme bot is a GroupMe bot running on a Node JS callback server that specializes in posting the best memes to the chat he lives in.
The project is based on the sample Node JS callback bot provided by GroupMe, which is a great place to get started if you want to set up a similar bot of your own.
I gave a presentation about Beep Boop to Carleton DevX in February 2017. View the repository as it was at the time of the presentation.
Go here to view all of your bots: https://dev.groupme.com/bots
Copy the Bot ID. Then go to your Heroku app's settings and configure a new environment variable called BOT_ID and paste your bot ID there.
On your computer, run cp .sample-env .env to create your own local configuration file and change the BOT_ID value to your bot ID.
If you want to be able to pull memes from Reddit, you will need to log into Reddit and create a web app. Then you will need to give the app permission to access your account. Teddy Katz's utility that you can install with npm install -g reddit-oauth-helper is a good way to set everything up.
Now you can put the appropriate values in your .env file and also create new environment variables of the same name in your Heroku deployment.
To test locally, you will first need to download and install the Heroku CLI. Then, open terminal and run the following commands to install the required packages and then start a local server.
npm install
heroku local
Then navigate to http://127.0.0.1:5000/ in a browser.
To simulate a message being sent to the group, make a new message.json file with the following contents:
{
"name": "Test Sender",
"text": "I would like a meme"
}
Then post the message to the server by running curl -H "Accept: application/json" -H "Content-Type: application/json" -d @message.json http://localhost:5000.
To contribute to the bot, either clone the develop branch: git clone -b develop https://github.com/simonbilskyrollins/groupmeme-bot.git or fork the entire project.
Once you've committed all your changes, push them and make a pull request to master.