Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kn-lim/slackingway-bot
A personal Slack bot to handle miscellaneous tasks hosted on AWS Lambda
https://github.com/kn-lim/slackingway-bot
aws go golang lambda slack
Last synced: 15 days ago
JSON representation
A personal Slack bot to handle miscellaneous tasks hosted on AWS Lambda
- Host: GitHub
- URL: https://github.com/kn-lim/slackingway-bot
- Owner: kn-lim
- License: mit
- Created: 2024-10-07T09:10:25.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2024-10-20T23:45:18.000Z (18 days ago)
- Last Synced: 2024-10-22T09:52:34.966Z (17 days ago)
- Topics: aws, go, golang, lambda, slack
- Language: Go
- Homepage:
- Size: 324 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
I'm a 🤖!
# slackingway-bot
[](https://coveralls.io/github/kn-lim/slackingway-bot?branch=main)
[](https://goreportcard.com/report/github.com/kn-lim/slackingway-bot)
A personal Slack bot to handle miscellaneous tasks hosted on AWS Lambda.
## Packages Used
- [aws-lambda-go](https://github.com/aws/aws-lambda-go/)
- [aws-sdk-go-v2](https://github.com/aws/aws-sdk-go-v2)
- [mock](https://github.com/uber-go/mock)
- [slack-go](https://github.com/slack-go/slack)
- [testify](https://github.com/stretchr/testify)
# Using the Slack Bot
## How to Build
From the project home directory:
- **Endpoint Function**: `CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -tags lambda.norpc -o binary/bootstrap ./cmd/endpoint/`
- **Task Function**: `CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -tags lambda.norpc -o binary/bootstrap ./cmd/task/`
### Build Environment Variables
| Name | Description |
| - | - |
| `AWS_REGION` | AWS Region of the Task Lambda Function |
## Environment Variables
### Endpoint Lambda Function
#### AWS
| Name | Description |
| - | - |
| `TASK_FUNCTION_NAME` | Name of the Task Lambda Function |
#### Slack
| Name | Description |
| - | - |
| `SLACK_SIGNING_SECRET` | Slack App Signing Secret |
### Task Lambda Function
| Name | Description |
| - | - |
| `SLACK_HISTORY_CHANNEL_ID` | Slackingway's History Channel ID |
| `SLACK_OAUTH_TOKEN` | Slack App's OAuth Token |
## AWS Setup
1. Create an **endpoint** Lambda function on AWS.
- For the `Runtime`, select `Amazon Linux 2023`.
- For the `Architecture`, select `x86_64`.
2. Add an API Gateway triger to the **endpoint** Lambda function.
- Use the following settings:
- **Intent**: Create a new API
- **API type**: REST API
- **Security**: Open
3. Create a **task** Lambda function on AWS.
- For the `Runtime`, select `Provide your own bootstrap on Amazon Linux 2` under `Custom runtime`.
- For the `Architecture`, select `x86_64`.
4. Archive the `bootstrap` binary in a .zip file and upload it to the Lambda functions.
5. In the `Configuration` tab, add in the required environment variables to the Lambda functions.
6. Give the role the **endpoint** Lambda function is using permission to run the **task** Lambda function.
7. Give the role the **task** Lambda function is using permission to access the AWS resources it will need.
8. Change the `Timeout` of the **task** Lambda function to a value greater than 3 seconds.
- The `Timeout` of the **endpoint** Lambda function can stay as 3 seconds to follow Slack's requirements.
## Slack Setup
### Slash Commands
Get the **endpoint** Lambda API Gateway triggers's `API endpoint` and add it to the Slack apps's `Request URL` in each Slack Slash Command in the Slack API page.
### OAuth & Permissions
#### OAuth Tokens
Save the `Bot User OAuth Token` as the `SLACK_OAUTH_TOKEN` environment variable in the Task Lambda function.
#### Scopes
Enable the following `Bot Token Scopes`:
- `channels:history`
- `chat:write`
- `chat:write.customize`
- `commands`
- `im:history`
- `users.profile:read`
- `users:read`