JS Tips Slack Bot
Slack Bot implementation for sending the latest JS tips collected in https://github.com/loverajoel/jstips.
Install Node.js and npm
This is a Node.js app, so the first step is to be sure you have installed Node.js and npm:
- OS X
Go to nodejs.org, Click
install, and run through the install process.
You can use the Node.js binary distributions
curl -sL https://deb.nodesource.com/setup_5.x | sudo -E bash - sudo apt-get install -y nodejs
More installation help at https://github.com/nodesource/distributions#deb
Go ahead to download the Windows binary at https://nodejs.org/en/download/
Clone this repo
Next step is to clone this repository using the following command:
git clone email@example.com:radibit/js-tips-slack-bot.git
and navigate to the cloned project folder:
In the project folder run the command
in order to install locally the required dependencies.
There are four config variables for this project:
GH_TOKEN- GitHub API token - can be generated from your GitHub settings panel
SLACK_TOKEN- Slack API Token - in order to create one visit Slack API settings
SLACK_GROUP- Target Slack group - specify the Slack group that will receive the messages
SLACK_POST_TO( optional ) - Specify if the messages should be posted to a private group (
group) which is the default option or a public channel (
DATABASE_URL- Heroku Postgres URL - provide URL in order to connect the app to a Postgres database. Once you installed the Heroku Postgres add-on you can find the required information on the connection settings panel
Test it locally
First you need to create
.env file in the root folder of the project and list there the required config variables.
You can use as a reference the
After providing the required values for the config variables, you can run the app with the following command:
npm run start
If you want to end the started terminal process, you can do this using ctrl + c
Playing with the script you can adjust whether you want to send the js tip to a Slack group ( default ), channel or single user. More info about the exposed methods of the Slack's Real Time Messaging API can be found here
Heroku set up and deployment
It's fun to play locally with the app
Create an account and download Heroku https://toolbelt.heroku.com/
.envinside of the project folder and replace the placeholder variables with real tokens/values (see Config section)
In the terminal, within the project folder, run the following command to create a new Heroku app:
More help info how to use the Heroku CLI can be found on the Heroku DevCenter
- Commit and push the Heroku app:
git add -f .env git commit -m "Added private tokens that I promise to never-ever-ever share with the public." git push heroku master
With the last command you are actually deploying your app to Heroku and after that it will be already running live.
You can find your new app listed in the Heroku dashboard
Set up a database in order to store the latest JS tip and send a Slack message only when there is a new one.
You need to configure the Heroku Postgres add-on and create a table with a name
js_tip and two columns -
msg_id ( PRIMARY KEY ) and
name ( varchar (250) )