Package net.dv8tion.jda.api.entities.channel.middleman

Interface GuildMessageChannel

All Superinterfaces:

Channel, Comparable<GuildChannel>, Formattable, GuildChannel, IMentionable, ISnowflake, MessageChannel

All Known Subinterfaces:

GuildMessageChannelUnion, NewsChannel, StageChannel, StandardGuildMessageChannel, TextChannel, ThreadChannel, VoiceChannel

public interface GuildMessageChannel
extends GuildChannel, MessageChannel

Represents all message channels present in guilds.

This includes channels that are not included in StandardGuildMessageChannel, such as ThreadChannel.

See Also:

• StandardGuildMessageChannel

Field Summary

Fields inherited from interface net.dv8tion.jda.api.entities.channel.Channel

MAX_NAME_LENGTH

Fields inherited from interface net.dv8tion.jda.api.entities.channel.middleman.GuildChannel

JUMP_URL

Method Summary

Modifier and Type	Method	Description
default boolean	canTalk()	Whether the currently logged in user can send messages in this channel or not.
boolean	canTalk(Member member)	Whether the specified Member can send messages in this channel.
default RestAction<Void>	clearReactionsById(long messageId)	Attempts to remove all reactions from a message with the specified messageId in this TextChannel This is useful for moderator commands that wish to remove all reactions at once from a specific message.
default RestAction<Void>	clearReactionsById(long messageId, Emoji emoji)	Removes all reactions for the specified emoji.
RestAction<Void>	clearReactionsById(String messageId)	Attempts to remove all reactions from a message with the specified messageId in this TextChannel This is useful for moderator commands that wish to remove all reactions at once from a specific message.
RestAction<Void>	clearReactionsById(String messageId, Emoji emoji)	Removes all reactions for the specified emoji.
default RestAction<Void>	deleteMessages(Collection<Message> messages)	Bulk deletes a list of messages.
RestAction<Void>	deleteMessagesByIds(Collection<String> messageIds)	Bulk deletes a list of messages.
default RestAction<Void>	removeReactionById(long messageId, Emoji emoji, User user)	Attempts to remove the reaction from a message represented by the specified messageId in this MessageChannel.
RestAction<Void>	removeReactionById(String messageId, Emoji emoji, User user)	Attempts to remove the reaction from a message represented by the specified messageId in this MessageChannel.
MessageCreateAction	sendStickers(Collection<? extends StickerSnowflake> stickers)	Send up to 3 stickers in this channel.
default MessageCreateAction	sendStickers(StickerSnowflake... stickers)	Send up to 3 stickers in this channel.

Methods inherited from interface net.dv8tion.jda.api.entities.channel.Channel

formatTo, getAsMention, getFlags, getJDA, getName, getType

Methods inherited from interface java.lang.Comparable

compareTo

Methods inherited from interface net.dv8tion.jda.api.entities.channel.middleman.GuildChannel

delete, getGuild, getJumpUrl, getManager, getPermissionContainer

Methods inherited from interface net.dv8tion.jda.api.entities.ISnowflake

getId, getIdLong, getTimeCreated

Methods inherited from interface net.dv8tion.jda.api.entities.channel.middleman.MessageChannel

addReactionById, addReactionById, deleteMessageById, deleteMessageById, editMessageAttachmentsById, editMessageAttachmentsById, editMessageAttachmentsById, editMessageAttachmentsById, editMessageById, editMessageById, editMessageById, editMessageById, editMessageComponentsById, editMessageComponentsById, editMessageComponentsById, editMessageComponentsById, editMessageEmbedsById, editMessageEmbedsById, editMessageEmbedsById, editMessageEmbedsById, editMessageFormatById, editMessageFormatById, getHistory, getHistoryAfter, getHistoryAfter, getHistoryAfter, getHistoryAround, getHistoryAround, getHistoryAround, getHistoryBefore, getHistoryBefore, getHistoryBefore, getHistoryFromBeginning, getIterableHistory, getLatestMessageId, getLatestMessageIdLong, pinMessageById, pinMessageById, purgeMessages, purgeMessages, purgeMessagesById, purgeMessagesById, purgeMessagesById, removeReactionById, removeReactionById, retrieveMessageById, retrieveMessageById, retrievePinnedMessages, retrieveReactionUsersById, retrieveReactionUsersById, sendFiles, sendFiles, sendMessage, sendMessage, sendMessageComponents, sendMessageComponents, sendMessageEmbeds, sendMessageEmbeds, sendMessageFormat, sendTyping, unpinMessageById, unpinMessageById

