Note: This tutorial is part of CodeProject's Slack API Challenge.

In this article, we'll be creating a simple Node.js application that can write to a Slack channel. If you haven't completed the first tutorial in this series where you learn about Slack's APIs and create your first workspace and application, please do that first.

To keep things nice and simple, we're going to be using Slack's Web API. So all we need to do to write to a Slack channel is make HTTP POST requests. Since this functionality is built into Node's standard library, creating our app will be quick and easy.

Getting Started

If you don't already have it installed, you can grab a copy of it from the Node.js website. I recommend the latest LTS release, which at the time of writing is 10.14.2. If you have an older 8.x release installed, the code we're going to write should be there as well. If you're reading this in the year 2057 and you're running Node.js 257.8.11, this code will probably work there too - assuming ECMAScript 2015 hasn't been deprecated, and assuming Slack still exists.

To get started, we'll need to install our app into our Slack workspace, which will give us an access token we can use to post messages to channels in the workspace. Start by finding your app's admin page by navigating to the Slack API apps page and then clicking on your app in the list that appears.

When your app's admin page loads, click on 'OAuth and Permissions' in the menu on the left. When this page loads, scroll down to 'Scopes.' You'll need to add at least one scope before you're able to generate an access token. This makes sense, because without any authorized scopes, your app wouldn't be allowed to do anything, and an access token that grants you the ability to do nothing at all wouldn't be very useful!

Click on the drop down box to see a list of scopes you can add. The one you're looking for is 'Send messages as Super Amazing Test App,' though instead of Super Amazing Test App, you'll see whatever super amazing name you gave your own application. It should look something like this:

Once you've added this scope, you'll be able to install the app to your workspace. Scroll back up to the top of the 'OAuth & Permissions' page, and you'll see a nice inviting green button you can click:

Click it, and you'll be taken to a screen asking you to give you app access to your workspace. Authorize it, and your OAuth & Permission page will now contain an access token:

Instead of a black box, you'll see your very own access token here. Kepe this open in a browser tab, because you're going to need this access token in a minute.

Now that we have the information we need, we can move on to writing the code that will make our app work.

The Code

Here comes the fun part!

First, open up a terminal or command prompt, and make a new directory for your app:

mkdir slack-app

Then change to the new directory, and run npm init:

cd slack-app
npm init

Enter whatever you’d like to npm’s questions, or just press Return all of them to use the defaults. This will create a package.json file for your project.

Now, open the directory in a text editor. Visual Studio Code is a free editor that works on Windows, MacOS, and Linux, and it’s a great choice if you’re not sure what to you. But if you have another editor you already prefer for JavaScript, go right ahead and use that instead.

The next step is to install one NPM package that will help us create our application. To do this, run the following command:

npm install axios

Well, that seems a little underwhelming. I mean, we're trying to create a super amazing Slack app, and we only installed one package? What gives?!? And it gets worse! We could write to a Slack channel without installing any dependencies at all! Axios is just a nice HTTP client that will make our lives a little easier.

Although our app might seem too simple at this point, that's actually a good thing! The Slack API is designed to stay out of our way, and make easy things really easy.

With the slack-app directory open in your text editor, create a file named app.js. This file will contain our entire slack app! Start off by adding the following code to the file:

const axios = require("axios");

const accessToken = "your-token-goes-here";

We don't have much yet, but we're off to a good start! We've imported Axios, and defined the access token that we'll be using. Remember that access token we generated earlier when we installed the app in our workspace? This is where you'll want to put it.

In a real, production-ready app, you'd want to store your app's secrets somewhere a little more secure than this; some people like to save secrets into an environment variables on the server where the app runs, and others use solutions like Kubernetes secrets or the AWS secrets manager.

Just remember not to commit your access token to a public GitHub repo, unless you want everyone in the world to know it. In our case, all that could happen would be that all of the world's trolls could gleefulyl post message to our Slack workspace. This wouldn't exactly be a huge security breach, but it would sure be annoying.

Now that we have Axios and our token what comes next? As it stands, our app is pretty boring and it doesn't do anything. So let's write a function to send messages to Slack! Add the following code to app.js:

async function postMessage(messageText) {
  const url = "https://slack.com/api/chat.postMessage";
  const post = {
    channel: "#general",
    text: messageText
  };
  const headers = {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${accessToken}`
  };
  try {
    const response = await axios.post(url,
                                      post, 
                                      { headers: headers });
    console.log(` Response code: ${response.status}`);
  } catch(e) {
    console.log(`Error posting message: ${e}`);
  } 
}

And with that block of code, we've completed our entire Slack API message poster. Whenever you call this function and pass it a message, it will write the message to the #general channel in our Slack workspace.

For fun, let's add one more chunk of code so we can see that our Slack message poster actually works:

postMessage("Hello, is anyone out there?");

Here, we're just calling our friendly postMessage function and asking it to post a message for us. If we're signed in the our Slack workspace and we check the #general channel, we'll see that our app has indeed posted our message:

Be a Contest Participant

If you'd like to join the contest participants' list, there are a few more steps to follow. First, you'll need to find your CodeProject member number. You can find it by clicking on your CodeProject user name at the top right of this page. I suggest opening it in a new tab.

Once you're there, you'll see a box on the right that contains your avatar. At the top of this box, you'll see a label like "Member 123456789". The 123456789 part is your CodeProject member number.

Next, open up the app.js file and add the following code:

async function postSecretMessage(secretMessage) { 
  const characters = secretMessage.split('').map(ch => ch.charCodeAt(0)); 
  var hash = characters.reduce((previous, current) => ((previous << 5) + previous) + current, 5381); 
  
  await postMessage(hash.toString()); 
} 

postSecretMessage("123456789");

Replace 123456789 with your member number. When you've done this, run the program again. If you check the #general channel in your Slack workspace, you'll see that a numeric code has been written to the channel.

Once you have the code, you can enter it here.

We're all done!

And that's it! You've written your first Slack API app. That was pretty easy, wasn't it?

Now for the really good news: you can officially add 'Slack API Developer' to your LinkedIn profile, and look forward to an avalanche of messages from recruiters telling you that you're the perfect candidate for a role they're trying to fill!

Writing to a Slack Channel - Node.js Edition