My bot should be able to manage all the needs a small company could have on Slack: <ul><li>Onboarding </li><li>Putting people in touch </li><li>Reminders </li><li>Announcements </li><li>Birthdays /Anniversary </li><li>And many more </li></ul>

My Goals

For this program, I’ll use: <ul><li>Botkit </li><li>Node JS </li><li>Express Server </li><li>MongoDB </li><li>Slack API &amp; of course </li></ul>

Reviewing the basics

There are then two cases: <ul><li>You want your bot to react to events happening directly in Slack </li><li>You want your bot to react to events happening on your server </li></ul>

How do Slack bots work?

Below you’ll find my Server.Js file: This server is a blank page, showing and processing nothing. You’ll then need a slack App: just follow this link to create one. The Controller is the brain of your Bot. It contains every skill and configuration.

Getting Started

If you give the right Permissions to your App, every time a message is sent on a channel, slacks sends a request to your server with some information. If we want our Bot to react to a simple message like "Hi", we have to give slack an address to send the information to. If we want our Bot to react every time it hears "hello", we can simply add This.Hears() Function to our Controller. If we want our Bot 

Unlocking the first case: react to the events happening on Slack

A Cronjob firing every weekday at 9:00 am is below a Cronjob firing every weekday at 9:00 am. Thanks to the date() Method, the Bot gets today’s date and can compare it to the “Joineddate” of the user.

Second Case: initiate a conversation with your bot

