Reference code for running a Slack chatbot using AWS Lambda and Amazon API Gateway.
Python JavaScript
Switch branches/tags
Nothing to show
Clone or download
Latest commit 74f1f79 Aug 10, 2016
Permalink
Failed to load latest commit information.
javascript Initial Commit of Bots Aug 9, 2016
python Adding requirements.txt Aug 9, 2016
LICENSE Initial commit Aug 5, 2016
README.md Updated title in README Aug 10, 2016

README.md

AWS Serverless Chatbot Sample

Example code for running a Slack chatbot using AWS Lambda and Amazon API Gateway.

Getting Started

  1. Create your Lambda function that will process all Slack Requests
  2. Create an API Gateway API
  3. Create a method of type: POST
  4. Select Integration Type: Lambda
  5. Select the region in which you created your Lambda function
  6. Select the Lambda Function you created
  7. Click "Integration Request"
  8. At the bottom of this Page select "Add mapping Template"
  9. For content type please specify: "application/x-www-form-urlencoded"
  10. Insert the template code below into the text field for the template. This code converts a URL Encoded form post into JSON for your Lambda function to parse
  11. Deploy your API
  12. In Slack, Go to Apps and Integrations
  13. Click Build in the top right
  14. Select Make a Custom Integration
  15. Select Outgoing Webhooks
  16. Pick a trigger word for your Bot!
  17. In URL, put the URL created by your API Gateway Deployment

Template code for Integration Request:

## convert HTML POST data or HTTP GET query string to JSON
 
## get the raw post data from the AWS built-in variable and give it a nicer name
#if ($context.httpMethod == "POST")
 #set($rawAPIData = $input.path('$'))
#elseif ($context.httpMethod == "GET")
 #set($rawAPIData = $input.params().querystring)
 #set($rawAPIData = $rawAPIData.toString())
 #set($rawAPIDataLength = $rawAPIData.length() - 1)
 #set($rawAPIData = $rawAPIData.substring(1, $rawAPIDataLength))
 #set($rawAPIData = $rawAPIData.replace(", ", "&"))
#else
 #set($rawAPIData = "")
#end
 
## first we get the number of "&" in the string, this tells us if there is more than one key value pair
#set($countAmpersands = $rawAPIData.length() - $rawAPIData.replace("&", "").length())
 
## if there are no "&" at all then we have only one key value pair.
## we append an ampersand to the string so that we can tokenise it the same way as multiple kv pairs.
## the "empty" kv pair to the right of the ampersand will be ignored anyway.
#if ($countAmpersands == 0)
 #set($rawPostData = $rawAPIData + "&")
#end
 
## now we tokenise using the ampersand(s)
#set($tokenisedAmpersand = $rawAPIData.split("&"))
 
## we set up a variable to hold the valid key value pairs
#set($tokenisedEquals = [])
 
## now we set up a loop to find the valid key value pairs, which must contain only one "="
#foreach( $kvPair in $tokenisedAmpersand )
 #set($countEquals = $kvPair.length() - $kvPair.replace("=", "").length())
 #if ($countEquals == 1)
  #set($kvTokenised = $kvPair.split("="))
  #if ($kvTokenised[0].length() > 0)
   ## we found a valid key value pair. add it to the list.
   #set($devNull = $tokenisedEquals.add($kvPair))
  #end
 #end
#end
 
## next we set up our loop inside the output structure "{" and "}"
{
#foreach( $kvPair in $tokenisedEquals )
  ## finally we output the JSON for this pair and append a comma if this isn't the last pair
  #set($kvTokenised = $kvPair.split("="))
 "$util.urlDecode($kvTokenised[0])" : #if($kvTokenised[1].length() > 0)"$util.urlDecode($kvTokenised[1])"#{else}""#end#if( $foreach.hasNext ),#end
#end
}