Module: Slack::Web::Api::Endpoints::Im

Included in:
Slack::Web::Api::Endpoints
Defined in:
lib/slack/web/api/endpoints/im.rb

Instance Method Summary collapse

Instance Method Details

#im_close(options = {}) ⇒ Object

Close a direct message channel.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :channel (im) —

    Direct message channel to close.

See Also:



16
17
18
19
 
# File 'lib/slack/web/api/endpoints/im.rb', line 16

def im_close(options = {})
  throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
  post('im.close', options)
end

#im_history(options = {}) ⇒ Object

Fetches history of messages and events from direct message channel.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :channel (im) —

    Direct message channel to fetch history for.

  • :latest (timestamp) —

    Latest message timestamp to include in results.

  • :oldest (timestamp) —

    Oldest message timestamp to include in results.

  • :count (Object) —

    Number of messages to return, between 1 and 1000.

See Also:



35
36
37
38
 
# File 'lib/slack/web/api/endpoints/im.rb', line 35

def im_history(options = {})
  throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
  post('im.history', options)
end

#im_list(options = {}) ⇒ Object

Lists direct message channels for the calling user.

See Also:



46
47
48
 
# File 'lib/slack/web/api/endpoints/im.rb', line 46

def im_list(options = {})
  post('im.list', options)
end

#im_mark(options = {}) ⇒ Object

Sets the read cursor in a direct message channel.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :channel (im) —

    Direct message channel to set reading cursor in.

  • :ts (timestamp) —

    Timestamp of the most recently seen message.

See Also:



60
61
62
63
64
 
# File 'lib/slack/web/api/endpoints/im.rb', line 60

def im_mark(options = {})
  throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
  throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
  post('im.mark', options)
end

#im_open(options = {}) ⇒ Object

Opens a direct message channel.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :user (user) —

    User to open a direct message channel with.

See Also:



74
75
76
77
 
# File 'lib/slack/web/api/endpoints/im.rb', line 74

def im_open(options = {})
  throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
  post('im.open', options)
end