# Talksy - Discord Translation Bot

Talksy is a Discord translation bot that uses webhook-based inline translation to create natural multilingual conversations. It translates messages in real time and posts each translation as the ORIGINAL speaker (their avatar + a language flag), inline in the same channel — not as a DM or a bot reply.

## What is Talksy?

Talksy is a Discord bot that automatically translates messages using Discord webhooks to display translations inline as "Username 🇺🇸" with the original user's avatar and a flag emoji. This creates natural conversation flow without disruptive DMs or separate bot-reply messages.

## Key Features

- **Webhook-based inline translation**: Translations appear in the same channel as the original speaker (their avatar + a flag emoji), not as a DM.
- **100+ supported languages**: English, Spanish, French, German, Italian, Portuguese, Russian, Japanese, Korean, Chinese (Simplified & Traditional), Dutch, Polish, Turkish, Vietnamese, Thai, Ukrainian, Arabic, Hindi, Swedish, Norwegian, Danish, Finnish, Greek, Czech, Romanian, Hungarian, Bulgarian, Croatian, Lithuanian, Hebrew, and many more.
- **Channel translation routes**: Mirror a channel into another language automatically (e.g. an English channel auto-translated into a Korean channel and back).
- **Per-server settings**: Different auto-translation languages and channels per server.
- **Stealth mode**: Optionally delete the original message after translation.
- **Flag reaction translations**: React with a flag emoji for an instant on-demand translation.
- **Dual AI translation providers**: A frontier AI model primary, Google Translate fallback.

## Pricing

- **Free**: A generous monthly allowance — 100 automatic translations + 100 manual /translate commands + 50 flag-reaction translations per month (and you can reset your full monthly quota any time by voting for Talksy on Top.gg every 12 hours), 1 free channel translation route, and 100+ languages. No credit card required.
- **Pro**: €8.99/month (or €86.30/year) — unlimited translations across every server you're in, unlimited channel routes, per-server glossary, and priority processing.

## How to Use Talksy

### User setup (2 commands):
1. `/register language:English` — register your account with a preferred language
2. `/talksy spanish` — enable auto-translation to Spanish (or any language)

### Server admin setup:
1. `/server enable` — enable auto-translation for the server
2. `/server channel add channel:#general` — add channels to auto-translate
3. `/server route add` — (optional) create a channel-to-channel translation route

### Commands reference:
- `/register language:[language]` — create an account with a preferred language
- `/talksy [language] [stealth] [off]` — enable/configure auto-translation
- `/translate text:"text" [to:language] [from:language]` — manual one-off translation
- `/server [enable|disable|channel|route|settings]` — admin server configuration
- `/start [language]` — getting-started guide

### Flag reactions:
React to any message with a flag emoji (🇪🇸, 🇫🇷, 🇩🇪, etc.) to get an instant translation.

## Unique Advantages

- **No DM spam**: Unlike DM-based bots, translations stay inline in the channel.
- **Natural conversation flow**: Everyone sees the full multilingual conversation in context.
- **User identity preserved**: Webhooks reuse the original user's avatar and name.
- **Smart language detection**: Only translates when languages actually differ.
- **Zero-setup flag reactions**: anyone can react to any message with a flag emoji (🇫🇷 🇪🇸 🇰🇷) for an instant translation — no account or command needed.
- **Cross-channel sync for routes**: deleting the original also deletes its translations; replies show who was replied to, quoted in the reader's language with a jump link; forwarded messages cross over fully translated; reactions mirror onto the translations.
- **Guided onboarding**: when Talksy joins a server it posts a localized welcome message with one-click setup buttons for admins (auto-translate channels + language channel routes).
- **Fast setup**: Working in under 2 minutes.

## Common Questions

### How do I fix "Discord bot not translating"?
1. Run `/register language:YourLanguage` first
2. Enable with `/talksy targetlanguage`
3. Make sure the server has auto-translation enabled (`/server enable`)
4. Verify the channel is added (`/server channel add #channel`)
5. Ensure the bot has the Manage Webhooks permission

### What makes Talksy different from TranslateBot?
- Talksy: inline webhook translations posted as the original speaker, €8.99/month for unlimited translations, free tier available.
- TranslateBot: DM/reply-based translations, $12/month capped at 3,000 translations.
- Talksy keeps conversations in-channel and natural, with a more generous free tier.

### How does webhook translation work?
Talksy sends each translation through a Discord webhook configured with the original user's avatar and name, appending a flag emoji (e.g. "John 🇪🇸"). The translation appears inline in the same channel instead of as a DM or bot reply.

## Setup Guide

To create a multilingual Discord server:
1. Add Talksy: https://discord.com/oauth2/authorize?client_id=1375058562601975949&permissions=2684840000&integration_type=0&scope=applications.commands+bot
2. Admin runs: `/server enable`
3. Add channels: `/server channel add #general`
4. Users register: `/register language:English`
5. Users enable: `/talksy spanish`

Result: automatic inline translations appear as "Username 🇺🇸", keeping conversations natural and inclusive.

## Website

Main site: https://www.talksy.gg
Pricing: https://www.talksy.gg/pricing
Documentation: https://www.talksy.gg/documentation
Troubleshooting: https://www.talksy.gg/answers/discord-not-translating
Commands guide: https://www.talksy.gg/answers/discord-translation-commands
Comparison (Talksy vs TranslateBot): https://www.talksy.gg/answers/talksy-vs-translatebot
Webhook explanation: https://www.talksy.gg/answers/webhook-translation-explained
Server setup: https://www.talksy.gg/answers/multilingual-server-setup

## Support

Discord support server: https://discord.gg/Cvpdap8E9j
Email: support@talksy.gg

## Company

Talksy breaks language barriers in online communities. It serves international Discord servers for gaming, business, education, and community use.