slack-ruby-client 0.9.0 → 0.11.0

data/lib/slack/web/api/endpoints/apps_permissions.rb

@@ -0,0 +1,35 @@
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AppsPermissions
+          #
+          # Returns list of permissions this app has on a team.
+          #
+          # @see https://api.slack.com/methods/apps.permissions.info
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.permissions/apps.permissions.info.json
+          def apps_permissions_info(options = {})
+            post('apps.permissions.info', options)
+          end
+
+          #
+          # Allows an app to request additional scopes
+          #
+          # @option options [Object] :scopes
+          #   A comma separated list of scopes to request for.
+          # @option options [Object] :trigger_id
+          #   Token used to trigger the permissions API.
+          # @see https://api.slack.com/methods/apps.permissions.request
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.permissions/apps.permissions.request.json
+          def apps_permissions_request(options = {})
+            throw ArgumentError.new('Required arguments :scopes missing') if options[:scopes].nil?
+            throw ArgumentError.new('Required arguments :trigger_id missing') if options[:trigger_id].nil?
+            post('apps.permissions.request', options)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/slack/web/api/endpoints/auth.rb

@@ -6,21 +6,21 @@ module Slack
       module Endpoints
         module Auth
           #
-          # This method revokes an access token. Use it when you no longer need a token. For example, with a Sign In With Slack app, call this to log a user out.
+          # Revokes a token.
           #
           # @option options [Object] :test
           #   Setting this parameter to 1 triggers a testing mode where the specified token will not actually be revoked.
           # @see https://api.slack.com/methods/auth.revoke
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/auth/auth.revoke.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/auth/auth.revoke.json
           def auth_revoke(options = {})
             post('auth.revoke', options)
           end
 
           #
-          # This method checks authentication and tells you who you are.
+          # Checks authentication & identity.
           #
           # @see https://api.slack.com/methods/auth.test
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/auth/auth.test.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/auth/auth.test.json
           def auth_test(options = {})
             post('auth.test', options)
           end

data/lib/slack/web/api/endpoints/bots.rb

@@ -6,12 +6,12 @@ module Slack
       module Endpoints
         module Bots
           #
-          # This method returns information about a bot user.
+          # Gets information about a bot user.
           #
           # @option options [Object] :bot
           #   Bot user to get info on.
           # @see https://api.slack.com/methods/bots.info
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/bots/bots.info.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/bots/bots.info.json
           def bots_info(options = {})
             post('bots.info', options)
           end

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

@@ -6,12 +6,12 @@ module Slack
       module Endpoints
         module Channels
           #
