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
#supportchannel - Post the weekly release notes to
#announcementsand 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
- Go to Organization > Connectors and find Discord.
- Click Enable and choose which tools to allow.
- 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.
| Tool | What it does |
|---|---|
get_audit_log | Read a server's audit log to see who performed moderation and configuration actions. |
get_ban | Check whether one user is banned from a server, and read the recorded reason. |
get_channel | Fetch one channel or thread by ID, including its permission overwrites and, for forum channels, the available_tags needed by create_thread. |
get_current_user | Fetch the account the credential authenticates as, which for a bot token is the bot itself. |
get_guild | Fetch one server's settings by ID. |
get_guild_member | Fetch one member's server profile: nickname, roles, join date, and timeout state. |
get_invite | Look up an invite by its code to see which server and channel it leads to. |
get_message | Fetch one message by ID, including its reaction tallies. |
get_role | Fetch one role by ID, with its permissions decoded into names. |
get_user | Fetch a user's global Discord account by ID. |
list_active_threads | List every thread in a server that is not archived, across all channels. |
list_archived_threads | List archived threads under a channel, most recently archived first. |
list_bans | List a server's bans, each with the banned user and the reason recorded. |
list_channel_invites | List the active invites pointing at one channel. |
list_channel_webhooks | List the webhooks configured on a channel, including each one's token. |
list_guild_channels | List every channel and category in a server. |
list_guild_emojis | List a server's custom emojis. |
list_guild_invites | List every active invite for a server, with use counts and expiry. |
list_guild_members | List a server's members in ID order. |
list_guilds | List the servers the bot has been added to. |
list_messages | Read a channel's or thread's message history, newest first. |
list_permissions | List every Discord permission name, with its bit and what it allows. |
list_pins | List a channel's pinned messages, most recently pinned first. |
list_reactions | List the users who reacted to a message with a given emoji. |
list_roles | List a server's roles, each with its permissions decoded into names. |
list_thread_members | List the users who have joined a thread. |
search_guild_members | Find server members whose username or nickname starts with a string. |
search_messages | Search a server's messages by content, channel, author, mentions, or attachment type. |
validate_credential | Validate the Discord bot token by fetching the bot's own account. |
Write (16)
Create or send data.
| Tool | What it does |
|---|---|
add_member_role | Give a member one role, leaving their other roles alone. |
add_thread_member | Add a user to a thread. |
create_channel_invite | Create an invite link to a channel. |
create_dm | Open a direct message channel with a user, or return the existing one. |
create_guild_channel | Create a channel in a server. |
create_message | Post a message to a channel, thread, or DM channel. |
create_reaction | React to a message as the bot. |
create_role | Create a role in a server. |
create_thread | Open a thread in a text channel, or a post in a forum or media channel. |
create_thread_from_message | Start a thread attached to an existing message, so the thread appears under it. |
create_webhook | Create a webhook on a channel so an external system can post to it without a bot token. |
crosspost_message | Publish a message from an announcement channel to every server following it. |
execute_webhook | Post a message through a webhook, optionally under a custom name and avatar. |
follow_announcement_channel | Follow an announcement channel so its published messages are crossposted into one of your own channels. |
pin_message | Pin a message in its channel. |
trigger_typing | Show the bot's typing indicator in a channel for about 10 seconds. |
Delete or overwrite (22)
Remove or replace existing data.
| Tool | What it does |
|---|---|
bulk_delete_messages | Delete 2 to 100 messages from a guild channel in one call. |
create_ban | Ban a user from a server, optionally deleting their recent messages. |
delete_all_reactions | Clear reactions from a message. |
delete_channel | Delete a channel, or delete a thread. |
delete_channel_permission | Remove a role's or member's permission override from a channel, so they fall back to the category and server defaults. |
delete_invite | Revoke an invite so it can no longer be used. |
delete_message | Permanently delete one message. |
delete_own_reaction | Remove the bot's own reaction from a message. |
delete_role | Delete a role from a server. |
delete_user_reaction | Remove one specific user's reaction from a message. |
delete_webhook | Delete a webhook, immediately breaking anything posting through it. |
modify_current_member | Change the bot's own nickname or bio in a server. |
remove_ban | Lift a server ban so the user can be invited back. |
remove_guild_member | Kick a member from a server. |
remove_member_role | Take one role away from a member, leaving their other roles alone. |
remove_thread_member | Remove a user from a thread. |
set_channel_permissions | Set a role's or member's permission override on a channel, using permission names rather than raw bitfields. |
unpin_message | Remove a message from its channel's pins. |
update_channel | Modify a channel or thread: rename it, change its topic, slowmode, category, or voice settings, or archive and lock a thread. |
update_guild_member | Change a member's nickname, roles, voice state, or timeout. |
update_message | Edit a message the bot itself sent. |
update_role | Modify a role's name, colour, or permissions. |