Skip to main content

Discord

Connector for Discord — read and send messages, manage channels and threads, react to and pin messages, browse servers and members, administer roles and permissions, moderate with kicks and bans, and manage invites, webhooks, and emojis.

Categories: Team Collaboration, Communication, Community

What you can ask​

  • Summarize the last 24 hours of messages in the #support channel
  • Post the weekly release notes to #announcements and pin the message
  • Open a thread on a bug report message and add the on-call engineer to it

Set up​

Discord connects with credentials from your Discord account. Have these values ready:

  • Bot token
  1. Go to Organization > Connectors and find Discord.
  2. Click Enable and choose which tools to allow.
  3. Each member enters their own values the first time they use it.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

Tools​

Discord offers 67 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (29)​

View and search information without changing it.

ToolWhat it does
get_audit_logRead a server's audit log to see who performed moderation and configuration actions.
get_banCheck whether one user is banned from a server, and read the recorded reason.
get_channelFetch one channel or thread by ID, including its permission overwrites and, for forum channels, the available_tags needed by create_thread.
get_current_userFetch the account the credential authenticates as, which for a bot token is the bot itself.
get_guildFetch one server's settings by ID.
get_guild_memberFetch one member's server profile: nickname, roles, join date, and timeout state.
get_inviteLook up an invite by its code to see which server and channel it leads to.
get_messageFetch one message by ID, including its reaction tallies.
get_roleFetch one role by ID, with its permissions decoded into names.
get_userFetch a user's global Discord account by ID.
list_active_threadsList every thread in a server that is not archived, across all channels.
list_archived_threadsList archived threads under a channel, most recently archived first.
list_bansList a server's bans, each with the banned user and the reason recorded.
list_channel_invitesList the active invites pointing at one channel.
list_channel_webhooksList the webhooks configured on a channel, including each one's token.
list_guild_channelsList every channel and category in a server.
list_guild_emojisList a server's custom emojis.
list_guild_invitesList every active invite for a server, with use counts and expiry.
list_guild_membersList a server's members in ID order.
list_guildsList the servers the bot has been added to.
list_messagesRead a channel's or thread's message history, newest first.
list_permissionsList every Discord permission name, with its bit and what it allows.
list_pinsList a channel's pinned messages, most recently pinned first.
list_reactionsList the users who reacted to a message with a given emoji.
list_rolesList a server's roles, each with its permissions decoded into names.
list_thread_membersList the users who have joined a thread.
search_guild_membersFind server members whose username or nickname starts with a string.
search_messagesSearch a server's messages by content, channel, author, mentions, or attachment type.
validate_credentialValidate the Discord bot token by fetching the bot's own account.

Write (16)​

Create or send data.

ToolWhat it does
add_member_roleGive a member one role, leaving their other roles alone.
add_thread_memberAdd a user to a thread.
create_channel_inviteCreate an invite link to a channel.
create_dmOpen a direct message channel with a user, or return the existing one.
create_guild_channelCreate a channel in a server.
create_messagePost a message to a channel, thread, or DM channel.
create_reactionReact to a message as the bot.
create_roleCreate a role in a server.
create_threadOpen a thread in a text channel, or a post in a forum or media channel.
create_thread_from_messageStart a thread attached to an existing message, so the thread appears under it.
create_webhookCreate a webhook on a channel so an external system can post to it without a bot token.
crosspost_messagePublish a message from an announcement channel to every server following it.
execute_webhookPost a message through a webhook, optionally under a custom name and avatar.
follow_announcement_channelFollow an announcement channel so its published messages are crossposted into one of your own channels.
pin_messagePin a message in its channel.
trigger_typingShow the bot's typing indicator in a channel for about 10 seconds.

Delete or overwrite (22)​

Remove or replace existing data.

ToolWhat it does
bulk_delete_messagesDelete 2 to 100 messages from a guild channel in one call.
create_banBan a user from a server, optionally deleting their recent messages.
delete_all_reactionsClear reactions from a message.
delete_channelDelete a channel, or delete a thread.
delete_channel_permissionRemove a role's or member's permission override from a channel, so they fall back to the category and server defaults.
delete_inviteRevoke an invite so it can no longer be used.
delete_messagePermanently delete one message.
delete_own_reactionRemove the bot's own reaction from a message.
delete_roleDelete a role from a server.
delete_user_reactionRemove one specific user's reaction from a message.
delete_webhookDelete a webhook, immediately breaking anything posting through it.
modify_current_memberChange the bot's own nickname or bio in a server.
remove_banLift a server ban so the user can be invited back.
remove_guild_memberKick a member from a server.
remove_member_roleTake one role away from a member, leaving their other roles alone.
remove_thread_memberRemove a user from a thread.
set_channel_permissionsSet a role's or member's permission override on a channel, using permission names rather than raw bitfields.
unpin_messageRemove a message from its channel's pins.
update_channelModify a channel or thread: rename it, change its topic, slowmode, category, or voice settings, or archive and lock a thread.
update_guild_memberChange a member's nickname, roles, voice state, or timeout.
update_messageEdit a message the bot itself sent.
update_roleModify a role's name, colour, or permissions.
⌘J