Method Details

canTalk

default boolean canTalk()

Description copied from interface: MessageChannel

Whether the currently logged in user can send messages in this channel or not.
For GuildMessageChannel this method checks for both Permission.VIEW_CHANNEL and Permission.MESSAGE_SEND.
For ThreadChannel this method checks for Permission.MESSAGE_SEND_IN_THREADS instead of Permission.MESSAGE_SEND.
For PrivateChannel this method checks if the user that this PrivateChannel communicates with is not a bot, but it does not check if the said user blocked the currently logged in user or have their DMs disabled.

Specified by:

canTalk in interface MessageChannel

Returns:

True, if we are able to read and send messages in this channel

canTalk

boolean canTalk(@Nonnull
 Member member)

Whether the specified Member can send messages in this channel.
Checks for both Permission.VIEW_CHANNEL and Permission.MESSAGE_SEND.

Parameters:

member - The Member to check

Returns:

True, if the specified member is able to read and send messages in this channel

removeReactionById

@Nonnull
@CheckReturnValue
RestAction<Void> removeReactionById(@Nonnull
 String messageId,
 @Nonnull
 Emoji emoji,
 @Nonnull
 User user)

Attempts to remove the reaction from a message represented by the specified messageId in this MessageChannel.

The following ErrorResponses are possible:

• MISSING_ACCESS
  The request was attempted after the account lost access to the Guild typically due to being kicked or removed, or after Permission.VIEW_CHANNEL was revoked in the TextChannel
  Also can happen if the account lost the Permission.MESSAGE_HISTORY
• MISSING_PERMISSIONS
  The request was attempted after the account lost Permission.MESSAGE_ADD_REACTION in the TextChannel.
• ErrorResponse.UNKNOWN_EMOJI
  The provided unicode character does not refer to a known emoji unicode character.
  Proper unicode characters for emojis can be found here: Emoji Table
• UNKNOWN_MESSAGE
  The provided messageId is unknown in this MessageChannel, either due to the id being invalid, or the message it referred to has already been deleted.
• UNKNOWN_CHANNEL
  The request was attempted after the channel was deleted.

Parameters:

messageId - The messageId to remove the reaction from

emoji - The emoji to remove

user - The target user of which to remove from

Returns:

RestAction

Throws:

IllegalArgumentException -

• If provided messageId is null or empty.
• If provided emoji is null.

InsufficientPermissionException - If the currently logged in account does not have Permission.MESSAGE_MANAGE in this channel.

removeReactionById

@Nonnull
@CheckReturnValue
default RestAction<Void> removeReactionById(long messageId,
 @Nonnull
 Emoji emoji,
 @Nonnull
 User user)

Attempts to remove the reaction from a message represented by the specified messageId in this MessageChannel.

The following ErrorResponses are possible:

• MISSING_ACCESS
  The request was attempted after the account lost access to the Guild typically due to being kicked or removed, or after Permission.VIEW_CHANNEL was revoked in the TextChannel
  Also can happen if the account lost the Permission.MESSAGE_HISTORY
• MISSING_PERMISSIONS
  The request was attempted after the account lost Permission.MESSAGE_ADD_REACTION in the TextChannel.
• ErrorResponse.UNKNOWN_EMOJI
  The provided unicode character does not refer to a known emoji unicode character.
  Proper unicode characters for emojis can be found here: Emoji Table
• UNKNOWN_MESSAGE
  The provided messageId is unknown in this MessageChannel, either due to the id being invalid, or the message it referred to has already been deleted.
• UNKNOWN_CHANNEL
  The request was attempted after the channel was deleted.

Parameters:

messageId - The messageId to remove the reaction from

emoji - The emoji to remove

user - The target user of which to remove from

Returns:

RestAction

Throws:

IllegalArgumentException -

• If provided messageId is null or empty.
• If provided emoji is null.

InsufficientPermissionException - If the currently logged in account does not have Permission.MESSAGE_MANAGE in this channel.