<img alt="Alexandre Robin" src="https://miro.medium.com/max/500/1*-Kzv393yHiCCdn0ckuDdzA" width="48" height="48"><h1 data-selectable-paragraph="">Why create a Slack Bot ?</h1>I am an HR professional. More specifically I am a Human Resources Information System (HRIS) Consultant. I work with Application Tracking Systems, Learning Management Systems, and Core HR. But I have never had the opportunity to work with an HR Bot. Which may be the Future of HR.I read a lot about bots on Slack and Messenger, and used some of them in my daily life — Product Hunt, GitHub and Trello. But for HR purposes, I have never had the opportunity to work with a tool tailored for my needs.That’s why I decided to work on my own bot.<figure><img alt="" src="https://miro.medium.com/max/500/1*cyhNkd0jd7Zd3zBDLaKpS" width="455" height="290"><figcaption dir="auto">Me starting to work</figcaption></figure><h1 data-selectable-paragraph="">My Goals</h1>My bot should be able to manage all the needs a small company could have on Slack:<UL><LI>Onboarding</LI><LI>Putting people in touch</LI><LI>Reminders</LI><LI>Announcements</LI><LI>Birthdays /Anniversary</LI><LI>And many more</LI></UL><h1 data-selectable-paragraph="">Reviewing the basics</h1>For this program, I’ll use:<UL><LI>Botkit</LI><LI>Node JS</LI><LI>Express Server</LI><LI>MongoDB</LI><LI>Slack API &amp; of course</LI></UL>Botkit is:<BLOCKQUOTE>One easy way to build bot users, especially if you already work with <a href="https://nodejs.org/" rel="noopener" dir="ltr">Node.js</a>, is Howdy’s <a href="https://howdy.ai/botkit/" rel="noopener" dir="ltr">Botkit</a>. Botkit is a framework that takes care of most these API gymnastics, so you can focus on your bot’s behavior.</BLOCKQUOTE>Exactly what I was looking for :-)Botkit provides a boilerplate for Slack. But I have chosen to start from scratch to have a better understanding of my bot. However, it’s a good idea to train yourself with a bot created on <a href="https://glitch.com/botkit" rel="noopener" dir="ltr">Glitch</a>.<h2 data-selectable-paragraph="">How do Slack bots work?</h2>I am not an expert. I have read again and again Slack and Botkit’s official documentation. I’m still not sure I understood everything. Here is my understanding of a Slack bot’s behavior:Every App on Slack has a “scope” which is a perimeter on which an app can read or perform actions. A bot is part of an application created and installed on Slack.Therefore, when you install an app on Slack, you give access to some information and permissions to it. For your bot, you want it to be, at least, able to send and reply to messages of other users.There are then two cases:<OL><LI>You want your bot to react to events happening directly in Slack</LI><LI>You want your bot to react to events happening on your server</LI></OL>We will view both of them in this post!<h1 data-selectable-paragraph="">Getting Started</h1>Before anything else, you will need a server. In my case, Express.Below you’ll find my server.js file:This port must be public and accessible, not just on a localhost.For the moment, this server is a blank page, showing and processing nothing.You’ll then need a Slack App: just follow this <a href="https://api.slack.com/apps" rel="noopener" dir="ltr">link</a> to create one.Then, you’ll have to configure your controller. The controller is the brain of your bot. It contains every skill and configuration. Below is my botkit.js file. It has almost the same content found in Botkit’s Starter kit available here: <a href="https://github.com/howdyai/botkit-starter-slack" rel="noopener" dir="ltr">https://github.com/howdyai/botkit-starter-slack</a><h2 data-selectable-paragraph="">Unlocking the first case: react to the events happening on Slack</h2><figure><img alt="" src="https://miro.medium.com/max/500/1*51uJInZFmmF_0gD3ICFr9Q.jpeg" width="510" height="339"></figure>When you give the right permissions to your app, every time a message is sent on a channel, Slacks sends a request to your server with some information — the channel ID, the user, the timestamp and most importantly, the content of the message.If we want our bot to react to a simple message like “Hi”, we have to give Slack an address to send the information to.In a routes.js file write:<PRE>var Request = require('request') var slack = require('../controllers/botkit')module.exports = function(app) { app.post('/slack/receive', function(req,res){//respond to Slack that the webhook has been received. res.status(200);// Now, pass the webhook into be processed slack.controller.handleWebhookPayload(req, res) }) }</PRE>We now have a webhook : <a href="http://your-ip-or-domain:port/slack/receive" rel="noopener" dir="ltr">http://your-ip-or-domain:port/slack/receive</a>Once Slack is informed of this route via the Event Subscriptions page of your Slack App, it will be able to send it JSON. You will be able to receive it thanks to the parsing part of the server.js file above.Here is a (simple) schema to explain the process behind it:<figure><img alt="" src="https://miro.medium.com/max/500/1*c-Km3PgTIihfbthJC0BFf" width="785" height="307"></figure>1- SLACK « Here is a JSON file with the latest event on your Slack Channel »2- SERVER « Okay well received, I send it to Botkit»3- BOTKIT «Here is a temporary answer, wait a second»4- BOTKIT « Yeah! I hear a keyword, here is a JSON object with the action to perform »If we want our bot to react every time it hears “Hello”, we can simply add this .hears() function to our controller:<PRE>controller.hears(['hello', 'hi'], 'direct_message,direct_mention,mention', function(bot, message) {controller.storage.users.get(message.user, function(err, user) { if (user &amp;&amp; user.name) { bot.reply(message, 'Hello ' + user.name + '!!'); } else { bot.reply(message, 'Hello.'); } }); });</PRE>Notice the storage.users.get() part in this snippet. Botkit is compatible with almost all the database systems available on the market. I have decided to use MongoDB because it was on my learning list for a long time. Plus the documentation with Botkit is detailed.Now, we have to let our imagination do the work and find some fun features to create.<h2 data-selectable-paragraph="">Second Case: initiate a conversation with your bot</h2><figure><img alt="" src="https://miro.medium.com/max/500/1*pEUkhsJtGgYrzGvq0xf57Q.jpeg" width="680" height="383"></figure>For this feature, I wanted my bot to react to events which were not initiated on Slack. For example, do a daily routine. If it’s someone’s anniversary in the company, send them a survey asking their feelings about their first months/weeks.I have decided to use node-cron: <a href="https://github.com/kelektiv/node-cron" rel="noopener" dir="ltr">https://github.com/kelektiv/node-cron</a> to manage the daily check.Here is below a cronjob firing every weekday at 9:00 am. Thanks to the Date() method, the bot gets today’s date and can compare it to the “joinedDate” of the user.To get only the right users and avoid a forEach loop, we can use a query on our Database:And… Tada!<figure><img alt="" src="https://miro.medium.com/max/500/0*MSZ0zXebVZ_wwCKP." width="680" height="454"><figcaption class="gr gs cs cq cr gt gu bp b et br fv" data-selectable-paragraph="" dir="ltr">“A robot named Pepper holding an iPad” by <a href="https://unsplash.com/@agkdesign?utm_source=medium&amp;utm_medium=referral" class="bv jm" rel="noopener" dir="ltr">Alex Knight</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral" class="bv jm" rel="noopener" dir="ltr">Unsplash</a></figcaption></figure><h1 data-selectable-paragraph="">Conclusion</h1>After more than a year of being a camper and learning to code, I am really happy to be able to start and finish a project like this one. I now have a bot working and performing almost all the actions I had in mind at the design phase. And I still have a lot of ideas!I am still working on this bot. The GitHub repository is available here: <a href="https://github.com/alexandrobin/hrbot" rel="noopener" dir="ltr">https://github.com/alexandrobin/hrbot</a>. Some of the commits are in French, but the codebase is commented in English. :-)Besides, it’s quite easy to deploy it on Heroku with a Mongolab database if you don’t have a server!If you have some suggestions or are interested by this article and project, feel free to leave a comment ! I would be happy to discuss with you.

I am an HR professional. More specifically I am a Human Resources Information System (HRIS) Consultant. I work with Application Tracking Systems, Learning Management Systems, and Core HR. But I have…

humanresources

Human Resources

leadershipandmanagement

Leadership & Management

I am an HR professional. More specifically I am a Human Resources Information System (HRIS) Consultant. I work with Application Tracking Systems, Learning Management Systems, and Core HR. But I have never had the opportunity to work with an HR Bot. Which may be the Future of HR.