-          # This method archives a channel.
+          # Archives a channel.
           #
           # @option options [channel] :channel
           #   Channel to archive.
           # @see https://api.slack.com/methods/channels.archive
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.archive.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.archive.json
           def channels_archive(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
@@ -19,34 +19,46 @@ module Slack
           end
 
           #
-          # This method is used to create a channel.
+          # Creates a channel.
           #
           # @option options [Object] :name
           #   Name of channel to create.
           # @option options [Object] :validate
           #   Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.
           # @see https://api.slack.com/methods/channels.create
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.create.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.create.json
           def channels_create(options = {})
             throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
             post('channels.create', options)
           end
 
           #
-          # This method returns a portion of message events from the specified channel.
+          # Delete a channel (undocumented)
+          #
+          # @option options [channel] :channel
+          #   Channel to delete.
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/undocumented/channels/channels.delete.json
+          def channels_delete(options = {})
+            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            post('channels.delete', options)
+          end
+
+          #
+          # Fetches history of messages and events from a channel.
           #
           # @option options [channel] :channel
           #   Channel to fetch history for.
+          # @option options [Object] :inclusive
+          #   Include messages with latest or oldest timestamp in results.
           # @option options [timestamp] :latest
           #   End of time range of messages to include in results.
           # @option options [timestamp] :oldest
           #   Start of time range of messages to include in results.
-          # @option options [Object] :inclusive
-          #   Include messages with latest or oldest timestamp in results.
           # @option options [Object] :unreads
           #   Include unread_count_display in the output?.
           # @see https://api.slack.com/methods/channels.history
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.history.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.history.json
           def channels_history(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
@@ -54,12 +66,14 @@ module Slack
           end
 
           #
-          # This method returns information about a team channel.
+          # Gets information about a channel.
           #
           # @option options [channel] :channel
           #   Channel to get info on.
+          # @option options [Object] :include_locale
+          #   Set this to true to receive the locale for this channel. Defaults to false.
           # @see https://api.slack.com/methods/channels.info
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.info.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.info.json
           def channels_info(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
@@ -67,14 +81,14 @@ module Slack
           end
 
           #
-          # This method is used to invite a user to a channel. The calling user must be a member of the channel.
+          # Invites a user to a channel.
           #
           # @option options [channel] :channel
           #   Channel to invite user to.
           # @option options [user] :user
           #   User to invite to channel.
           # @see https://api.slack.com/methods/channels.invite
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.invite.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.invite.json
           def channels_invite(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
@@ -84,29 +98,28 @@ module Slack
           end
 
           #
-          # This method is used to join a channel. If the channel does not exist, it is
-          # created.
+          # Joins a channel, creating it if needed.
           #
           # @option options [Object] :name
           #   Name of channel to join.
           # @option options [Object] :validate
           #   Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.
           # @see https://api.slack.com/methods/channels.join
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.join.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.join.json
           def channels_join(options = {})
             throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
             post('channels.join', options)
           end
 
           #
-          # This method allows a user to remove another member from a team channel.
+          # Removes a user from a channel.
           #
           # @option options [channel] :channel
           #   Channel to remove user from.
           # @option options [user] :user
           #   User to remove from channel.
           # @see https://api.slack.com/methods/channels.kick
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.kick.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.kick.json
           def channels_kick(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
@@ -116,12 +129,12 @@ module Slack
           end
 
           #
-          # This method is used to leave a channel.
+          # Leaves a channel.
           #
           # @option options [channel] :channel
           #   Channel to leave.
           # @see https://api.slack.com/methods/channels.leave
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.leave.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.leave.json
           def channels_leave(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
@@ -129,27 +142,37 @@ module Slack
           end
 
           #
-          # This method returns a list of all channels in the team. This includes channels the caller is in, channels they are not currently in, and archived channels but does not include private channels. The number of (non-deactivated) members in each channel is also returned.
+          # Lists all channels in a Slack team.
           #
+          # @option options [Object] :cursor
+          #   Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first "page" of the collection. See pagination for more detail.
           # @option options [Object] :exclude_archived
           #   Exclude archived channels from the list.
           # @option options [Object] :exclude_members
           #   Exclude the members collection from each channel.
+          # @option options [Object] :limit
+          #   The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the users list hasn't been reached.
           # @see https://api.slack.com/methods/channels.list
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.list.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.list.json
           def channels_list(options = {})
-            post('channels.list', options)
+            if block_given?
+              Pagination::Cursor.new(self, :channels_list, options).each do |page|
+                yield page
+              end
+            else
+              post('channels.list', options)
+            end
           end
 
           #
-          # This method moves the read cursor in a channel.
+          # Sets the read cursor in a channel.
           #
           # @option options [channel] :channel
           #   Channel to set reading cursor in.
           # @option options [timestamp] :ts
           #   Timestamp of the most recently seen message.
           # @see https://api.slack.com/methods/channels.mark
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.mark.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.mark.json
           def channels_mark(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
@@ -158,7 +181,7 @@ module Slack
           end
 
           #
-          # This method renames a team channel.
+          # Renames a channel.
           #
           # @option options [channel] :channel
           #   Channel to rename.
@@ -167,7 +190,7 @@ module Slack
           # @option options [Object] :validate
           #   Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.
           # @see https://api.slack.com/methods/channels.rename
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.rename.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.rename.json
           def channels_rename(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
@@ -176,14 +199,14 @@ module Slack
           end
 
           #
-          # This method returns an entire thread (a message plus all the messages in reply to it).
+          # Retrieve a thread of messages posted to a channel
           #
           # @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
+          # @see https://github.com/slack-ruby/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?
@@ -192,14 +215,14 @@ module Slack
           end
 
           #
-          # This method is used to change the purpose of a channel. The calling user must be a member of the channel.
+          # Sets the purpose for a channel.
           #
           # @option options [channel] :channel
           #   Channel to set the purpose of.
           # @option options [Object] :purpose
           #   The new purpose.
           # @see https://api.slack.com/methods/channels.setPurpose
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.setPurpose.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.setPurpose.json
           def channels_setPurpose(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :purpose missing') if options[:purpose].nil?
@@ -208,14 +231,14 @@ module Slack
           end
 
           #
-          # This method is used to change the topic of a channel. The calling user must be a member of the channel.
+          # Sets the topic for a channel.
           #
           # @option options [channel] :channel
           #   Channel to set the topic of.
           # @option options [Object] :topic
           #   The new topic.
           # @see https://api.slack.com/methods/channels.setTopic
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.setTopic.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.setTopic.json
           def channels_setTopic(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :topic missing') if options[:topic].nil?
@@ -224,12 +247,12 @@ module Slack
           end
 
           #
-          # This method unarchives a channel. The calling user is added to the channel.
+          # Unarchives a channel.
           #
           # @option options [channel] :channel
           #   Channel to unarchive.
           # @see https://api.slack.com/methods/channels.unarchive
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.unarchive.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.unarchive.json
           def channels_unarchive(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]

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

@@ -6,32 +6,65 @@ module Slack
       module Endpoints
         module Chat
           #
-          # This method deletes a message from a channel.
+          # Execute a slash command in a public channel (undocumented)
+          #
+          # @option options [channel] :channel
+          #   Channel to execute the command in.
+          # @option options [Object] :command
+          #   Slash command to be executed. Leading backslash is required.
+          # @option options [Object] :text
+          #   Additional parameters provided to the slash command.
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/undocumented/chat/chat.command.json
+          def chat_command(options = {})
+            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            throw ArgumentError.new('Required arguments :command missing') if options[:command].nil?
+            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            post('chat.command', options)
+          end
+
+          #
+          # Deletes a message.
           #
-          # @option options [timestamp] :ts
-          #   Timestamp of the message to be deleted.
           # @option options [channel] :channel
           #   Channel containing the message to be deleted.
+          # @option options [timestamp] :ts
+          #   Timestamp of the message to be deleted.
           # @option options [Object] :as_user
-          #   Pass true to delete the message as the authed user. Bot users in this context are considered authed users.
+          #   Pass true to delete the message as the authed user with chat:write:user scope. Bot users in this context are considered authed users. If unused or false, the message will be deleted with chat:write:bot scope.
           # @see https://api.slack.com/methods/chat.delete
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/chat/chat.delete.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.delete.json
           def chat_delete(options = {})
-            throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
             post('chat.delete', options)
           end
 
           #
-          # This method sends a me message to a channel from the calling user.
+          # Retrieve a permalink URL for a specific extant message
+          #
+          # @option options [channel] :channel
+          #   The ID of the conversation or channel containing the message.
+          # @option options [Object] :message_ts
+          #   A message's ts value, uniquely identifying it within a channel.
+          # @see https://api.slack.com/methods/chat.getPermalink
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.getPermalink.json
+          def chat_getPermalink(options = {})
+            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            throw ArgumentError.new('Required arguments :message_ts missing') if options[:message_ts].nil?
+            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            post('chat.getPermalink', options)
+          end
+
+          #
+          # Share a me message into a channel.
           #
           # @option options [channel] :channel
           #   Channel to send message to. Can be a public channel, private group or IM channel. Can be an encoded ID, or a name.
           # @option options [Object] :text
           #   Text of the message to send.
           # @see https://api.slack.com/methods/chat.meMessage
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/chat/chat.meMessage.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.meMessage.json
           def chat_meMessage(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :text missing') if options[:text].nil?
@@ -39,36 +72,69 @@ module Slack
           end
 
           #
-          # This method posts a message to a public channel, private channel, or direct message/IM channel.
+          # Sends an ephemeral message to a user in a channel.
           #
           # @option options [channel] :channel
-          #   Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name. See below for more details.
+          #   Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name.
           # @option options [Object] :text
           #   Text of the message to send. See below for an explanation of formatting. This field is usually required, unless you're providing only attachments instead.
+          # @option options [user] :user
+          #   id of the user who will receive the ephemeral message. The user should be in the channel specified by the channel argument.
+          # @option options [Object] :as_user
+          #   Pass true to post the message as the authed bot. Defaults to false.
+          # @option options [Object] :attachments
+          #   A JSON-based array of structured attachments, presented as a URL-encoded string.
+          # @option options [Object] :link_names
+          #   Find and link channel names and usernames.
           # @option options [Object] :parse
           #   Change how messages are treated. Defaults to none. See below.
+          # @see https://api.slack.com/methods/chat.postEphemeral
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.postEphemeral.json
+          def chat_postEphemeral(options = {})
+            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            throw ArgumentError.new('Required arguments :text missing') if options[:text].nil?
+            throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
+            options = options.merge(user: users_id(options)['user']['id']) if options[:user]
+            # attachments must be passed as an encoded JSON string
+            if options.key?(:attachments)
+              attachments = options[:attachments]
+              attachments = JSON.dump(attachments) unless attachments.is_a?(String)
+              options = options.merge(attachments: attachments)
+            end
+            post('chat.postEphemeral', options)
+          end
+
+          #
+          # Sends a message to a channel.
+          #
+          # @option options [channel] :channel
+          #   Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name. See below for more details.
+          # @option options [Object] :text
+          #   Text of the message to send. See below for an explanation of formatting. This field is usually required, unless you're providing only attachments instead.
+          # @option options [Object] :as_user
+          #   Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See authorship below.
+          # @option options [Object] :attachments
+          #   A JSON-based array of structured attachments, presented as a URL-encoded string.
+          # @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.
+          # @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] :link_names
           #   Find and link channel names and usernames.
-          # @option options [Object] :attachments
-          #   Structured message attachments.
+          # @option options [Object] :parse
+          #   Change how messages are treated. Defaults to none. See below.
+          # @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.
+          # @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] :unfurl_links
           #   Pass true to enable unfurling of primarily text-based content.
           # @option options [Object] :unfurl_media
           #   Pass false to disable unfurling of media content.
           # @option options [Object] :username
           #   Set your bot's user name. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
-          # @option options [Object] :as_user
-          #   Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See authorship below.
-          # @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.
-          # @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
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.postMessage.json
           def chat_postMessage(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :text or :attachments missing') if options[:text].nil? && options[:attachments].nil?
@@ -82,18 +148,22 @@ module Slack
           end
 
           #
-          # This method attaches Slack app unfurl behavior to a specified and relevant message. A user token is required as this method does not support bot user tokens.
+          # Provide custom unfurl behavior for user-posted URLs
           #
           # @option options [channel] :channel
           #   Channel ID of the message.
           # @option options [timestamp] :ts
           #   Timestamp of the message to add unfurl behavior to.
           # @option options [Object] :unfurls
-          #   JSON mapping a set of URLs from the message to their unfurl attachments.
+          #   URL-encoded JSON map with keys set to URLs featured in the the message, pointing to their unfurl message attachments.
+          # @option options [Object] :user_auth_message
+          #   Provide a simply-formatted string to send as an ephemeral message to the user as invitation to authenticate further and enable full unfurling behavior.
           # @option options [Object] :user_auth_required
           #   Set to true or 1 to indicate the user must install your Slack app to trigger unfurls for this domain.
+          # @option options [Object] :user_auth_url
+          #   Send users to this custom URL where they will complete authentication in your app to fully trigger unfurling. Value should be properly URL-encoded.
           # @see https://api.slack.com/methods/chat.unfurl
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/chat/chat.unfurl.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.unfurl.json
           def chat_unfurl(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
@@ -103,28 +173,28 @@ module Slack
           end
 
           #
-          # This method updates a message in a channel. Though related to chat.postMessage, some parameters of chat.update are handled differently.
+          # Updates a message.
           #
-          # @option options [timestamp] :ts
-          #   Timestamp of the message to be updated.
           # @option options [channel] :channel
           #   Channel containing the message to be updated.
           # @option options [Object] :text
-          #   New text for the message, using the default formatting rules.
+          #   New text for the message, using the default formatting rules. It's not required when presenting attachments.
+          # @option options [timestamp] :ts
+          #   Timestamp of the message to be updated.
+          # @option options [Object] :as_user
+          #   Pass true to update the message as the authed user. Bot users in this context are considered authed users.
           # @option options [Object] :attachments
-          #   Structured message attachments.
-          # @option options [Object] :parse
-          #   Change how messages are treated. Defaults to client, unlike chat.postMessage. See below.
+          #   A JSON-based array of structured attachments, presented as a URL-encoded string. This field is required when not presenting text.
           # @option options [Object] :link_names
           #   Find and link channel names and usernames. Defaults to none. This parameter should be used in conjunction with parse. To set link_names to 1, specify a parse mode of full.
-          # @option options [Object] :as_user
-          #   Pass true to update the message as the authed user. Bot users in this context are considered authed users.
+          # @option options [Object] :parse
+          #   Change how messages are treated. Defaults to client, unlike chat.postMessage. See below.
           # @see https://api.slack.com/methods/chat.update
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/chat/chat.update.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.update.json
           def chat_update(options = {})
-            throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :text or :attachments missing') if options[:text].nil? && options[:attachments].nil?
+            throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
             # attachments must be passed as an encoded JSON string
             if options.key?(:attachments)