slackingway-bot

I'm a 🤖!

slackingway-bot

A personal Slack bot to handle miscellaneous tasks hosted on AWS Lambda.

Packages Used

• aws-lambda-go
• aws-sdk-go-v2
• chattingway
• mock
• slack-go
• testify

Using the Slack Bot

Slack Slash Commands

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/

Zip the bootstrap binaries and upload it to the Lambda functions.

Environment Variables

Endpoint Lambda Function

Task Lambda Function

AWS Setup

To quickly spin up slackingway-bot on AWS, use the Terraform module.

1. Create the 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 the task Lambda function on AWS.
   • For the Runtime, select Amazon Linux 2023.
   • For the Architecture, select x86_64.
4. Build the endpoint and task binaries.
5. Archive the bootstrap binaries in .zip files and upload it to the Lambda functions.
6. In the Configuration tab, add in the required environment variables to the Lambda functions.
7. 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

Event Subscriptions

Enable Events

Get the endpoint Lambda API Gateway triggers's API endpoint and add it to the Slack apps's Request URL. It should be verified after a second.

Subscribe to Bot Events

Add the following bot user events:

• app_home_opened