OperationCode Bot is a bot built to deal with the Slack Events API. When a subscribed event occurs:

• Slack sends a POST to this bot
• The bot processes the event and calls a method with the same name as the event passed in
• The event named method does whatever tasks are needed

It also handles interactive message button presses. When a button click clicked:

• Slack send us a POST with the buttom params
• The bot calls the process method on an instance of the callback_id of the button
• If @response is set we reply with the response and slack updates the message. This can be just text or a an entire message payload.

• Clone this repo

• Run

  $ bundle

• Run the tests with

  $ rake

Button Presses are called by as a class by way of the callback_id passed in from the slack API. To handle a new action define a new class in lib/button_press. The #process method must be defined. See the existing classes for more help.

To add a new item to the help menu simply create a new class in lib/help_menu. See existing help menu classes for more help. Then you'll just need to add the messages template with $CLASS_NAME_message.txt.erb in views/help_menu/.

To create a new event, within the operationcode_bot.rb file, simply define a new private method with the same name as the method you want to handle.

For example, if you wanted to write some code any time someone pins an item (the pin_added event) you would define a new method like so:

private

def pin_added(data, token: nil)
  logger.add "Got pin_added event with data: #{data}"
  empty_response
end

You can now write your business logic inside of this method. If your logic is complex (more than a 5-10 lines) I'd recommend using a ruby object. There is an Event class that can be inherited from to make your life a bit easier. See Event::TeamJoin as a reference.

Bug reports and pull requests are welcome on GitHub at https://github.com/OperationCode/operationcode_bot. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

The gem is available as open source under the terms of the MIT License.