Mirrors

Channel Mirroring (dashboard: Conversations; command: /mirror) links specific channels so messages in one channel are translated and posted in the others. This is not the same as Auto Setup (category replication). See Feature Terminology.

🎯 What are Mirrors?

Mirrors (formerly "Conversations") link channels together for multilingual conversations. When you set up a mirror:

1. Select multiple channels and assign a language to each
2. Messages sent in any channel are automatically translated
3. Translated messages are posted in all other linked channels
4. Everyone can participate in their preferred language

flowchart LR
    A[#english] -->|post| B[HephBot]
    B -->|translate| C[#spanish]
    B -->|translate| D[#french]
    C -->|post| B
    D -->|post| B
    B -->|translate| A

Screenshot

A future docs update should include a dashboard screenshot of the Conversations manager with three channels and language badges.

Key Features

• ✅ Link multiple channels together
• ✅ Automatic translation between channels
• ✅ Real-time message synchronization
• ✅ Support for attachments and embeds
• ✅ Webhook system maintains original author appearance
• ✅ Unlimited mirror flows (completely free!)

🚀 Getting Started

Prerequisites: Server Setup

Before setting up Mirrors, make sure your Discord server is properly configured:

• ✅ Bot is invited with proper permissions
• ✅ Server is set up (Community Server recommended for advanced setups)
• ✅ Channels are created and organized
• ✅ Bot has access to the channels you want to link

Need help with server setup? Check out our Community Server Setup Guide for detailed instructions on preparing your server, configuring permissions, setting up language roles, and organizing channels for multilingual features.

Setup via Dashboard (Recommended)

1. Navigate to Dashboard

   • Go to hbtranslate.com/dashboard
   • Select your server

2. Access Mirrors Manager

   • Click on the "Channel Mirroring" card (or "Conversations" card)
   • Click "Create New Channel Mirroring Group" button

3. Configure Mirror

   • Give your mirror group a name (optional)
   • Add channels and assign a language to each
   • Click "Save"

That's it! Messages sent in any channel will be automatically translated and posted in all other channels.

Video placeholder

A 30–60 second screen recording of creating a mirror group in the dashboard would replace this note in a future update.

Managing Mirrors

View All Mirrors

• See all active mirror groups in the dashboard
• View which channels are linked together
• See language assignments for each channel

Edit Mirror

• Add or remove channels from a mirror group
• Change language assignments
• Rename mirror groups

Delete Mirror

• Remove a mirror group
• This unlinks all channels in that group
• Warning: This action cannot be undone!

Setup via Discord Commands (Alternative Method)

If you prefer using Discord commands, you can set up mirrors this way:

Commands:

• /mirror assign — Add a channel to a mirror group
• /mirror unassign — Remove a channel from a group
• /mirror view — View all mirror groups

Step-by-Step Setup:

1. Add First Channel
   

   /mirror assign channel:#english language:English

2. Add Second Channel
   

   /mirror assign channel:#spanish language:Spanish

3. Add More Channels (optional)
   

   /mirror assign channel:#french language:French
   /mirror assign channel:#german language:German

4. Verify Setup
   

   /mirror view

Example Setup:

Scenario: You want to link English, Spanish, and French channels together.

Commands:

/mirror assign channel:#general-en language:English
/mirror assign channel:#general-es language:Spanish
/mirror assign channel:#general-fr language:French

Result: Messages in any of these channels will be automatically translated and posted in the other two channels.

[Photo of example mirror setup here]

💡 How It Works

1. Message Detection: Bot detects new messages in any linked channel
2. Language Detection: Automatically detects the source language
3. Translation: Translates message to target languages
4. Posting: Posts translated messages in all other linked channels
5. Webhook System: Uses webhooks to maintain original author appearance

See the mermaid diagram at the top of this page for the message flow.

📋 Best Practices

Channel Organization

1. Clear Naming: Use language indicators in channel names

   • #general-en (English)
   • #general-es (Spanish)
   • #general-fr (French)

2. Logical Grouping: Link related channels together

   • General discussion channels
   • Support channels
   • Announcement channels

3. Separate Mirrors: Create separate mirror groups for different topics

Content Management

1. Moderation: Set up moderation in all linked channels
2. Guidelines: Provide community guidelines in all languages
3. Consistency: Keep channel purposes aligned across languages

🔄 Comparison with Other Features

Feature	Best For
Mirrors	Linking specific channels together for multilingual conversations
Auto Setup	Complete server sections, automatic category/channel creation
Default Language	Single channels with one target language

🆘 Troubleshooting

Messages Not Bridging

Check:

• Channels are added to the same mirror group
• Languages are set correctly
• Bot has permission to send messages
• Translation engine is working

Solution:

• Verify mirror setup with /mirror view or dashboard Conversations → Scan
• Check bot permissions
• Review error logs in dashboard

Translation Quality

For Better Quality:

• Upgrade to premium for Groq/OpenAI engines
• Premium engines provide more accurate translations

💡 Tips

• Start Small: Begin with 2-3 channels, then expand
• Test First: Test with a small mirror group before scaling up
• Use Dashboard: Consider switching to dashboard for easier management
• Monitor Usage: Check statistics in dashboard

🆘 Support

Need help with Mirrors?

• Dashboard Help: Use the help system in the web dashboard
• Documentation: Check this page and the main documentation
• Support Server: Join our Discord support server

---

Ready to set up Mirrors? Visit the Dashboard and click on "Channel Mirroring"!