Module: Slack::Web::Api::Endpoints::Users

Included in:

Slack::Web::Api::Endpoints

Defined in:

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

Instance Method Summary

• #users_getPresence(options = {}) ⇒ Object

  This method lets you find out information about a user’s presence.

• #users_identity(options = {}) ⇒ Object

  After your Slack app is awarded an identity token through Sign in with Slack, use this method to retrieve a user’s identity.

• #users_info(options = {}) ⇒ Object

  This method returns information about a team member.

• #users_list(options = {}) ⇒ Object

  This method returns a list of all users in the team.

• #users_setActive(options = {}) ⇒ Object

  This method lets the slack messaging server know that the authenticated user is currently active.

• #users_setPresence(options = {}) ⇒ Object

  This method lets you set the calling user’s manual presence.

Instance Method Details

#users_getPresence(options = {}) ⇒ Object

This method lets you find out information about a user’s presence. Consult the presence documentation for more details.

Parameters:

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

  a customizable set of options

Options Hash (options):

• :user (user) —

  User to get presence info on. Defaults to the authed user.

See Also:

• https://api.slack.com/methods/users.getPresence
• https://github.com/dblock/slack-api-ref/blob/master/methods/users/users.getPresence.json

# File 'lib/slack/web/api/endpoints/users.rb', line 16

def users_getPresence(options = {})
  throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
  options = options.merge(user: users_id(options)['user']['id']) if options[:user]
  post('users.getPresence', options)
end

#users_identity(options = {}) ⇒ Object

After your Slack app is awarded an identity token through Sign in with Slack, use this method to retrieve a user’s identity.

See Also:

• https://api.slack.com/methods/users.identity
• https://github.com/dblock/slack-api-ref/blob/master/methods/users/users.identity.json

# File 'lib/slack/web/api/endpoints/users.rb', line 27

def users_identity(options = {})
  post('users.identity', options)
end

#users_info(options = {}) ⇒ Object

This method returns information about a team member.

Parameters:

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

  a customizable set of options

Options Hash (options):

• :user (user) —

  User to get info on.

See Also:

• https://api.slack.com/methods/users.info
• https://github.com/dblock/slack-api-ref/blob/master/methods/users/users.info.json

# File 'lib/slack/web/api/endpoints/users.rb', line 38

def users_info(options = {})
  throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
  options = options.merge(user: users_id(options)['user']['id']) if options[:user]
  post('users.info', options)
end

#users_list(options = {}) ⇒ Object

This method returns a list of all users in the team. This includes deleted/deactivated users.

Parameters:

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

  a customizable set of options

Options Hash (options):

• :presence (Object) —

  Whether to include presence data in the output.

See Also:

• https://api.slack.com/methods/users.list
• https://github.com/dblock/slack-api-ref/blob/master/methods/users/users.list.json

# File 'lib/slack/web/api/endpoints/users.rb', line 51

def users_list(options = {})
  post('users.list', options)
end

#users_setActive(options = {}) ⇒ Object

This method lets the slack messaging server know that the authenticated user is currently active. Consult the presence documentation for more details.

See Also:

• https://api.slack.com/methods/users.setActive
• https://github.com/dblock/slack-api-ref/blob/master/methods/users/users.setActive.json

# File 'lib/slack/web/api/endpoints/users.rb', line 62

def users_setActive(options = {})
  post('users.setActive', options)
end

#users_setPresence(options = {}) ⇒ Object

This method lets you set the calling user’s manual presence. Consult the presence documentation for more details.

Parameters:

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

  a customizable set of options

Options Hash (options):

• :presence (Object) —

  Either auto or away.

See Also:

• https://api.slack.com/methods/users.setPresence
• https://github.com/dblock/slack-api-ref/blob/master/methods/users/users.setPresence.json

# File 'lib/slack/web/api/endpoints/users.rb', line 74

def users_setPresence(options = {})
  throw ArgumentError.new('Required arguments :presence missing') if options[:presence].nil?
  post('users.setPresence', options)
end