Create Slack App
- Open https://api.slack.com/apps/new and choose "From an app manifest"
- Choose the workspace you want to install the application to
- Copy the contents of manifest.yml into the text box that says
*Paste your manifest code here*
and click Next - Review the configuration and click Create
- Now click Install to Workspace and Allow on the screen that follows. You'll be redirected to the App Configuration dashboard.
Environment variables Before you can run the app, you'll need to store some environment variables.
- Copy
.env.sample
to.env
- Open your apps configuration page from this list, click OAuth & Permissions in the left hand menu, then copy the Bot User OAuth Token into your
.env
file underSLACK_BOT_TOKEN
- Click Basic Information from the left hand menu and follow the steps in the App-Level Tokens section to create an app-level token with the
connections:write
scope. Copy that token into your.env
asSLACK_APP_TOKEN
. - For the
DB_URI
value, you should enter the URI of the database system you plan to store tasks in. In the.env.sample
file, we assume you're using SQLite, but you can use any system supported by Sequelize
Install dependencies
npm install
NOTE: By default, Tasks App installs sqlite3
, but as mentioned above, you can use any system supported by Sequelize, just npm install
the relevant package, e.g. npm install mysql2
Run database migrations
npx sequelize-cli db:migrate
Run Bolt Server
node app.js
More of a visual person? You can checkout a video walkthrough of these instructions.