Create alerts from messages sent to a Slack channel
Branch: master
Clone or download

README.md

Slack to OpsGenie Alert Creator

Some of our customers want a way to create alerts from messages sent to a Slack channel. This is a sample Lambda function to help you achieve this.

It is an Outgoing WebHook application for Slack. Slack will post the messages sent to a channel to our API Gateway endpoint and we will create an alert in OpsGenie by using our AWS Lambda function.

Prerequisites

  • Install Node.js and npm

How to use

  • Clone or download the repository

  • In repository's folder run npm install command

  • Install serverless for easy deployment, it will deploy lambda function and create an API Gateway endpoint automatically

    • Run npm install -g serverless to install serverless globally
    • Update serverless.yml file by entering slackToken (received from Slack integration page) and opsgenieApiKey (received from OpsGenie Api Integration) environment variables
    • Follow these instructions on setting up AWS credentials for Serverless if you haven't done already
    • Run serverless deploy and all you want will be ready at a glance!
    • Copy the link from the command line (one in the orange square in the image below) or you can always find it in your AWS account's API Gateway service
    • Paste it to your Slack integration
    • You can always take it back by running serverless remove command

serverless-deploy.png

In Slack

custom-integration.png

  • Configure your Outgoing Webhook
    • Select a channel (optional)
    • Select a keyword (optional)
    • Paste the url received after deployment (Api Gateway URL)
    • Copy token and paste it to serverless.yml's slackToken field

slack-configuration.png

So you need more?

If you want to create a fully featured Slack application with slash commands, events, and interactive messages, you might want to look at https://github.com/johnagan/serverless-slack-app repository. It really does a lot for you!