Drebedengi Slack App

This app was created with SST.

Click to see more screenshots

Add expenses to Drebedengi, check balance via Slack app

Get notified about expenses and income

Installation

This app is deployed to AWS using SST.

Before you start

• You need AWS account with aws CLI command installed. To install aws CLI command check out this guide.
• It is good to create sandbox Slack Workspace so that you can safely install Slack app.

How to install Slack app locally

1. Clone this repo and install dependencies

gh repo clone preshetin/drebedengi-slack
cd drebedengi-slack
yarn

2. Copy environmental variables

cp env.example .env

3. Start local development

yarn start

If everything goes fine, in the end you will see ApiEndpoint that looks like https://xxx.execute-api.us-east-1.amazonaws.com. Note it since you will need when configuring your Slack app (see next step).

4. Now go to https://api.slack.com/apps and create your Slack app. Choose the workspace you are installing the app. Insert this this manifest template file. In that template, make sure to enter ApiEndpoint value in several places.
5. Once your app Slack app is ready, grab its keys for the .env file. For SLACK_SIGNING_SECRET, navigate to its Basic Information page, App Credentials part. For SLACK_BOT_TOKEN, go to Install App page and install the app into your workspace. Once you do that, you will be able to get the value for this env variable. For NOTIFICATION_CHANNEL_ID, get channel ID from Slack workspace. If you cannot find it these links can be helpful.
6. Once your your .env file is updated, yarn start it once again.
7. Now go to your Slack workspace, type /drebedengi and hit enter.
8. To enabale bot messages to the notification channel you need to add your app user to it. You can do it by running /invite @yourBot slash command.

How to send reminder to fill place of storage

Use /drebedengi slash command like this:

/drebedengi remind @some_user