Slack API updates 1/23/2017.

.travis.yml

@@ -4,12 +4,12 @@ cache: bundler
 
 matrix:
   include:
-    - rvm: 2.3.0
+    - rvm: 2.3.1
       script:
         - bundle exec danger
-    - rvm: 2.3.0
+    - rvm: 2.3.1
       env: CONCURRENCY=celluloid-io
-    - rvm: 2.3.0
+    - rvm: 2.3.1
       env: CONCURRENCY=faye-websocket
     - rvm: 2.2
     - rvm: 2.1

CHANGELOG.md

@@ -1,5 +1,9 @@
 ### 0.7.8 (Next)
 
+* [#127](https://github.com/slack-ruby/slack-ruby-client/pull/127): Added `thread_ts` and `reply_broadcast` options to `chat_postMessage` in Web API - [@dblock](https://github.com/dblock).
+* [#127](https://github.com/slack-ruby/slack-ruby-client/pull/127): Added `channels_replies`, `groups_replies` and `im_replies` to Web API - [@dblock](https://github.com/dblock).
+* [#127](https://github.com/slack-ruby/slack-ruby-client/pull/127): Added `goodbye` event to the RTM API - [@dblock](https://github.com/dblock).
+* [#127](https://github.com/slack-ruby/slack-ruby-client/pull/127): Added `before` to `team_accessLogs` - [@dblock](https://github.com/dblock).
 * [#108](https://github.com/slack-ruby/slack-ruby-client/pull/108): Use slack-ruby-danger gem - [@dblock](https://github.com/dblock).
 * [#116](https://github.com/slack-ruby/slack-ruby-client/pull/116): Use [slack-ruby/slack-api-ref](https://github.com/slack-ruby/slack-api-ref) as machine API reference - [@dblock](https://github.com/dblock).
 * [#116](https://github.com/slack-ruby/slack-ruby-client/pull/116): Added `users_setPhoto` and `users_deletePhoto` to Web API - [@dblock](https://github.com/dblock).
@@ -28,7 +32,7 @@
 
 ### 0.7.4 (5/28/2016)
 
-* [#93](https://github.com/slack-ruby/slack-ruby-client/pull/93): Fix: When using Celluloid concurrency, handle input from the TCP socket asynchronously from reading more. - [@benzrf](https://github.com/benzrf).
+* [#93](https://github.com/slack-ruby/slack-ruby-client/pull/93): Fix: When using Celluloid concurrency, handle input from the TCP socket asynchronously from reading more - [@benzrf](https://github.com/benzrf).
 * Added `auth_revoke` and `users_identity` to Web API - [@dblock](https://github.com/dblock).
 * Added `channel` parameter to `files_comments_add` Web API - [@dblock](https://github.com/dblock).
 
@@ -68,7 +72,7 @@
 
 * [#45](https://github.com/slack-ruby/slack-ruby-client/issues/45): Added `channels_id`, `groups_id` and `users_id` - [@dblock](https://github.com/dblock).
 * [#45](https://github.com/slack-ruby/slack-ruby-client/issues/45): Automatically lookup channel, group and user ID in Web API methods when Slack API doesn't accept #channel or @user names - [@dblock](https://github.com/dblock).
-* [#49](https://github.com/slack-ruby/slack-ruby-client/pull/49): Fix: Celluloid `#connected?` method. - [@mikz](https://github.com/mikz), [@kandadaboggu](https://github.com/kandadaboggu).
+* [#49](https://github.com/slack-ruby/slack-ruby-client/pull/49): Fix: Celluloid `#connected?` method - [@mikz](https://github.com/mikz), [@kandadaboggu](https://github.com/kandadaboggu).
 
 ### 0.5.3 (1/11/2016)
 

bin/commands/channels.rb

@@ -109,6 +109,16 @@
     end
   end
 
+  g.desc 'This method returns an entire thread (a message plus all the messages in reply to it).'
+  g.long_desc %( This method returns an entire thread (a message plus all the messages in reply to it). )
+  g.command 'replies' do |c|
+    c.flag 'channel', desc: 'Channel to fetch thread from.'
+    c.flag 'thread_ts', desc: "Unique identifier of a thread's parent message."
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.channels_replies(options))
+    end
+  end
+
   g.desc 'This method is used to change the purpose of a channel. The calling user must be a member of the channel.'
   g.long_desc %( This method is used to change the purpose of a channel. The calling user must be a member of the channel. )
   g.command 'setPurpose' do |c|

bin/commands/chat.rb

@@ -36,7 +36,9 @@
     c.flag 'username', desc: "Set your bot's user name. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below."
     c.flag 'as_user', desc: 'Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See authorship below.'
     c.flag 'icon_url', desc: 'URL to an image to use as the icon for this message. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.'
-    c.flag 'icon_emoji', desc: 'emoji to use as the icon for this message. Overrides icon_url. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.'
+    c.flag 'icon_emoji', desc: 'Emoji to use as the icon for this message. Overrides icon_url. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.'
+    c.flag 'thread_ts', desc: "Provide another message's ts value to make this message a reply. Avoid using a reply's ts value; use its parent instead."
+    c.flag 'reply_broadcast', desc: 'Used in conjunction with thread_ts and indicates whether reply should be made visible to everyone in the channel or conversation. Defaults to false.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.chat_postMessage(options))
     end

bin/commands/groups.rb

@@ -127,6 +127,16 @@
     end
   end
 
+  g.desc 'This method returns an entire thread (a message plus all the messages in reply to it).'
+  g.long_desc %( This method returns an entire thread (a message plus all the messages in reply to it). )
+  g.command 'replies' do |c|
+    c.flag 'channel', desc: 'Private channel to fetch thread from.'
+    c.flag 'thread_ts', desc: "Unique identifier of a thread's parent message."
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.groups_replies(options))
+    end
+  end
+
   g.desc 'This method is used to change the purpose of a private channel. The calling user must be a member of the private channel.'
   g.long_desc %( This method is used to change the purpose of a private channel. The calling user must be a member of the private channel. )
   g.command 'setPurpose' do |c|

bin/commands/im.rb

@@ -51,4 +51,14 @@
       puts JSON.dump($client.im_open(options))
     end
   end
+
+  g.desc 'This method returns an entire thread (a message plus all the messages in reply to it).'
+  g.long_desc %( This method returns an entire thread (a message plus all the messages in reply to it). )
+  g.command 'replies' do |c|
+    c.flag 'channel', desc: 'Direct message channel to fetch thread from.'
+    c.flag 'thread_ts', desc: "Unique identifier of a thread's parent message."
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.im_replies(options))
+    end
+  end
 end

bin/commands/mpim.rb

@@ -50,4 +50,14 @@
       puts JSON.dump($client.mpim_open(options))
     end
   end
+
+  g.desc 'This method returns an entire thread (a message plus all the messages in reply to it).'
+  g.long_desc %( This method returns an entire thread (a message plus all the messages in reply to it). )
+  g.command 'replies' do |c|
+    c.flag 'channel', desc: 'Multiparty direct message channel to fetch thread from.'
+    c.flag 'thread_ts', desc: "Unique identifier of a thread's parent message."
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.mpim_replies(options))
+    end
+  end
 end

bin/commands/team.rb

@@ -5,6 +5,7 @@
   g.desc 'This method is used to get the access logs for users on a team.'
   g.long_desc %( This method is used to get the access logs for users on a team. )
   g.command 'accessLogs' do |c|
+    c.flag 'before', desc: 'End of time range of logs to include in results (inclusive).'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.team_accessLogs(options))
     end

lib/slack/real_time/stores/starter.rb

@@ -14,6 +14,11 @@ def initialize(attrs)
 
         ### RealTime Events
 
+        # The server intends to close the connection soon..
+        # @see https://api.slack.com/events/goodbye
+        # @see https://github.com/dblock/slack-api-ref/blob/master/events/goodbye.json
+        # on :goodbye do |data|
+
         # Verifies ownership of an Events API Request URL.
         # @see https://api.slack.com/events/url_verification
         # @see https://github.com/dblock/slack-api-ref/blob/master/events/url_verification.json

lib/slack/real_time/stores/store.rb

@@ -54,6 +54,11 @@ def initialize(attrs)
 
         ### RealTime Events
 
+        # The server intends to close the connection soon..
+        # @see https://api.slack.com/events/goodbye
+        # @see https://github.com/dblock/slack-api-ref/blob/master/events/goodbye.json
+        # on :goodbye do |data|
+
         # Verifies ownership of an Events API Request URL.
         # @see https://api.slack.com/events/url_verification
         # @see https://github.com/dblock/slack-api-ref/blob/master/events/url_verification.json

lib/slack/web/api/endpoints/channels.rb

@@ -167,6 +167,22 @@ def channels_rename(options = {})
             post('channels.rename', options)
           end
 
+          #
+          # This method returns an entire thread (a message plus all the messages in reply to it).
+          #
+          # @option options [channel] :channel
+          #   Channel to fetch thread from.
+          # @option options [Object] :thread_ts
+          #   Unique identifier of a thread's parent message.
+          # @see https://api.slack.com/methods/channels.replies
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.replies.json
+          def channels_replies(options = {})
+            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            throw ArgumentError.new('Required arguments :thread_ts missing') if options[:thread_ts].nil?
+            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            post('channels.replies', options)
+          end
+
           #
           # This method is used to change the purpose of a channel. The calling user must be a member of the channel.
           #

lib/slack/web/api/endpoints/chat.rb

@@ -62,7 +62,11 @@ def chat_meMessage(options = {})
           # @option options [Object] :icon_url
           #   URL to an image to use as the icon for this message. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
           # @option options [Object] :icon_emoji
-          #   emoji to use as the icon for this message. Overrides icon_url. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
+          #   Emoji to use as the icon for this message. Overrides icon_url. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
+          # @option options [Object] :thread_ts
+          #   Provide another message's ts value to make this message a reply. Avoid using a reply's ts value; use its parent instead.
+          # @option options [Object] :reply_broadcast
+          #   Used in conjunction with thread_ts and indicates whether reply should be made visible to everyone in the channel or conversation. Defaults to false.
           # @see https://api.slack.com/methods/chat.postMessage
           # @see https://github.com/dblock/slack-api-ref/blob/master/methods/chat/chat.postMessage.json
           def chat_postMessage(options = {})

lib/slack/web/api/endpoints/groups.rb

@@ -196,6 +196,22 @@ def groups_rename(options = {})
             post('groups.rename', options)
           end
 
+          #
+          # This method returns an entire thread (a message plus all the messages in reply to it).
+          #
+          # @option options [group] :channel
+          #   Private channel to fetch thread from.
+          # @option options [Object] :thread_ts
+          #   Unique identifier of a thread's parent message.
+          # @see https://api.slack.com/methods/groups.replies
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.replies.json
+          def groups_replies(options = {})
+            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            throw ArgumentError.new('Required arguments :thread_ts missing') if options[:thread_ts].nil?
+            options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
+            post('groups.replies', options)
+          end
+
           #
           # This method is used to change the purpose of a private channel. The calling user must be a member of the private channel.
           #

lib/slack/web/api/endpoints/im.rb

@@ -80,6 +80,22 @@ def im_open(options = {})
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
             post('im.open', options)
           end
+
+          #
+          # This method returns an entire thread (a message plus all the messages in reply to it).
+          #
+          # @option options [im] :channel
+          #   Direct message channel to fetch thread from.
+          # @option options [Object] :thread_ts
+          #   Unique identifier of a thread's parent message.
+          # @see https://api.slack.com/methods/im.replies
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/im/im.replies.json
+          def im_replies(options = {})
+            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            throw ArgumentError.new('Required arguments :thread_ts missing') if options[:thread_ts].nil?
+            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            post('im.replies', options)
+          end
         end
       end
     end

lib/slack/web/api/endpoints/mpim.rb

@@ -77,6 +77,22 @@ def mpim_open(options = {})
             throw ArgumentError.new('Required arguments :users missing') if options[:users].nil?
             post('mpim.open', options)
           end
+
+          #
+          # This method returns an entire thread (a message plus all the messages in reply to it).
+          #
+          # @option options [channel] :channel
+          #   Multiparty direct message channel to fetch thread from.
+          # @option options [Object] :thread_ts
+          #   Unique identifier of a thread's parent message.
+          # @see https://api.slack.com/methods/mpim.replies
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/mpim/mpim.replies.json
+          def mpim_replies(options = {})
+            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            throw ArgumentError.new('Required arguments :thread_ts missing') if options[:thread_ts].nil?
+            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            post('mpim.replies', options)
+          end
         end
       end
     end

lib/slack/web/api/endpoints/team.rb

@@ -8,6 +8,8 @@ module Team
           #
           # This method is used to get the access logs for users on a team.
           #
+          # @option options [Object] :before
+          #   End of time range of logs to include in results (inclusive).
           # @see https://api.slack.com/methods/team.accessLogs
           # @see https://github.com/dblock/slack-api-ref/blob/master/methods/team/team.accessLogs.json
           def team_accessLogs(options = {})

spec/slack/web/api/endpoints/im_spec.rb

@@ -27,4 +27,12 @@
       expect { client.im_open }.to raise_error ArgumentError, /Required arguments :user missing/
     end
   end
+  context 'im_replies' do
+    it 'requires channel' do
+      expect { client.im_replies(thread_ts: '1234567890.123456') }.to raise_error ArgumentError, /Required arguments :channel missing/
+    end
+    it 'requires thread_ts' do
+      expect { client.im_replies(channel: 'C1234567890') }.to raise_error ArgumentError, /Required arguments :thread_ts missing/
+    end
+  end
 end

spec/slack/web/api/endpoints/mpim_spec.rb

@@ -27,4 +27,12 @@
       expect { client.mpim_open }.to raise_error ArgumentError, /Required arguments :users missing/
     end
   end
+  context 'mpim_replies' do
+    it 'requires channel' do
+      expect { client.mpim_replies(thread_ts: '1234567890.123456') }.to raise_error ArgumentError, /Required arguments :channel missing/
+    end
+    it 'requires thread_ts' do
+      expect { client.mpim_replies(channel: 'C1234567890') }.to raise_error ArgumentError, /Required arguments :thread_ts missing/
+    end
+  end
 end