Module: Slack::Endpoint::Reactions

Included in:

Slack::Endpoint

Defined in:

lib/slack/endpoint/reactions.rb

Instance Method Summary

• #reactions_add(options = {}) ⇒ Object

  This method adds a reaction (emoji) to an item (file, file comment, channel message, group message, or direct message).

• #reactions_get(options = {}) ⇒ Object

  This method returns a list of all reactions for a single item (file, file comment, channel message, group message, or direct message).

• #reactions_list(options = {}) ⇒ Object

  This method returns a list of all items (file, file comment, channel message, group message, or direct message) reacted to by a user.

• #reactions_remove(options = {}) ⇒ Object

  This method removes a reaction (emoji) from an item (file, file comment, channel message, group message, or direct message).

Instance Method Details

#reactions_add(options = {}) ⇒ Object

This method adds a reaction (emoji) to an item (file, file comment, channel message, group message, or direct message). One of file, file_comment, or the combination of channel and timestamp must be specified.

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :name (Object) —

  Reaction (emoji) name.

• :file (Object) —

  File to add reaction to.

• :file_comment (Object) —

  File comment to add reaction to.

• :channel (Object) —

  Channel where the message to add reaction to was posted.

• :timestamp (Object) —

  Timestamp of the message to add reaction to.

See Also:

• https://api.slack.com/methods/reactions.add
• https://github.com/aki017/slack-api-docs/blob/master/methods/reactions.add.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/reactions.add.json

# File 'lib/slack/endpoint/reactions.rb', line 23

def reactions_add(options={})
  throw ArgumentError.new("Required arguments :name missing") if options[:name].nil?
  post("reactions.add", options)
end

#reactions_get(options = {}) ⇒ Object

This method returns a list of all reactions for a single item (file, file comment, channel message, group message, or direct message).

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :file (Object) —

  File to get reactions for.

• :file_comment (Object) —

  File comment to get reactions for.

• :channel (Object) —

  Channel where the message to get reactions for was posted.

• :timestamp (Object) —

  Timestamp of the message to get reactions for.

• :full (Object) —

  If true always return the complete reaction list.

See Also:

• https://api.slack.com/methods/reactions.get
• https://github.com/aki017/slack-api-docs/blob/master/methods/reactions.get.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/reactions.get.json

# File 'lib/slack/endpoint/reactions.rb', line 44

def reactions_get(options={})
  post("reactions.get", options)
end

#reactions_list(options = {}) ⇒ Object

This method returns a list of all items (file, file comment, channel message, group message, or direct message) reacted to by a user.

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :user (Object) —

  Show reactions made by this user. Defaults to the authed user.

• :full (Object) —

  If true always return the complete reaction list.

• :count (Object) —

  Number of items to return per page.

• :page (Object) —

  Page number of results to return.

See Also:

• https://api.slack.com/methods/reactions.list
• https://github.com/aki017/slack-api-docs/blob/master/methods/reactions.list.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/reactions.list.json

# File 'lib/slack/endpoint/reactions.rb', line 62

def reactions_list(options={})
  post("reactions.list", options)
end

#reactions_remove(options = {}) ⇒ Object

This method removes a reaction (emoji) from an item (file, file comment, channel message, group message, or direct message). One of file, file_comment, or the combination of channel and timestamp must be specified.

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :name (Object) —

  Reaction (emoji) name.

• :file (Object) —

  File to remove reaction from.

• :file_comment (Object) —

  File comment to remove reaction from.

• :channel (Object) —

  Channel where the message to remove reaction from was posted.

• :timestamp (Object) —

  Timestamp of the message to remove reaction from.

See Also:

• https://api.slack.com/methods/reactions.remove
• https://github.com/aki017/slack-api-docs/blob/master/methods/reactions.remove.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/reactions.remove.json

# File 'lib/slack/endpoint/reactions.rb', line 83

def reactions_remove(options={})
  throw ArgumentError.new("Required arguments :name missing") if options[:name].nil?
  post("reactions.remove", options)
end