[Ruby Meditation #22] Building Slack Apps with Ruby

Transcript

1. Building Slack Building Slack Apps with Apps with Ruby Ruby
2. Integrations Overview Integrations Overview Slash Commands Custom Integrations Bot Users Incoming Webhooks
3. Incoming webhooks Incoming webhooks A way to send messages to Slack https://slack.com/apps/A0F7XDUAZ-incoming-webhooks
4. Incoming webhooks Incoming webhooks require 'slack/incoming/webhooks' slack = Slack::Incoming::Webhooks.new( 'WEBHOOK_URL' ) slack.post 'Useful information' https://github.com/shoyan/slack-incoming-webhooks
5. Example Example
6. Slash commands Slash commands A way to add /slash commands Creating a new Slack App Command request authorization Command validation and response
7. Creating a Slack App Creating a Slack App https://api.slack.com/apps
8. Response Permission Response Permission
9. Adding a command Adding a command
10. Local HTTPS-Proxy Local HTTPS-Proxy ./ngrok http 9292
11. Response Sample Response Sample require 'sinatra' post '/' do 'OK' end
13. Legacy custom integrations Legacy custom integrations Custom integrations Custom integrations https://api.slack.com/custom-integrations/legacy-tokens
14. Bot users Bot users
15. Authentication Authentication
16. { "access_token": "xoxp-XXXXXXXX-XXXXXXXX-XXXXX", "scope": "commands,bot", "team_name": "Team Installing Your Bot", "team_id": "XXXXXXXXXX", "bot":{ "bot_user_id":"UTTTTTTTTTTR", "bot_access_token":"xoxb-XXXXXXXXXXXX-TTTTTTTTTTTTTT" } } Response Response
17. Tools Tools https://github.com/slack-ruby (not affiliated with Slack) slack-ruby-bot slack-ruby-bot Provides DSL for building text commands. slack-ruby-client slack-ruby-client A Ruby and command-line client for the Slack Web and Real Time Messaging APIs.
18. slack-ruby-bot slack-ruby-bot require 'slack-ruby-bot' class PongBot < SlackRubyBot::Bot command 'ping' do |client, data, match| client.say(text: 'pong', channel: data.channel) end end PongBot.run A Minimal Bot SLACK_API_TOKEN=... bundle exec ruby pongbot.rb
19. Slack Web API Slack Web API The Web API is a collection of , all with URLs in the form: HTTP RPC-style methods https://slack.com/api/FAMILY_METHOD.method
20. slack-ruby-client slack-ruby-client client = Slack::Web::Client.new( token: 'SLACK_BOT_TOKEN' ) client.chat_postMessage( channel: '#general', text: 'Hello World' ) https://api.slack.com/methods/chat.postMessage
21. Web API rate limit Web API rate limit https://api.slack.com/methods/chat.update
22. Interactive messages Interactive messages https://api.slack.com/interactive-messages
23. Message Formatting Message Formatting https://api.slack.com/docs/messages/builder
24. Walkie Bot Walkie Bot Prototyping Tool for Slack Bots https://github.com/FoundersAS/walkiebot
26. Slack RTM Slack RTM The Real Time Messaging API is a WebSocket-based API that allows you to receive from Slack in real time. events
27. rtm.connect rtm.connect Workspace https://api.slack.com/methods/rtm.connect wss://slack-msgs.com/websocket/uid These URLs are only valid for 30 seconds, so connect quickly!
28. client = Slack::RealTime::Client.new( token: 'SLACK_BOT_TOKEN' ) client.on :message do |data| client.message( channel: data.channel, text: "Hi <@#{data.user}>!" ) end client.start!
29. Ruby Websocket Clients Ruby Websocket Clients Faye::Websocket websocket-client-simple
30. Multiple connections Multiple connections Workspace 1 Workspace 2 Workspace N wss://slack-msgs.com/websocket/uid wss://slack-msgs.com/websocket/uid wss://slack-msgs.com/websocket/uid
31. Concurrent Processing Concurrent Processing eventmachine celluloid concurrent-ruby
32. slack-ruby-client slack-ruby-client Slack::RealTime.configure do |config| config.concurrency = Slack::RealTime::Concurrency::Celluloid # config.concurrency = Slack::RealTime::Concurrency::Eventmachine end
34. Alternatives Alternatives https://github.com/slackapi/node-slack-sdk https://github.com/BlakeWilliams/Elixir-Slack
36. Testing? Testing?
37. API Updates API Updates https://slack.com/apps/A0F81R7U7-rss
38. Community Community https://community.botkit.ai
39. Thanks! Thanks! kirillshevch kirillshevch @kirill_shevch @kirill_shevch @kirill_shevch @kirill_shevch