Skip to main content

Required Bot Permissions

HephBot’s official invite uses a fixed permission set so Auto-Setup, Channel Mirroring (conversation groups), Default Language, and webhooks work without granting full Administrator.

Use the invite from hbtranslate.com or this template (production bot):

https://discord.com/oauth2/authorize?client_id=736816703958155264&permissions=329370430544&scope=bot%20applications.commands

The permissions value (329370430544) is a Discord API v10 bitfield that matches the table below. You do not need Administrator (permissions=8) if you use this invite or grant the same permissions manually.

Permissions the bot needs

PermissionWhy it is required
View ChannelsRead messages to translate and mirror them
Manage ChannelsAuto-Setup creates categories and mirrored channels; repair recreates missing channels
Manage WebhooksMirrored and translated messages are sent via webhooks (display name & avatar)
Send MessagesFallback sends and some bot replies
Send Messages in ThreadsThread mirroring and forum post replies
Create Public ThreadsForum channel mirroring (new posts in mirrored forum channels)
Embed LinksRich embeds in translated output
Attach FilesForward attachments in mirrors and conversations
Add ReactionsSync reactions across mirrored channels (premium)
Read Message HistoryReply chains and context for translations
Use Application CommandsSlash commands (/translate, setup commands, etc.)
Manage MessagesDefault language cleanup and some mirror/display modes
Manage RolesAuto-Setup creates language roles when configured
Manage ThreadsThread create/rename/delete sync across mirrored channels

If you customize permissions manually, place the bot role above roles it must assign or mention when using ping forwarding.

Per feature

  • Auto-Setup (premium): Manage Channels, Manage Webhooks, View Channels, Send Messages, Send Messages in Threads, Create Public Threads (for forum channels in the source category).
  • Channel Mirroring / conversation groups: Manage Webhooks, View Channels, Send Messages, Send Messages in Threads, Read Message History.
  • Default Language: View Channels, Send Messages, Manage Webhooks (where the dashboard configures a webhook channel).

Dashboard access

Managing the server on hbtranslate.com/dashboard requires your Discord account to have Administrator (or the dashboard’s delegate access rules). That is separate from the bot’s own permissions in the server.