module Slack::Endpoint::Conversations
Public Instance Methods
Archives a conversation.
@option options [Object] :channel
ID of conversation to archive
@see api.slack.com/methods/conversations.archive @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.archive.md @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.archive.json
# File lib/slack/endpoint/conversations.rb, line 14 def conversations_archive(options={}) throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil? post("conversations.archive", options) end
Closes a direct message or multi-person direct message.
@option options [Object] :channel
Conversation to close.
@see api.slack.com/methods/conversations.close @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.close.md @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.close.json
# File lib/slack/endpoint/conversations.rb, line 27 def conversations_close(options={}) throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil? post("conversations.close", options) end
Initiates a public or private channel-based conversation
@option options [Object] :name
Name of the public or private channel to create
@option options [Object] :is_private
Create a private channel instead of a public one
@see api.slack.com/methods/conversations.create @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.create.md @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.create.json
# File lib/slack/endpoint/conversations.rb, line 42 def conversations_create(options={}) throw ArgumentError.new("Required arguments :name missing") if options[:name].nil? post("conversations.create", options) end
Fetches a conversation's history of messages and events.
@option options [Object] :channel
Conversation ID to fetch history for.
@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] :inclusive
Include messages with latest or oldest timestamp in results only when either timestamp is specified.
@option options [Object] :latest
End of time range of messages to include in results.
@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.
@option options [Object] :oldest
Start of time range of messages to include in results.
@see api.slack.com/methods/conversations.history @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.history.md @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.history.json
# File lib/slack/endpoint/conversations.rb, line 65 def conversations_history(options={}) throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil? post("conversations.history", options) end
Retrieve information about a conversation.
@option options [Object] :channel
Conversation ID to learn more about
@option options [Object] :include_locale
Set this to true to receive the locale for this conversation. Defaults to false
@see api.slack.com/methods/conversations.info @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.info.md @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.info.json
# File lib/slack/endpoint/conversations.rb, line 80 def conversations_info(options={}) throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil? post("conversations.info", options) end
Invites users to a channel.
@option options [Object] :channel
The ID of the public or private channel to invite user(s) to.
@option options [Object] :users
A comma separated list of user IDs. Up to 30 users may be listed.
@see api.slack.com/methods/conversations.invite @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.invite.md @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.invite.json
# File lib/slack/endpoint/conversations.rb, line 95 def conversations_invite(options={}) throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil? throw ArgumentError.new("Required arguments :users missing") if options[:users].nil? post("conversations.invite", options) end
Joins an existing conversation.
@option options [Object] :channel
ID of conversation to join
@see api.slack.com/methods/conversations.join @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.join.md @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.join.json
# File lib/slack/endpoint/conversations.rb, line 109 def conversations_join(options={}) throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil? post("conversations.join", options) end
Removes a user from a conversation.
@option options [Object] :channel
ID of conversation to remove user from.
@option options [Object] :user
User ID to be removed.
@see api.slack.com/methods/conversations.kick @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.kick.md @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.kick.json
# File lib/slack/endpoint/conversations.rb, line 124 def conversations_kick(options={}) throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil? throw ArgumentError.new("Required arguments :user missing") if options[:user].nil? post("conversations.kick", options) end
Leaves a conversation.
@option options [Object] :channel
Conversation to leave
@see api.slack.com/methods/conversations.leave @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.leave.md @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.leave.json
# File lib/slack/endpoint/conversations.rb, line 138 def conversations_leave(options={}) throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil? post("conversations.leave", options) end
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
Set to true to exclude archived channels from the list
@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 list hasn't been reached. Must be an integer no larger than 1000.
@option options [Object] :types
Mix and match channel types by providing a comma-separated list of any combination of public_channel, private_channel, mpim, im
@see api.slack.com/methods/conversations.list @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.list.md @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.list.json
# File lib/slack/endpoint/conversations.rb, line 157 def conversations_list(options={}) post("conversations.list", options) end
Retrieve members of a conversation.
@option options [Object] :channel
ID of the conversation to retrieve members for
@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] :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 api.slack.com/methods/conversations.members @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.members.md @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.members.json
# File lib/slack/endpoint/conversations.rb, line 173 def conversations_members(options={}) throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil? post("conversations.members", options) end
Opens or resumes a direct message or multi-person direct message.
@option options [Object] :channel
Resume a conversation by supplying an im or mpim's ID. Or provide the users field instead.
@option options [Object] :return_im
Boolean, indicates you want the full IM channel definition in the response.
@option options [Object] :users
Comma separated lists of users. If only one user is included, this creates a 1:1 DM. The ordering of the users is preserved whenever a multi-person direct message is returned. Supply a channel when not supplying users.
@see api.slack.com/methods/conversations.open @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.open.md @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.open.json
# File lib/slack/endpoint/conversations.rb, line 190 def conversations_open(options={}) post("conversations.open", options) end
Renames a conversation.
@option options [Object] :channel
ID of conversation to rename
@option options [Object] :name
New name for conversation.
@see api.slack.com/methods/conversations.rename @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.rename.md @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.rename.json
# File lib/slack/endpoint/conversations.rb, line 204 def conversations_rename(options={}) throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil? throw ArgumentError.new("Required arguments :name missing") if options[:name].nil? post("conversations.rename", options) end
Retrieve a thread of messages posted to a conversation
@option options [Object] :channel
Conversation ID to fetch thread from.
@option options [Object] :ts
Unique identifier of a thread's parent message.
@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] :inclusive
Include messages with latest or oldest timestamp in results only when either timestamp is specified.
@option options [Object] :latest
End of time range of messages to include in results.
@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.
@option options [Object] :oldest
Start of time range of messages to include in results.
@see api.slack.com/methods/conversations.replies @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.replies.md @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.replies.json
# File lib/slack/endpoint/conversations.rb, line 230 def conversations_replies(options={}) throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil? throw ArgumentError.new("Required arguments :ts missing") if options[:ts].nil? post("conversations.replies", options) end
Sets the purpose for a conversation.
@option options [Object] :channel
Conversation to set the purpose of
@option options [Object] :purpose
A new, specialer purpose
@see api.slack.com/methods/conversations.setPurpose @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.setPurpose.md @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.setPurpose.json
# File lib/slack/endpoint/conversations.rb, line 246 def conversations_setPurpose(options={}) throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil? throw ArgumentError.new("Required arguments :purpose missing") if options[:purpose].nil? post("conversations.setPurpose", options) end
Sets the topic for a conversation.
@option options [Object] :channel
Conversation to set the topic of
@option options [Object] :topic
The new topic string. Does not support formatting or linkification.
@see api.slack.com/methods/conversations.setTopic @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.setTopic.md @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.setTopic.json
# File lib/slack/endpoint/conversations.rb, line 262 def conversations_setTopic(options={}) throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil? throw ArgumentError.new("Required arguments :topic missing") if options[:topic].nil? post("conversations.setTopic", options) end
Reverses conversation archival.
@option options [Object] :channel
ID of conversation to unarchive
@see api.slack.com/methods/conversations.unarchive @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.unarchive.md @see github.com/aki017/slack-api-docs/blob/master/methods/conversations.unarchive.json
# File lib/slack/endpoint/conversations.rb, line 276 def conversations_unarchive(options={}) throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil? post("conversations.unarchive", options) end