AWS Chatbot Custom Notification

This project demonstrates how to customize and send a custom notification message from AWS Step function to slack via AWS Chatbot.

Prerequisite

• Configure AWS CLI and configured it with your credentials
• Should have an AWS account and have set up your AWS credentials
• Go to AWS Chatbot(https://console.aws.amazon.com/chatbot/) and perform OAuth to configure a slack workspace. Kindly follow this instructions in step 1

Setup

Clone this repo:

git clone https://github.com/pajaydev/aws-chatbot-custom-notifications-example.git

Build this app using below commands:

npm install -g aws-cdk
npm install
npm run build

Configure environment variables - Replace .env file in this project with slack workspace Id and channel Id

Deployment

Synthesize the CloudFormation template using below command:

cdk synth

Deploy the stack using below command:

cdk deploy

Trigger a Notification

Trigger the deployed step function using below command

./scripts/trigger-step-function.sh

Result

Clean Up

To clean up, issue this command:

cdk destroy

Troubleshooting

Kindly create an issue if you face any issues

Useful commands

• npm run build compile typescript to js
• npm run watch watch for changes and compile
• npm run test perform the jest unit tests
• cdk deploy deploy this stack to your default AWS account/region
• cdk diff compare deployed stack with current state
• cdk synth emits the synthesized CloudFormation template