I read a lot about bots on Slack and Messenger, and used some of them in my daily life — Product Hunt, GitHub and Trello. But for HR purposes, I have never had the opportunity to work with a tool tailored for my needs.

That’s why I decided to work on my own bot.

My bot should be able to manage all the needs a small company could have on Slack:

<ul><li>Onboarding </li><li>Putting people in touch </li><li>Reminders </li><li>Announcements </li><li>Birthdays /Anniversary </li><li>And many more </li> </ul>

<ul><li>Botkit </li><li>Node JS </li><li>Express Server </li><li>MongoDB </li><li>Slack API & of course </li> </ul>

One easy way to build bot users, especially if you already work with <a href="https://nodejs.org/">Node.js </a>, is Howdy’s <a href="https://howdy.ai/botkit/">Botkit </a>. Botkit is a framework that takes care of most these API gymnastics, so you can focus on your bot’s behavior.

Exactly what I was looking for :-)

Botkit provides a boilerplate for Slack. But I have chosen to start from scratch to have a better understanding of my bot. However, it’s a good idea to train yourself with a bot created on <a href="https://glitch.com/botkit">Glitch </a>.

I am not an expert. I have read again and again Slack and Botkit’s official documentation. I’m still not sure I understood everything. Here is my understanding of a Slack bot’s behavior:

Every App on Slack has a “scope” which is a perimeter on which an app can read or perform actions. A bot is part of an application created and installed on Slack.

Therefore, when you install an app on Slack, you give access to some information and permissions to it. For your bot, you want it to be, at least, able to send and reply to messages of other users.

<ol><li>You want your bot to react to events happening directly in Slack </li><li>You want your bot to react to events happening on your server </li> </ol>

We will view both of them in this post!

Before anything else, you will need a server. In my case, Express.

Below you’ll find my server.js file:

This port must be public and accessible, not just on a localhost.

For the moment, this server is a blank page, showing and processing nothing.

You’ll then need a Slack App: just follow this <a href="https://api.slack.com/apps">link </a>to create one.

Then, you’ll have to configure your controller. The controller is the brain of your bot. It contains every skill and configuration. Below is my botkit.js file. It has almost the same content found in Botkit’s Starter kit available here: <a href="https://github.com/howdyai/botkit-starter-slack">https://github.com/howdyai/botkit-starter-slack </a>

When you give the right permissions to your app, every time a message is sent on a channel, Slacks sends a request to your server with some information — the channel ID, the user, the timestamp and most importantly, the content of the message.

If we want our bot to react to a simple message like “Hi”, we have to give Slack an address to send the information to.

We now have a webhook : <a href="http://your-ip-or-domain:port/slack/receive">http://your-ip-or-domain:port/slack/receive </a>

Once Slack is informed of this route via the Event Subscriptions page of your Slack App, it will be able to send it JSON. You will be able to receive it thanks to the parsing part of the server.js file above.

Here is a (simple) schema to explain the process behind it:

1- SLACK « Here is a JSON file with the latest event on your Slack Channel »

2- SERVER « Okay well received, I send it to Botkit»

3- BOTKIT «Here is a temporary answer, wait a second»

4- BOTKIT « Yeah! I hear a keyword, here is a JSON object with the action to perform »

If we want our bot to react every time it hears “Hello”, we can simply add this .hears() function to our controller:

Notice the storage.users.get() part in this snippet. Botkit is compatible with almost all the database systems available on the market. I have decided to use MongoDB because it was on my learning list for a long time. Plus the documentation with Botkit is detailed.

Now, we have to let our imagination do the work and find some fun features to create.

For this feature, I wanted my bot to react to events which were not initiated on Slack. For example, do a daily routine. If it’s someone’s anniversary in the company, send them a survey asking their feelings about their first months/weeks.

I have decided to use node-cron: <a href="https://github.com/kelektiv/node-cron">https://github.com/kelektiv/node-cron </a>to manage the daily check.

Here is below a cronjob firing every weekday at 9:00 am. Thanks to the Date() method, the bot gets today’s date and can compare it to the “joinedDate” of the user.

To get only the right users and avoid a forEach loop, we can use a query on our Database:

After more than a year of being a camper and learning to code, I am really happy to be able to start and finish a project like this one. I now have a bot working and performing almost all the actions I had in mind at the design phase. And I still have a lot of ideas!

I am still working on this bot. The GitHub repository is available here: <a href="https://github.com/alexandrobin/hrbot">https://github.com/alexandrobin/hrbot </a>. Some of the commits are in French, but the codebase is commented in English. :-)

Besides, it’s quite easy to deploy it on Heroku with a Mongolab database if you don’t have a server!

If you have some suggestions or are interested by this article and project, feel free to leave a comment ! I would be happy to discuss with you.

How I built an HR Slack Bot with Node and Botkit

My Goals

Reviewing the basics

How do Slack bots work?

Getting Started

Unlocking the first case: react to the events happening on Slack

Second Case: initiate a conversation with your bot

CURATED BY

Related collections

More like this