Tutorial: Using AWS Chatbot to run an AWS Lambda function remotely

Sign in to the AWS Management Console and open the Lambda console at console.aws.amazon.com/lambda.

Choose Create function.

Choose Author From Scratch.

In Function Name, enter: myHelloWorld

Choose Create Function.

Copy and paste the following example code into index.js.

export const handler = async (event) => {
  // TODO implement
  const response = 'Hello World!'
  return response;
};
   };

Choose Deploy.

Choose Test.

In Event Name, enter: myHelloWorld

Choose Save.

Choose Test and then verify that the Execution results tab displays Response: "Hello World!"

Open the Amazon SNS console.

In the left navigation pane, choose Topics.

Choose Create Topic.

Create a topic with the following settings:

1. Type – Standard

2. Name – myHelloWorldNotifications

3. Display name – myHelloWorld

Choose Create topic.

Choose Create subscription.

Create a subscription with the following settings:

1. Protocol – Email

2. Endpoint – Your email address

Confirm subscription to the SNS by checking your email and choosing the link.

Open the CloudWatch console.

Choose Alarms.

Choose Create alarm.

Choose Select metric.

Choose Lambda.

Choose By Function Name.

Choose myHelloWorld errors.

Change the following settings:

1. Period – 1 minute

2. Whenever Errors is Greater than 0

3. Send notifications to – myHelloWorldNotifications

4. Alarm name – myHelloWorld-alarm

5. Alarm description – Lambda myHelloWorld alarm

Choose Create alarm.

Open the AWS Chatbot console.

Under Configure a Chat client choose Slack, and then choose Configure.

In the upper right corner, choose the dropdown list, and then choose the Slack workspace that you want to use with AWS Chatbot.

Choose Allow.

Choose Configure new channel.

Under Configuration details, for Name, enter myHelloWorld.

Under Channel type, choose Private.

1. Navigate to Slack and create a private channel by choosing the + button to the right of Channels.

2. Choose Create a channel.

3. Name the channel myHelloWorld.

4. Choose to make the channel private.

5. Choose Create.

6. When prompted to add people, choose x.

7. Navigate back to the AWS Chatbot console and enter the private channel ID.

Define the IAM permissions that the chatbot uses for messaging your Slack chat room as shown following:

1. For Role name, enter myHelloWorldRole.

2. For Policy Templates, select Read-only command permissions and Lambda-invoke command permissions.

In the SNS topics section, choose the appropriate AWS Region under Region.

Under Topics, select the myHelloWorldNotifcations topic.

Choose Configure.

Invite AWS Chatbot to your channel by doing the following in Slack:

1. Enter @AWS.

2. Choose Invite to Channel.

   Tip

   You only have to invite AWS Chatbot to the channel once.

   If AWS is not listed as a valid member of the channel, you need to add the AWS Chatbot app to the Slack workspace. For more information, see the Getting started guide for AWS Chatbot.

Enter the following command in Slack:

@aws lambda invoke --function-name myHelloWorld --region <your region>

@aws invoke myHelloWorld --region <your region>

Choose Yes.

The following output is shown:

ExecutedVersion: $LATEST
Payload: \"Hello World\"
StatusCode: 200

Open the Lambda console Functions page.

Choose myHelloWorld.

Copy and paste the following example code into the Lambda function code:

exports.handler = async (event) => {
    throw new Error('this is an error');
}; 

Choose Deploy and confirm your changes have been deployed by viewing the label next to the Deploy button.

Return to your Slack channel and then enter the following command:

@aws invoke myHelloWorld

An error appears in your output, and you receive a CloudWatch alarm notification in Slack and an email. It might take a few minutes for you to receive the notifications.

To view logs, choose Show logs or Show error logs.

Open the Lambda console.

Choose myHelloWordFunction.

Choose Actions and then choose delete.

Open the CloudWatch console.

In the left navigation pane, choose Insufficient.

Choose myHelloWorld-alarm by selecting the check box.

Choose Actions and then choose delete.

Open the AWS Chatbot console.

Choose Slack.

Choose the radio button next to the channel you created and then choose Delete.