deleteMessages

@Nonnull
@CheckReturnValue
default RestAction<Void> deleteMessages(@Nonnull
 Collection<Message> messages)

Bulk deletes a list of messages. This is not the same as calling Message.delete() in a loop.
This is much more efficient, but it has a different ratelimit. You may call this once per second per Guild.

Must be at least 2 messages and not be more than 100 messages at a time.
If you only have 1 message, use the Message.delete() method instead.

You must have the Permission MESSAGE_MANAGE in this channel to use this function.

This method is best used when using MessageHistory to delete a large amount of messages. If you have a large amount of messages but only their message Ids, please use deleteMessagesByIds(Collection)

Possible ErrorResponses include:

• UNKNOWN_CHANNEL
  if this channel was deleted
• UNKNOWN_MESSAGE
  if any of the provided messages does not exist
• MISSING_ACCESS
  if we were removed from the guild
• MISSING_PERMISSIONS
  The send request was attempted after the account lost Permission.MESSAGE_MANAGE in the channel.

Parameters:

messages - The collection of messages to delete.

Returns:

AuditableRestAction

Throws:

IllegalArgumentException - If the size of the list less than 2 or more than 100 messages.

InsufficientPermissionException - If this account does not have Permission.MESSAGE_MANAGE

See Also:

• deleteMessagesByIds(Collection)
• MessageChannel.purgeMessages(List)

deleteMessagesByIds

@Nonnull
@CheckReturnValue
RestAction<Void> deleteMessagesByIds(@Nonnull
 Collection<String> messageIds)

Bulk deletes a list of messages. This is not the same as calling MessageChannel.deleteMessageById(String) in a loop.
This is much more efficient, but it has a different ratelimit. You may call this once per second per Guild.

Must be at least 2 messages and not be more than 100 messages at a time.
If you only have 1 message, use the Message.delete() method instead.

You must have Permission.MESSAGE_MANAGE in this channel to use this function.

This method is best used when you have a large amount of messages but only their message Ids. If you are using MessageHistory or have Message objects, it would be easier to use deleteMessages(java.util.Collection).

Possible ErrorResponses include:

• UNKNOWN_CHANNEL
  if this channel was deleted
• UNKNOWN_MESSAGE
  if any of the provided messages does not exist
• MISSING_ACCESS
  if we were removed from the guild
• MISSING_PERMISSIONS
  The send request was attempted after the account lost Permission.MESSAGE_MANAGE in the channel.

Parameters:

messageIds - The message ids for the messages to delete.

Returns:

AuditableRestAction

Throws:

IllegalArgumentException - If the size of the list less than 2 or more than 100 messages.

NumberFormatException - If any of the provided ids cannot be parsed by Long.parseLong(String)

InsufficientPermissionException - If this account does not have Permission.MESSAGE_MANAGE

See Also:

• deleteMessages(Collection)
• MessageChannel.purgeMessagesById(List)

clearReactionsById

@Nonnull
@CheckReturnValue
RestAction<Void> clearReactionsById(@Nonnull
 String messageId)

Attempts to remove all reactions from a message with the specified messageId in this TextChannel
This is useful for moderator commands that wish to remove all reactions at once from a specific message.

The following ErrorResponses are possible:

• MISSING_ACCESS
  The clear-reactions request was attempted after the account lost access to the TextChannel due to Permission.VIEW_CHANNEL being revoked, or the account lost access to the Guild typically due to being kicked or removed.
• MISSING_PERMISSIONS
  The clear-reactions request was attempted after the account lost Permission.MESSAGE_MANAGE in the TextChannel when adding the reaction.
• UNKNOWN_MESSAGE The clear-reactions request was attempted after the Message had been deleted.

Parameters:

messageId - The not-empty valid message id

Returns:

AuditableRestAction

Throws:

InsufficientPermissionException - If the currently logged in account does not have Permission.MESSAGE_MANAGE in this channel.

IllegalArgumentException - If the provided id is null or empty.

clearReactionsById

@Nonnull
@CheckReturnValue
default RestAction<Void> clearReactionsById(long messageId)

Attempts to remove all reactions from a message with the specified messageId in this TextChannel
This is useful for moderator commands that wish to remove all reactions at once from a specific message.

