Web Dashboard

HephBot Translate features a comprehensive web dashboard that makes managing your server settings easier than ever! No more complex Discord commands - manage everything through our intuitive web interface.

Accessing the Dashboard

Visit hbtranslate.com/dashboard and sign in with Discord.

1. Click "Sign in with Discord"
2. Authorize the application (we only request necessary permissions)
3. Select a server from your server list

Required Permissions

You need Administrator permission in a server to manage its settings through the dashboard.

---

Server Dashboard

After selecting a server, you'll see the main dashboard with feature cards for each major feature.

Feature Cards Overview

The dashboard organizes features into easy-to-manage cards:

Card	Description
Auto Setup	Manage automatic category mirroring (Premium)
Default Language	Configure auto-translate channels
Mirrors	Manage channel linking for conversations
Settings	Translation engine, API keys, feature flags
Error Logs	View and manage translation errors
Support	Create and track support tickets (Premium)
Audit Logs	View all changes made to server settings
Commands	Enable/disable and customize commands
Feature Requests	Submit and vote on feature ideas (Premium)

---

Auto Setup (Premium)

Auto Setup automatically creates and maintains mirrored categories and channels across multiple languages.

Features:

• Create Mirrors - Set up automatic category replication
• Manage Languages - Configure up to 6 target languages
• Naming Schemes - Customize how mirrored channels are named
• Exclude Channels - Skip specific channels from mirroring
• Repair - Fix missing channels automatically
• Import - Import from existing conversation setups

How to use:

1. Click the Auto Setup card
2. Click "New Mirror"
3. Select your source category and language
4. Add target languages (Spanish, French, German, etc.)
5. Configure naming scheme (prefix, suffix, or custom)
6. Click Create

The bot will automatically create matching categories and channels for each target language.

---

Default Language

Configure channels to automatically translate all messages to a specific language.

Features:

• Add Channels - Select channels for auto-translation
• Set Languages - Choose the target language for each channel
• Quick Edit - Use :e: in channel topics for fast updates
• Remove - Disable auto-translation for channels

How to use:

1. Click the Default Language card
2. Click "Add Channel"
3. Select a channel from the dropdown
4. Choose the target language
5. Click Save

All messages in that channel will now be automatically translated!

---

Mirrors (Conversations)

Link multiple channels together so messages are translated and synced across all of them.

Features:

• Create Groups - Set up new conversation bridges
• Add Channels - Link channels to a group
• Assign Languages - Set the language for each channel
• Remove Channels - Unlink channels from groups
• Bulk Operations - Add/remove multiple channels at once

How to use:

1. Click the Mirrors card
2. Click "New Conversation" or select an existing one
3. Click "Add Channel"
4. Select a channel and assign its language
5. Repeat for all channels you want to link
6. Click Save

Messages sent in any linked channel will appear translated in all other linked channels!

---

Settings

Configure translation engines, API keys, and feature flags for your server.

Translation Engine

Choose which translation engine your server uses:

Engine	Description	Requirements
Self-Hosted	Free, basic translation	None
Premium Groq (Shared)	AI-powered, higher quality	Trial or Premium
Groq (Your Key)	Use your own Groq API key	BYOK Premium + API Key
OpenAI (Your Key)	Use your own OpenAI key	BYOK Premium + API Key

API Key Management

For BYOK (Bring Your Own Key) tiers:

1. Go to Settings → API Keys
2. Select your engine type (Groq or OpenAI)
3. Enter your API key
4. Click Save

Your API key is encrypted and stored securely.

Custom Prompts

Premium users can customize the translation prompt:

1. Go to Settings → Translation Settings
2. Edit the Custom Prompt field
3. Use variables like {source_language}, {target_language}, {text}
4. Click Save

Feature Flags

Enable or disable specific features:

• Flag Reactions - Enable/disable flag emoji translations
• Bot Message Translation - Translate messages from other bots
• Embed Translation - Translate message embeds

---

Error Logs

View and manage errors that occur during translation.

Features:

• Filter by Severity - INFO, WARNING, ERROR, CRITICAL
• Filter by Status - Active, Ignored, Resolved
• Retry Operations - Retry failed translations
• Bulk Actions - Ignore or resolve multiple errors at once

Error Levels:

Level	Description
INFO	Informational messages
WARNING	Non-critical issues
ERROR	Translation failures
CRITICAL	System-level problems

---

Support Tickets (Premium)

Premium users can create support tickets directly from the dashboard.

Features:

• Create Tickets - Submit support requests
• Track Status - Monitor ticket progress (Open, In Progress, Resolved)
• Attachments - Upload screenshots or files
• Discord Notifications - Get notified in Discord when staff replies

How to create a ticket:

1. Click the Support card
2. Click "New Ticket"
3. Enter a subject and description
4. Attach any relevant files
5. Click Submit

---

Audit Logs

Track all changes made to your server's bot configuration.

What's logged:

• Setting changes
• Feature configuration updates
• Channel additions/removals
• API key updates (not the actual keys)

Features:

• View who made each change
• See when changes were made
• Revert changes if needed

---

Commands

Customize which commands are available in your server.

Features:

• Enable/Disable - Turn commands on or off
• Custom Names - Rename commands (e.g., /translate → /tr)
• Custom Descriptions - Change command descriptions
• Deploy - Push command changes to Discord

How to customize:

1. Click the Commands card
2. Toggle commands on/off
3. Edit names or descriptions
4. Click Deploy Commands

---

Feature Requests (Premium)

Submit and vote on feature ideas for HephBot.

Features:

• Submit Ideas - Propose new features
• Upvote - Support features you want
• Comments - Discuss feature ideas
• Track Progress - See which features are being implemented

Statuses:

• Pending - Under initial review
• Under Review - Being evaluated
• Accepted - Approved for development
• Implemented - Now available!
• Denied - Won't be implemented

---

User Settings

Manage your personal bot settings (separate from server settings).

Access via Dashboard → User Settings or click your avatar.

Personal Preferences:

• Preferred Language - Your default translation language
• Translation Engine - Your preferred engine (if you have user premium)
• API Keys - Your personal API keys (BYOK tiers)

Premium Management:

• View your premium tier
• Manage subscription
• Update payment method

---

Mobile Support

The dashboard is fully responsive and works on mobile devices:

• Touch-optimized controls
• Responsive layout
• Works on phones and tablets

---

Tips & Best Practices

Regular Maintenance

1. Check Error Logs - Review errors weekly
2. Monitor Feature Usage - Track what's being used
3. Update Configurations - Keep settings current
4. Review Audit Logs - Check for unauthorized changes

Organization

1. Use Descriptive Names - Name mirrors and conversations clearly
2. Document Your Setup - Keep notes on complex configurations
3. Team Access - Ensure admins have dashboard access

Security

• API keys are encrypted at rest
• Session-based authentication via Discord OAuth
• Permission checks prevent unauthorized access
• Audit logs track all changes

---

Troubleshooting

Can't see my server?

• Ensure you have Administrator permission
• Try refreshing the page
• Sign out and sign back in

Changes not applying?

• Check for error messages
• Verify you clicked Save
• Refresh the Discord client

Missing features?

• Some features require premium
• Check your server's premium status

---

Ready to explore? Visit hbtranslate.solutions/dashboard and start managing your server!