To get started remix this project to get your own project with a copy of the code. Then on Slack's site, select 'Create New App' and fill in the name and workspace of your bot.
Then start by selecting the 'Permissions' button. Under 'Redirect URI(s)' add your Glitch project's publish URL followed by '/auth/grant' - use your publish URL (click 'Show') which has the format 'https://project-name.glitch.me'. So for our example app, the URL is: 'https://slack-bot.glitch.me/auth/grant'. Finish by selecting 'Save URLs'.
Under Scopes, add the following permissions: bot, chat:write:bot, pins:read, reactions:read, stars:read and commands.
Select 'Bot Users' and add a name you'll use to interact with your bot in Slack. We used 'onboarding' for our example bot.
Select 'Slash Commands' and create a new command. The example uses the command /onboarding, and the request URL is the same project URL you used before: 'https://project-name.glitch.me'.
Go to the 'Event Subscriptions' page. Here you need to enable event subscriptions for your app by toggling the button to 'on'. Then you want to verify your project URL to use those events. Copy and paste your project's published URL into the 'Request URL' box (again it will have the format 'https://project-name.glitch.me'). You should get a verified message, indicating it successfully reached your project.
Now you want to tell Slack which events you'll actually be using for your bot, so it only sends you those ones. In our Onboarding Bot example, we want to respond to user input, like adding stars, reactions, and pins. So back on the Slack 'Event Subscriptions' page, for both 'Bot Events' and 'Workspace Events', add 'pin_added', 'reaction_added' and 'star_added' events. Click 'Save Changes' to finish.
Now go to the 'Basic Information' page. From under 'App Credentials' you want to copy these details into your Glitch project .env file. This is a file that securely stores your app credentials. There are entries for SLACK_CLIENT_ID and SLACK_CLIENT_SECRET. Copy and paste the entries for Client ID and Client Secret against the variable names.
Note: If you want to add persistance to your bot, see this example.
So now you can add the bot to your Slack instance. You need Admin rights in Slack to do this, but whilst you're testing things out, it's a good idea to create your own test Team in Slack to try things out. That way you can make sure your bot is working before you share it with your colleagues. The example project adds an 'Add to Slack' button to your root published project URL (click 'Show') e.g. https://slack-bot.glitch.me/. This sets up the Slack OAuth scopes you need for the Onboarding Example bot by default, but you can change them by editing the values in the add_to_slack variable in the tinyspeck.js file in your project.
Your bot should now be up and running and able to respond to actions you make in Slack. To try it out, try typing a direct message to the onboarding bot, and add an emoji reaction to that message. It should respond with some text explaining how to undertake key actions in Slack with the Emoji reaction action marked done. Similarly, if you type the slash command /onboarding, you'll get the current onboarding status back.
You can see other example projects on our Community Projects page. And if you get stuck, let us know on the forum and we can help you out.