Documentation

Everything you need to ship a multilingual server.

From the five-minute setup to advanced channel routing and per-server glossaries.

Quick Start

1

Add to Discord

Invite Talksy to your Discord server with one click

2

Configure Settings

Set up translation preferences and permissions

3

Start Translating

Enable real-time translation for your community

Setup Guide

Step 1: Invite the Bot

Click the button below to invite Talksy to your Discord server. You'll need administrator permissions to add the bot.

Add Talksy to Discord →
Alternative· No admin perms needed

Install Talksy to your account

Don't have admin in the server? You can install Talksy directly to your own Discord account. Then /translate and right-click → Apps → Translate Message work in every server you're in — even ones where the bot isn't installed. Replies are private (only you see them).

Note: User install only enables /translate and the right-click menu. Auto-translate, stealth mode, channel routes, and glossary all require server install (admin must add the bot to the server).

Step 2: Server Setup (Admin)

Enable auto-translate and add the channels where you want it to fire:

# Turn on auto-translate for the server
/server enable
# Add each channel where translation should run
/server channel add channel:#general
/server channel add channel:#chat

Step 3: Set Your Language

Each member registers the language they want their own messages translated into. Important: this translates your outgoing messages, not what you receive.

# Your messages → French (so others can read you in French)
/talksy language:french
# Or pick stealth (delete original after translating)
/talksy language:french stealth:true

Step 4: Test It

Type a message in any language. To translate someone else's message into your language, react with the flag emoji of the language you want:

# Manual translate (also doesn't need a saved language)
/translate text:"Bonjour le monde" language:english
# Or react with 🇫🇷 / 🇬🇧 / 🇰🇷 / etc on any message

Bot Commands

User Commands

CommandDescriptionExample
/talksyQuick setup for auto-translation with language autocomplete/talksy spanish stealth:on
/translateManually translate text to any language/translate text:"Hello" to:spanish
Flag ReactionsReact with a flag emoji (🇪🇸, 🇫🇷, etc.) to translate any messageReact with 🇪🇸 to translate to Spanish

✨ New Features

  • Stealth Mode: Delete original messages after translation (privacy-focused)
  • Inline Translation: Translations appear as webhook messages from "Username 🇺🇸"
  • Language Autocomplete: Type language names or use flag emojis
  • Single Character Support: Even "a", "I", etc. get translated

Admin Commands

All /server subcommands require Manage Server permission.

CommandWhat it does
/server enableTurn on auto-translate for the server
/server disableTurn off auto-translate
/server channel add #chAdd a channel where auto-translate fires
/server channel remove #chRemove a channel from the allow-list
/server settingsView current server config
/server route ...Manage channel-to-channel routes (Pro)
/server glossary addAdd a term — accepts comma-separated lists for batch adds
/server glossary bulkPop up a textarea to paste hundreds of terms at once
/server glossary list / remove / clearList, remove, or clear glossary terms

Pro: Translation Routes

The fix for multilingual servers where you want everyone to read in their own language without each member needing to set up Talksy individually.

When to use routes

Your community has French, English, and Korean speakers all in one channel. With /talksy, each speaker can only pick one target language — so you can't serve all three audiences from a single channel. Routes solve this: one source channel fans out into one channel per language.

Setup (Pro admin only)

# Create three readers' channels: #chat-fr, #chat-en, #chat-ko
# Then point a single source channel at each
/server route add source:#chat target:#chat-fr language:fr
/server route add source:#chat target:#chat-en language:en
/server route add source:#chat target:#chat-ko language:ko
# Verify
/server route list

How it behaves

  • • Anyone posts in #chat in any language
  • • Talksy detects the source language, fans out to each route
  • • Each translation appears in its target channel via webhook — same avatar, same name, with the target language flag
  • • Embeds (rich messages, follow-channel news posts) and attachments are forwarded along with the translation
  • • Per-server glossary terms are preserved — game names, abbreviations, jargon stay verbatim

Glossary

Any server admin can add terms that should never be translated — protects game names like "Beyond All Reason", abbreviations like "OS", character or unit names, brand names, or in-jokes. Free plan: 30 terms per server. Pro: unlimited.

Single term

/server glossary add term:Beyond All Reason
/server glossary list
/server glossary remove term:OS

Multiple terms at once

Drop a comma-separated (or newline-separated) list directly into the term option:

/server glossary add term:Phoenix, Jett, Sage, Cypher

Talksy will tell you how many were added, how many were already in the glossary, and how many were skipped.

Bulk paste (popup)

For really long lists — hundreds of unit names, character lists, every item in your game's wiki — use the bulk popup:

/server glossary bulk

A textarea pops up that takes up to ~400 terms in one shot, one per line or comma-separated. Best for bulk imports from a spreadsheet or wiki.

Pro tip — Free tier (30 term cap)

If you bulk-add a list that would push past 30 terms on the free tier, Talksy adds as many as fit and tells you exactly how many were skipped. Upgrade to Pro for unlimited.

Troubleshooting

Common Issues

Bot not responding to commands

Ensure the bot has the necessary permissions and that slash commands are enabled.

Required permissions: Send Messages, Use Slash Commands, Read Message History

Translations are inaccurate

Translation accuracy depends on context and language pairs. For better results:

  • Use complete sentences when possible
  • Avoid heavy slang or regional dialects
  • Check if the source language is correctly detected

Rate limit exceeded

You've exceeded the translation limit for your plan. Consider upgrading or wait for the limit to reset.

View Pricing Plans →

Frequently Asked Questions

What's the difference between server install and user install?
Server install (the standard 'Add to Discord' button) requires admin permissions and gives the whole server access to Talksy — including auto-translate, stealth mode, channel routes, and glossary. User install attaches Talksy to your personal Discord account, lets you use /translate and right-click → Apps → Translate Message in any server you're in (even ones where the bot isn't installed), with replies only visible to you. Use user install if you don't have admin in your server, or if you just want quick translations without affecting the whole channel.
How many languages does Talksy support?
Talksy supports 100+ languages including all major world languages and many regional dialects.
Can I use Talksy for commercial purposes?
Yes! Our Pro plan is designed for commercial use with unlimited translations and all advanced features.
How accurate are the translations?
Our AI-powered translations achieve 95%+ accuracy for most language pairs, with continuous improvements from user feedback.
Can I customize translation settings per channel?
Yes, Pro plans allow per-channel configuration including different target languages, channel-to-channel routes, and auto-translation settings.
Is my data secure?
Absolutely. We use enterprise-grade encryption and don't store message content longer than necessary for translation processing. Translation logs are deleted after 30 days.
How do I upgrade my plan?
Visit your dashboard or our pricing page to upgrade your plan instantly. Changes take effect immediately.