How to Deploy a Node.js Slack Bot to Production on Code Capsules
Deploy a Node.js Slack Bot and learn how to host backend code on Code Capsules.
To demonstrate how to deploy a Node.js Slack Bot with Code Capsules, we’ve provided an example bot which you can find on the Code Capsules GitHub repository.
Sign in to GitHub, and fork the example bot repository by clicking "Fork" at the top-right of your screen and selecting your GitHub account as the destination.
Create a Space for your Bot
Log in to your Code Capsules account and navigate to the "Spaces" tab. Once there, click the yellow
+ icon on the top right of the screen to add a new Space.
Follow the prompts, choosing your region and giving your Space a name, then click "Create Space".
Example instructions to go with numbered annotations 1. Choose a team — you can use a default “personal” team if you’re the only person working on this project, or a named team if you’re collaborating with others 2. This should remind you of the project, for example “customer-api” or “notetaking-app” 3. Choose a country close to where most of your users will be 4. If you’re already using a specific cloud, you can choose that here, otherwise pick any one.
Create the Capsule
A Capsule provides the server for hosting an application on Code Capsules.
To create a new Capsule for your space follow the instructions below:
- Choose "Backend Capsule", your Team and Space.
- Choose your payment plan.
- Click the GitHub button and give access to the repository you forked at the start of the tutorial.
- Choose the GitHub repository you forked.
- Press "Next".
- Leave "Run Command" blank.
- Click "Create Capsule".
Code Capsules will automatically build your application when you’ve finished creating the Capsule.
Once your application is live, you can view the build log by selecting the "Deploy" tab and clicking the "View build log" link in the "Builds" section.
Register the Bot
You'll need a Slack user account and to log into a workspace before you can create a Slack bot. After you have logged into a workspace head over to the Slack API page and click on "Create an app".
- On the popup that displays, choose the "From scratch" option, give your app a name and choose the workspace you want to add it to then click "Create App".
- Click "OAuth & Permissions" on the left panel and scroll down to the Scopes section and click "Add an OAuth Scope" under the Bot Token Scopes section.
- Choose "chat:write" from the options list.
- Click on the "Slash Commands" menu item on the left, under Features then click "Create a new Command".
- Give the command the name
- For the Request URL, head over to your Capsule "Details" tab on Code Capsules and copy the URL under the "URL" section.
- Paste your URL into the Request URL box on Slack, and add
/slack/command/statsto the end of it.
- Fill in the description with 'Returns key stats from the app'.
- Click "Save".
Add Environment Variables
Our bot's logic makes use of environment variables to function securely. You'll need to add the variables to your capsule's "Configure" tab before the bot can send/receive messages from your workspace.
For the first environment variable,
- Head over to your app dashboard on Slack, and click on the "OAuth & Permissions" menu item on the left-hand side.
- Click the "Install to Workspace" button followed by the "Allow" button.
- Actioning the preceeding 2 steps should reveal a newly generated "Bot User OAuth Token". Copy this token.
- On your capsule's "Configure" tab, add a new environment variable with the name
SLACK_BOT_TOKENand set its value to the token you copied in the previous step.
- Confirm your changes by clicking on "Save".
For the second environment variable,
- Open Slack and right-click on the channel name of the channel you want to send messages to.
- On the context menu that appears, choose "Copy Link".
- Paste the link in a browser tab but don't press "enter" or "return".
- The link should follow the format,
https://<workspace-name>.slack.com/archives/C01SZ6Z3TCY. The last part of that URL is the channel ID; in this example case,
- Add the channel ID to the environment variables with the name
- Confirm your changes by clicking on "Save".
For the third environment variable,
- Head over to your Slack app dashboard and click on "Basic Information" on the left-hand side.
- Scroll down to App Credentials and look for the Signing Secret. Click "Show" and copy the secret.
- Add a new environment variable with the name
SLACK_SIGNING_SECRETon your capsule's "Configure" tab and set its value to the secret you copied in the previous step.
- Confirm your changes by clicking on "Save", then restart your Capsule by toggling the radio button in the top right off and on again.
Invite Bot to Channel
You need to invite the bot to the chosen channel so that it'll be able to post there. To do this, send a message mentioning
@<bot-name> the bot in the channel you added it to. Click "Invite Them" when Slack prompts you.
Chat with the Bot
The bot can now send messages to the channel everytime it starts. You can restart the capsule to see this functionality in action or alternatively send a
/stats message in the channel to get a report about the bot's status on Code Capsules.
If you’d like to deploy another application in a different language or framework, take a look at our other deployment guides.