Module: Slack::Web::Api::Endpoints::Mpim

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

Instance Method Summary collapse

Instance Method Details

#mpim_close(options = {}) ⇒ Object

Closes a multiparty direct message channel.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :channel (channel) —

    MPIM to close.

See Also:



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

def mpim_close(options = {})
  throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
  options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
  logger.warn('mpim.close: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.close.')
  post('mpim.close', options)
end

#mpim_history(options = {}) ⇒ Object

Fetches history of messages and events from a multiparty direct message.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :channel (channel) —

    Multiparty direct message to fetch history for.

  • :inclusive (Object) —

    Include messages with latest or oldest timestamp in results.

  • :latest (timestamp) —

    End of time range of messages to include in results.

  • :oldest (timestamp) —

    Start of time range of messages to include in results.

  • :unreads (Object) —

    Include unread_count_display in the output?.

See Also:



38
39
40
41
42
43
 
# File 'lib/slack/web/api/endpoints/mpim.rb', line 38

def mpim_history(options = {})
  throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
  options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
  logger.warn('mpim.history: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.history.')
  post('mpim.history', options)
end

#mpim_list(options = {}) ⇒ Object

Lists multiparty direct message channels for the calling user.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :cursor (Object) —

    Parameter for pagination. Set cursor equal to the next_cursor attribute returned by the previous request’s response_metadata. This parameter is optional, but pagination is mandatory: the default value simply fetches the first “page” of the collection. See pagination for more details.

  • :limit (Object) —

    The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn’t been reached.

See Also:



54
55
56
57
58
59
60
61
62
63
 
# File 'lib/slack/web/api/endpoints/mpim.rb', line 54

def mpim_list(options = {})
  logger.warn('mpim.list: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.list, users.conversations.')
  if block_given?
    Pagination::Cursor.new(self, :mpim_list, options).each do |page|
      yield page
    end
  else
    post('mpim.list', options)
  end
end

#mpim_mark(options = {}) ⇒ Object

Sets the read cursor in a multiparty direct message channel.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :channel (channel) —

    multiparty direct message channel to set reading cursor in.

  • :ts (timestamp) —

    Timestamp of the most recently seen message.

See Also:



74
75
76
77
78
79
80
 
# File 'lib/slack/web/api/endpoints/mpim.rb', line 74

def mpim_mark(options = {})
  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: conversations_id(options)['channel']['id']) if options[:channel]
  logger.warn('mpim.mark: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: .')
  post('mpim.mark', options)
end

#mpim_open(options = {}) ⇒ Object

This method opens a multiparty direct message.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :users (Object) —

    Comma separated lists of users. The ordering of the users is preserved whenever a MPIM group is returned.

See Also:



89
90
91
92
93
 
# File 'lib/slack/web/api/endpoints/mpim.rb', line 89

def mpim_open(options = {})
  throw ArgumentError.new('Required arguments :users missing') if options[:users].nil?
  logger.warn('mpim.open: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.open.')
  post('mpim.open', options)
end

#mpim_replies(options = {}) ⇒ Object

Retrieve a thread of messages posted to a direct message conversation from a multiparty direct message.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :channel (channel) —

    Multiparty direct message channel to fetch thread from.

  • :thread_ts (Object) —

    Unique identifier of a thread’s parent message.

See Also:



104
105
106
107
108
109
110
 
# File 'lib/slack/web/api/endpoints/mpim.rb', line 104

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: conversations_id(options)['channel']['id']) if options[:channel]
  logger.warn('mpim.replies: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.replies.')
  post('mpim.replies', options)
end