+ This function first verifies that the request actually came from
+ Slack, (by means of the SLACK_SIGNING_SECRET SSM parameter), and
+ refuses to do anything if not.
+
+ Then this defers to either turbot_event_handler or
+ turbot_slash_command to do any real work.
+ """
+
+ headers = requests.structures.CaseInsensitiveDict(event['headers'])
+
+ signature = headers['X-Slack-Signature']
+ timestamp = headers['X-Slack-Request-Timestamp']
+
+ if not slack_is_valid_request(signature, timestamp, event['body']):
+ return error("Invalid Slack signature")
+
+ # It's a bit cheesy, but we'll just use the content-type header to
+ # determine if we're being called from a Slack event or from a
+ # slash command or other interactivity. (The more typical way to
+ # do this would be to have different URLs for each Slack entry
+ # point, but it's simpler to have our Slack app implemented as a
+ # single AWS Lambda, (which can only have a single entry point).
+ content_type = headers['content-type']
+
+ if (content_type == "application/json"):
+ return turbot_event_handler(turb, event, context)
+ if (content_type == "application/x-www-form-urlencoded"):
+ return turbot_interactive_or_slash_command(turb, event, context)
+ return error("Unknown content-type: {}".format(content_type))
+
+def turbot_event_handler(turb, event, context):
+ """Handler for all subscribed Slack events"""
+
+ body = json.loads(event['body'])
+
+ type = body['type']
+
+ if type == 'url_verification':
+ return url_verification_handler(turb, body)
+ if type == 'event_callback':
+ return event_callback_handler(turb, body)
+ return error("Unknown event type: {}".format(type))
+
+def url_verification_handler(turb, body):
+
+ # First, we have to properly respond to url_verification
+ # challenges or else Slack won't let us configure our URL as an
+ # event handler.
+ challenge = body['challenge']
+
+ return {
+ 'statusCode': 200,
+ 'body': challenge
+ }
+
+def event_callback_handler(turb, body):
+ event = body['event']
+ type = event['type']
+
+ if type in turbot.events.events:
+ return turbot.events.events[type](turb, event)
+ return error("Unknown event type: {}".format(type))
+
+def turbot_interactive_or_slash_command(turb, event, context):
+ """Handler for Slack interactive things (buttons, shortcuts, etc.)
+ as well as slash commands.
+
+ This function simply makes a quick determination of what we're looking
+ at and then defers to either turbot_interactive or turbot_slash_command."""
+
+ # Both interactives and slash commands have a urlencoded body
+ body = parse_qs(event['body'])
+
+ # The difference is that an interactive thingy has a 'payload'
+ # while a slash command has a 'command'
+ if 'payload' in body:
+ return turbot_interactive(turb, json.loads(body['payload'][0]))
+ if 'command' in body:
+ return turbot_slash_command(turb, body)
+ return error("Unrecognized event (neither interactive nor slash command)")
+
+def turbot_interactive(turb, payload):
+ """Handler for Slack interactive requests
+
+ These are the things that come from a user interacting with a button
+ a shortcut or some other interactive element that our app has made
+ available to the user."""
+
+ type = payload['type']
+
+ if type == 'block_actions':
+ return turbot_block_action(turb, payload)
+ if type == 'view_submission':
+ return turbot.interaction.view_submission(turb, payload)
+ if type == 'shortcut':
+ return turbot_shortcut(turb, payload)
+ return error("Unrecognized interactive type: {}".format(type))
+
+def turbot_block_action(turb, payload):
+ """Handler for Slack interactive block actions
+
+ Specifically, those that have a payload type of 'block_actions'"""
+
+ actions = payload['actions']
+
+ if len(actions) != 1:
+ return error("No support for multiple actions ({}) in a single request"
+ .format(len(actions)))
+
+ action = actions[0]
+
+ atype = action['type']
+ if 'value' in action:
+ avalue = action['value']
+ else:
+ avalue = '*'
+
+ if (
+ atype in turbot.interaction.actions
+ and avalue in turbot.interaction.actions[atype]
+ ):
+ return turbot.interaction.actions[atype][avalue](turb, payload)
+ return error("Unknown action of type/value: {}/{}".format(atype, avalue))
+
+def turbot_shortcut(turb, payload):
+ """Handler for Slack shortcuts
+
+ These are invoked as either global or message shortcuts by a user."""
+
+ print("In turbot_shortcut, payload is: {}".format(str(payload)))
+
+ return error("Shortcut interactions not yet implemented")
+
+def turbot_slash_command(turb, body):
+ """Implementation for Slack slash commands.
+
+ This parses the request and arguments and farms out to
+ supporting functions to implement all supported slash commands.
+ """
+
+ command = body['command'][0]
+ if 'text' in body:
+ args = body['text'][0]
+ else:
+ args = ''
+
+ if command in turbot.interaction.commands:
+ return turbot.interaction.commands[command](turb, body, args)