The following ErrorResponses are possible:

• MISSING_ACCESS
  The clear-reactions request was attempted after the account lost access to the TextChannel due to Permission.VIEW_CHANNEL being revoked, or the account lost access to the Guild typically due to being kicked or removed.
• MISSING_PERMISSIONS
  The clear-reactions request was attempted after the account lost Permission.MESSAGE_MANAGE in the TextChannel when adding the reaction.
• UNKNOWN_MESSAGE The clear-reactions request was attempted after the Message had been deleted.

Parameters:

messageId - The message id

Returns:

AuditableRestAction

Throws:

InsufficientPermissionException - If the currently logged in account does not have Permission.MESSAGE_MANAGE in this channel.

clearReactionsById

@Nonnull
@CheckReturnValue
RestAction<Void> clearReactionsById(@Nonnull
 String messageId,
 @Nonnull
 Emoji emoji)

Removes all reactions for the specified emoji.

The following ErrorResponses are possible:

• MISSING_ACCESS
  The currently logged in account lost access to the channel by either being removed from the guild or losing the VIEW_CHANNEL permission
• UNKNOWN_EMOJI
  The provided Emoji was deleted or doesn't exist.
• UNKNOWN_MESSAGE
  The message was deleted.

Parameters:

messageId - The id for the target message

emoji - The Emoji to remove reactions for

Returns:

RestAction

Throws:

InsufficientPermissionException - If the currently logged in account does not have Permission.MESSAGE_MANAGE in the channel

IllegalArgumentException - If provided with null

clearReactionsById

@Nonnull
@CheckReturnValue
default RestAction<Void> clearReactionsById(long messageId,
 @Nonnull
 Emoji emoji)

Removes all reactions for the specified emoji.

The following ErrorResponses are possible:

• MISSING_ACCESS
  The currently logged in account lost access to the channel by either being removed from the guild or losing the VIEW_CHANNEL permission
• UNKNOWN_EMOJI
  The provided Emoji was deleted or doesn't exist.
• UNKNOWN_MESSAGE
  The message was deleted.

Parameters:

messageId - The id for the target message

emoji - The Emoji to remove reactions for

Returns:

RestAction

Throws:

InsufficientPermissionException - If the currently logged in account does not have Permission.MESSAGE_MANAGE in the channel

IllegalArgumentException - If provided with null

sendStickers

@Nonnull
@CheckReturnValue
MessageCreateAction sendStickers(@Nonnull
 Collection<? extends StickerSnowflake> stickers)

Send up to 3 stickers in this channel.
Bots can only send GuildStickers from the same Guild. Bots cannot use StandardStickers.

Parameters:

stickers - Collection of 1-3 stickers to send

Returns:

MessageCreateAction

Throws:

MissingAccessException - If the currently logged in account does not have Permission.VIEW_CHANNEL in this channel

InsufficientPermissionException -

• If this is a ThreadChannel and the bot does not have Permission.MESSAGE_SEND_IN_THREADS
• If this is not a ThreadChannel and the bot does not have Permission.MESSAGE_SEND

IllegalArgumentException -

• If any of the provided stickers is a GuildSticker, which is either unavailable or from a different guild.
• If the list is empty or has more than 3 stickers
• If null is provided

See Also:

• Sticker.fromId(long)

sendStickers

@Nonnull
@CheckReturnValue
default MessageCreateAction sendStickers(@Nonnull
 StickerSnowflake... stickers)

Send up to 3 stickers in this channel.
Bots can only send GuildStickers from the same Guild. Bots cannot use StandardStickers.

Parameters:

stickers - The 1-3 stickers to send

Returns:

MessageCreateAction

Throws:

MissingAccessException - If the currently logged in account does not have Permission.VIEW_CHANNEL in this channel

InsufficientPermissionException -

• If this is a ThreadChannel and the bot does not have Permission.MESSAGE_SEND_IN_THREADS
• If this is not a ThreadChannel and the bot does not have Permission.MESSAGE_SEND

IllegalArgumentException -

• If any of the provided stickers is a GuildSticker, which is either unavailable or from a different guild.
• If the list is empty or has more than 3 stickers
• If null is provided

See Also:

• Sticker.fromId(long)