क्विक स्टार्ट: शून्य से चालू तक, कोई कदम छूटे बिना
डिफ़ॉल्ट रास्ता क्लाउड-होस्टेड है: बस एक फ़ोन और ~10 मिनट — न सर्वर, न कोड। हर कदम आपको बताता है कि कौन-सी स्क्रीन खोलें और क्या टैप करें, साथ ही वे मुश्किलें जो लोग सचमुच झेलते हैं।
🧾 चेकलिस्ट
- Telegram Premium — LingoDesk जिन Telegram Business फ़ीचर पर निर्भर करता है (बॉट को संदेश रिले) वे केवल Premium में हैं। Premium के बिना इसमें से कुछ भी काम नहीं करता।
- एक फ़ोन — क्लाउड-होस्टेड मोड (डिफ़ॉल्ट) को बस इतना ही चाहिए: कदम 1–3 अपने फ़ोन पर करें, हमें टोकन भेजें, हो गया।
- केवल स्व-होस्टिंग के लिए: Node.js ≥ 20 (या Docker), एक Anthropic API Key, और एक हमेशा-चालू कंप्यूटर/सर्वर। कोड मुफ़्त और ओपन सोर्स है GitHub पर।
1BotFather में अपना बॉट बनाएँ
Telegram में @BotFather खोजें (नीला वेरिफ़िकेशन बैज देखें) और यह बातचीत करें:
🤖 BotFather
/newbot
BotFatherAlright, a new bot. How are we going to call it? Please choose a name for your bot.
LingoDesk Assistant
BotFatherGood. Now let's choose a username for your bot. It must end in bot.
my_lingodesk_bot
BotFatherDone! Use this token to access the HTTP API:
8123456789:AAHfK3xxxxxxxxxxxxxxxxxxxxxxxxx
Keep your token secure and store it safely…
- "name" बस एक प्रदर्शित नाम है; "username" विश्व-स्तर पर अनोखा होना चाहिए और
bot पर खत्म होना चाहिए — यदि पहले से लिया गया हो, तो कोई और आज़माएँ।
- आखिरी जवाब में वह
digits:letters स्ट्रिंग आपका BOT_TOKEN है। इसे कहीं सुरक्षित कॉपी करें। यह असल में बॉट का पासवर्ड है — इसे कभी साझा न करें।
1a. Secretary Mode चालू करें (ज़रूरी; पहले "Business Mode")
⚠️ मई 2026 में Telegram ने इस स्विच का नाम बदलकर Secretary Mode कर दिया; पुराने क्लाइंट अब भी इसे Business Mode लिख सकते हैं — बात एक ही है। यह @BotFather चैट के भीतर करें (अपने बॉट के प्रोफ़ाइल पेज पर नहीं, और अपने फ़ोन की Telegram सेटिंग में नहीं)। दो इंटरफ़ेस — कोई भी काम करता है:
इंटरफ़ेस ① क्लासिक कमांड — बस संदेश भेजें:
/mybots→
@my_lingodesk_bot→
Bot Settings→
Secretary Mode→
Turn on
इंटरफ़ेस ② नया प्रबंधन पैनल — BotFather के संदेश बॉक्स के बगल में नीला Open बटन टैप करें:
Open (पैनल)→
अपना बॉट चुनें→
Settings→
Mode Settings→
Secretary Mode चालू करें
नहीं मिल रहा? ① इसके दो नाम हैं: नए क्लाइंट में Secretary Mode, पुराने में Business Mode — कोई भी देखें; ② पक्का करें कि आप @BotFather के भीतर हैं, अपने बॉट की सेटिंग में नहीं; ③ इस टॉगल का Telegram Premium से कोई लेना-देना नहीं — Premium केवल कदम 2 में आपके अकाउंट की तरफ़ लिंक करते समय मायने रखता है; यह स्विच कोई भी पलट सकता है।
Secretary Mode के बिना, जब आप कदम 2 में इसे जोड़ने की कोशिश करते हैं तो Telegram एक पॉपअप दिखाता है — "This bot doesn't support Telegram Business yet"। यह सबसे आम रुकावट है। स्विच पलटें: यह तुरंत लागू होता है, बॉट को दोबारा बनाने की ज़रूरत नहीं; बस दोबारा जोड़ने की कोशिश करें।
1b. Group Privacy बंद करें (ज़रूरी)
/mybots→
@my_lingodesk_bot→
Bot Settings→
Group Privacy→
Turn off
Privacy डिफ़ॉल्ट रूप से चालू है, और जब तक यह चालू है बॉट आपके कंसोल ग्रुप में टाइप किए जवाब नहीं देख सकता — लक्षण यह है कि "मैं टॉपिक में टाइप करता हूँ और कुछ नहीं होता"। इसे बंद करें (BotFather को कहना चाहिए Privacy mode is disabled)।
2Telegram Business में बॉट लिंक करें
मोबाइल Telegram ऐप पर (यह सेटिंग फ़िलहाल केवल मोबाइल पर है):
⚙️ Settings→
💼 Telegram Business→
🤖 Chatbots
नए क्लाइंट में इस आइटम को "Chat Automation" कहा जाता है — अलग नाम, वही प्रवेश।
- सर्च बॉक्स में अपने बॉट का username (जैसे
my_lingodesk_bot) टाइप करें और इसे चुनें।
- अनुमतियाँ: "Reply to messages" चालू करें — इसके बिना बॉट पढ़ तो सकता है पर आपकी ओर से कभी भेज नहीं सकता।
- "which chats" के लिए, All 1:1 Chats चुनें; जिन निजी संपर्कों को रिले से बाहर रखना चाहते हैं उन्हें Excluded Chats सूची में जोड़ें।
एक बार लिंक होने पर, आपको मिलने वाला हर निजी संदेश चुपचाप बॉट को "cc" कर दिया जाता है — सामने वाले को कुछ पता नहीं चलता, और आपका अपना चैट अनुभव बिल्कुल नहीं बदलता।
3अपना कंसोल फ़ोरम ग्रुप बनाएँ
यह ग्रुप आपका कार्यक्षेत्र है: हर संपर्क के लिए एक टॉपिक, जिसके भीतर द्विभाषी संदेश कार्ड आते हैं।
- एक ग्रुप बनाएँ: New → New Group, अपने बॉट को एकमात्र सदस्य के रूप में जोड़ें (इसका username खोजें)। इसे कोई भी नाम दें, जैसे "LingoDesk Console"।
- Topics चालू करें: ग्रुप खोलें → इसकी प्रोफ़ाइल के लिए नाम पर टैप करें → Edit → Topics टॉगल चालू करें। ग्रुप एक सुपरग्रुप में अपग्रेड हो जाता है और एक टॉपिक सूची मिल जाती है।
- बॉट को एडमिन बनाएँ: प्रोफ़ाइल → Administrators → Add Admin → अपना बॉट → "Manage Topics" चुनें (बाकी डिफ़ॉल्ट रहने दें) → सेव करें।
बॉट हर संपर्क के लिए अपने आप एक टॉपिक बनाता है। एडमिन अधिकार + "Manage Topics" के बिना यह विफल हो जाता है — लक्षण यह है कि "किसी ग्राहक ने मुझे लिखा पर ग्रुप में कुछ नहीं दिखता"।
ग्रुप में बस आप और बॉट चाहिए — कोई और इंसान नहीं। यदि आप किसी साथी को जोड़ते हैं, तो किसी टॉपिक में उनके जवाब भी आपकी तरह ही अनुवाद और भेजना ट्रिगर करते हैं।
4कोई एक चुनें: ☁️ क्लाउड-होस्टेड या 💻 स्व-होस्ट
फ़ोन की तरफ़ सब कुछ हो गया। अब अपना रास्ता चुनें — सर्वर नहीं? A चुनें: कुछ इंस्टॉल करने की ज़रूरत नहीं।
☁️ विकल्प A · क्लाउड-होस्टेड (अनुशंसित: न सर्वर, न कोड, तुरंत)
- आधिकारिक सक्रियण बॉट @LingoDeskbot को DM करें,
/start भेजें, फिर कदम 1 का BOT_TOKEN सीधे चैट में पेस्ट करें।
- तुरंत स्वचालित सक्रियण: टोकन सत्यापित होते ही यह "🎉 Activated" जवाब देता है (और आपके टोकन संदेश को हटा देता है)। मुफ़्त प्लान 300 अनुवादित जवाब/माह कवर करता है; असीमित के लिए कभी भी Pro (500 ⭐/माह) पर अपग्रेड करें। अनुवाद इंजन हमारी तरफ़ से — साइन अप करने के लिए कोई API Key नहीं।
- लिंक करना पूरा करने के लिए इसके जवाब का पालन करें, फिर अपने कंसोल ग्रुप में
/bind भेजें — बॉट "✅ bound" जवाब देता है और आपका काम हो गया। टेस्ट करने के लिए कदम 5 पर जाएँ। कभी भी इसे /status DM करें, या अपनी भाषा सेट करने के लिए /native en।
टोकन सौंपने की चिंता है? यह एन्क्रिप्टेड रूप में संग्रहीत होता है और केवल उन चैट को रिले करने के लिए उपयोग होता है जिन्हें आपने Telegram Business में अधिकृत किया — और नियंत्रण आपके पास रहता है: इसे कभी भी BotFather में रद्द करें (/mybots → API Token → Revoke) और पुराना टोकन तुरंत मर जाता है।
💻 विकल्प B · स्व-होस्ट (आपकी अपनी मशीन, आपका अपना डेटा)
पहले console.anthropic.com पर एक अनुवाद कुंजी लें → API Keys → Create Key (sk-ant-…; कुछ डॉलर का क्रेडिट ~$0.001 प्रति संदेश की दर से बहुत लंबे समय तक चलता है)। फिर:
git clone https://github.com/sanxiaozi/lingodesk.git
cd lingodesk
npm install
cp .env.example .env # open .env — only BOT_TOKEN and ANTHROPIC_API_KEY are required
npm run db:push # initialize the database (first run only)
npm run dev
🚀 LingoDesk is up, bot = @my_lingodesk_bot
जैसे ही आपको बैनर दिखे, इसे लिंक करने के लिए अपने कंसोल ग्रुप में /bind भेजें (ग्रुप ID और आपकी यूज़र ID अपने आप पहचान ली जाती हैं — कोई नंबर ढूँढने की ज़रूरत नहीं)। सर्वर पर, Docker बस एक कमांड है: docker compose up -d — देखें GitHub README।
एक बॉट टोकन = एक चालू इंस्टेंस, विश्व-स्तर पर (409 Conflict = कोई पुरानी प्रक्रिया अब भी इसे पकड़े हुए है)। यदि हम आपको होस्ट करते हैं, तो साथ में लोकल इंस्टेंस न चलाएँ।
5टेस्ट चैट
किसी अलग Telegram अकाउंट (दूसरा अकाउंट या कोई दोस्त) से, अपने निजी अकाउंट पर एक विदेशी-भाषा DM भेजें (बॉट को नहीं!) — जैसे, स्पैनिश में "Hola, ¿cuánto cuesta?"। कुछ ही सेकंडों में, आपके कंसोल ग्रुप में भेजने वाले के नाम पर एक नया टॉपिक दिखना चाहिए:
📋 LingoDesk Console · टॉपिक: @amigo_es
my_lingodesk_bot🆕 नया संपर्क @amigo_es (es)
मूल: Hola, ¿cuánto cuesta?
🌐 नमस्ते, इसकी कीमत कितनी है?
─────
↳ यहाँ अपनी भाषा में टाइप करें — यह es में जाता है, आपकी ओर से भेजा गया
पैकेज A की कीमत $100 है और इसमें सभी फ़ीचर शामिल हैं।
my_lingodesk_bot📤 अनुवाद प्रीव्यू (→es), आपकी पुष्टि के बाद ही भेजा जाता है:
El paquete A cuesta 100 dólares e incluye todas las funciones.
(आपका संदेश: Package A is $100…)
[ ✅ ग्राहक को भेजें ] [ ✏️ रद्द करें ]
"✅ ग्राहक को भेजें" टैप करें — सामने वाला देखता है कि आपका निजी अकाउंट धाराप्रवाह स्पैनिश में जवाब दे रहा है। पूरा लूप अब लाइव है 🎉
- वे जो फ़ोटो, फ़ाइलें और वॉइस संदेश भेजते हैं, वे टॉपिक में फ़ॉरवर्ड होकर अपने आप संग्रहीत हो जाते हैं।
- गलत भाषा पहचानी गई? इसे ठीक करने के लिए टॉपिक में
/lang es भेजें; /help सभी कमांड सूचीबद्ध करता है।
- अपने फ़ोन से मैन्युअल रूप से जवाब देना भी ठीक है — बॉट इसे टॉपिक संग्रह में रिकॉर्ड कर लेता है।
- आप बातचीत भी शुरू कर सकते हैं — उनका इंतज़ार करने की ज़रूरत नहीं। अपने असली अकाउंट से किसी को भी संदेश भेजें (बस "hi" ही सही) और वे तुरंत एक टॉपिक के साथ कंसोल में दिख जाते हैं; उसके बाद, उनसे बात जारी रखने के लिए यहाँ अपनी भाषा में टाइप करें।
🔧 समस्या-समाधान
किसी ग्राहक ने मुझे लिखा पर कंसोल ग्रुप में कुछ नहीं दिखता
क्रम से जाँचें: ① BotFather → Business Mode चालू है (कदम 1a); ② Telegram Business → Chatbots में आपका बॉट लिंक है और वह चैट दायरे में है (कदम 2); ③ बॉट "Manage Topics" के साथ ग्रुप एडमिन है (कदम 3); ④ कंसोल ग्रुप बाउंड है — इसमें /bind भेजें; ⑤ स्व-होस्टर: बॉट प्रक्रिया अब भी बिना किसी त्रुटि के चल रही है।
बॉट जोड़ते समय पॉपअप: "This bot doesn't support Telegram Business yet"
BotFather में Business Mode चालू नहीं है (कदम 1a)। @BotFather → /mybots → अपना बॉट → Bot Settings → Business Mode → Turn on पर जाएँ। यह तुरंत लागू होता है — बॉट को दोबारा बनाने या टोकन दोबारा जमा करने की ज़रूरत नहीं; बस Telegram Business → Chatbots पर वापस जाकर इसे फिर से जोड़ें। क्लाउड-होस्टेड उपयोगकर्ता इस आइटम को दोबारा जाँचने के लिए @LingoDeskbot को /status DM कर सकते हैं।
मैं ग्रुप में /bind भेजता हूँ और कुछ नहीं होता
① Group Privacy अब भी चालू है (कदम 1b) — इसे बंद करें, फिर बॉट को हटाकर दोबारा जोड़ें; ② ग्रुप पर Topics चालू नहीं हैं; ③ क्लाउड-होस्टेड उपयोगकर्ता: पक्का करें कि @LingoDeskbot ने "Activated" जवाब दिया (जाँचने के लिए इसे /status DM करें); ④ स्व-होस्टर: पक्का करें कि प्रक्रिया चल रही है।
क्लाउड होस्टिंग के लिए अपना BOT_TOKEN सौंपना सुरक्षित है?
टोकन एन्क्रिप्टेड रूप में संग्रहीत होता है और केवल उस दायरे की चैट रिले करने के लिए उपयोग होता है जिसे आपने Telegram Business में अधिकृत किया — और आप निजी संपर्कों को बाहर रख सकते हैं (कदम 2)। नियंत्रण आपके पास रहता है: इसे कभी भी BotFather → /mybots → API Token → Revoke के ज़रिए रद्द करें; पुराना टोकन तुरंत मर जाता है और सेवा रुक जाती है। फिर से शुरू करने के लिए, बस नया टोकन @LingoDeskbot को भेजें।
मैं टॉपिक में टाइप करता हूँ और बॉट कुछ नहीं करता
दस में से नौ बार यह Group Privacy का अब भी चालू होना है (कदम 1b)। BotFather → Bot Settings → Group Privacy → Turn off, फिर बॉट को ग्रुप से हटाकर दोबारा जोड़ें (बदलाव दोबारा जुड़ने के बाद ही लागू होता है), और इसे फिर से एडमिन बनाएँ।
स्टार्टअप 409 Conflict के साथ विफल हो जाता है
एक ही टोकन पर दो इंस्टेंस चल रहे हैं। पुरानी प्रक्रिया ढूँढकर रोकें (Ctrl+C या pkill -f "tsx.*main.ts"), दस सेकंड रुकें, फिर से शुरू करें।
"ग्राहक को भेजें" एक सामान्य त्रुटि के साथ विफल हो जाता है
संभावना के क्रम में जाँचें: ① "Reply to messages" अनुमति बंद है (सबसे आम) — Settings → Telegram Business → Chat Automation (Chatbots) → अपना बॉट → "Reply to messages" चालू करें; इसके बिना बॉट पढ़ तो सकता है पर कभी भेज नहीं सकता; ② ग्राहक की चैट बॉट के सुलभ-चैट दायरे में नहीं है (वही पेज); ③ संपर्क ने 24 घंटे से आपको संदेश नहीं भेजा है — Telegram बॉट-शुरू भेजने को रोकता है; उनसे पहले कुछ भी भेजने को कहें। क्लाउड-होस्टेड उपयोगकर्ता: @LingoDeskbot को /status DM करें — "reply permission" लाइन आपको सीधे जवाब देती है।
"ग्राहक को भेजें" विफल: संपर्क बहुत देर से निष्क्रिय
एक Telegram पाबंदी: यदि कोई बातचीत बहुत देर तक बेकार पड़ी रही, तो बॉट आपकी ओर से पहल नहीं कर सकता (BUSINESS_PEER_USAGE_MISSING)। उनसे दोबारा सक्रिय करने के लिए कुछ भी भेजने को कहें, या इस बार अपने फ़ोन से मैन्युअल रूप से जवाब दें।
भेजना विफल: business connection invalid
Settings → Telegram Business → Chatbots पर जाएँ, बॉट को हटाकर दोबारा जोड़ें — या बस ग्राहक के अगले संदेश का इंतज़ार करें, जो बॉट को अपने आप एक ताज़ा कनेक्शन पकड़ने देता है।
गलत भाषा पहचानी गई / एक अलग लक्ष्य भाषा चाहिए
भाषा संपर्क के पहले संदेश पर लॉक हो जाती है (छोटे टेक्स्ट पर उलट-पुलट से बचने के लिए)। इसे ठीक करने के लिए उस संपर्क के टॉपिक में /lang code भेजें, जैसे /lang pt (पुर्तगाली) या /lang ar (अरबी)।
रीस्टार्ट के बाद, पुराने "Send / Cancel" बटन काम करना बंद कर देते हैं
लंबित प्रीव्यू मेमोरी में रहते हैं और रीस्टार्ट पर समाप्त हो जाते हैं (बटन आपको बता देगा)। बस टॉपिक में अपना जवाब दोबारा टाइप करें। संपर्क और चैट इतिहास डेटाबेस में रहते हैं — कुछ भी नहीं खोता।
🎉 सब काम कर रहा है?
अब से, ग्राहक जिस भी भाषा में चाहें लिखें — आप बस अपनी भाषा में टाइप करें। यदि कुछ बिगड़े, तो पहले ऊपर दी गई समस्या-समाधान सूची को देखें; फिर भी अटके हों, तो टर्मिनल त्रुटि के स्क्रीनशॉट के साथ हमें ईमेल करें।
✉️ [email protected]