کوئیک اسٹارٹ: صفر سے چلنے تک، کوئی قدم نہ چھوڑا

پہلے سے طے شدہ راستہ کلاؤڈ ہوسٹڈ ہے: بس ایک فون اور ~10 منٹ — کوئی سرور نہیں، کوئی کوڈ نہیں۔ ہر قدم آپ کو بتاتا ہے کہ کون سی سکرین کھولنی ہے اور کیا ٹیپ کرنا ہے، ساتھ ہی وہ رکاوٹیں جن کا لوگ واقعی سامنا کرتے ہیں۔

فہرست چیک لسٹ قدم 1 · BotFather میں اپنا بوٹ بنائیں (دو اہم سوئچ) قدم 2 · بوٹ کو ٹیلیگرام بزنس میں منسلک کریں قدم 3 · اپنا کنسول فورم گروپ بنائیں قدم 4 · ایک منتخب کریں: ☁️ کلاؤڈ ہوسٹڈ (تجویز کردہ) / 💻 خود ہوسٹ قدم 5 · ٹیسٹ چیٹ مسائل کا حل

🧾 چیک لسٹ

1BotFather میں اپنا بوٹ بنائیں

ٹیلیگرام میں @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…

1a. Secretary Mode آن کریں (لازمی؛ پہلے "Business Mode")

⚠️ مئی 2026 میں ٹیلیگرام نے اس سوئچ کا نام بدل کر Secretary Mode رکھ دیا؛ پرانے کلائنٹس اب بھی اسے Business Mode لکھ سکتے ہیں — ایک ہی چیز ہے۔ یہ کام @BotFather چیٹ کے اندر کریں (اپنے بوٹ کے پروفائل صفحے پر نہیں، اور اپنے فون کی ٹیلیگرام ترتیبات میں نہیں)۔ دو انٹرفیس — دونوں میں سے کوئی بھی کام کرتا ہے:

انٹرفیس ① کلاسک کمانڈز — بس پیغامات بھیجیں:

/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 میں بوٹ کو شامل کرنے کی کوشش کرتے ہیں تو ٹیلیگرام ایک پاپ اپ دکھاتا ہے — "This bot doesn't support Telegram Business yet"۔ یہ سب سے عام رکاوٹ ہے۔ سوئچ پلٹیں: یہ فوراً اثر انداز ہوتا ہے، بوٹ دوبارہ بنانے کی ضرورت نہیں؛ بس اسے دوبارہ شامل کرنے کی کوشش کریں۔

1b. Group Privacy بند کریں (لازمی)

/mybots→ @my_lingodesk_bot→ Bot Settings→ Group Privacy→ Turn off
پرائیویسی پہلے سے آن ہوتی ہے، اور جب تک یہ آن ہے بوٹ آپ کے کنسول گروپ میں ٹائپ کیے گئے جوابات نہیں دیکھ سکتا — علامت یہ ہوتی ہے کہ "میں ٹاپک میں ٹائپ کرتا ہوں اور کچھ نہیں ہوتا"۔ اسے بند کریں (BotFather کو کہنا چاہیے Privacy mode is disabled)۔

2بوٹ کو ٹیلیگرام بزنس میں منسلک کریں

موبائل ٹیلیگرام ایپ پر (یہ ترتیب فی الحال صرف موبائل پر موجود ہے):

⚙️ ترتیبات→ 💼 Telegram Business→ 🤖 Chatbots

نئے کلائنٹس میں اس آئٹم کو "Chat Automation" کہا جاتا ہے — مختلف لیبل، وہی داخلہ۔

  1. سرچ باکس میں اپنے بوٹ کا یوزر نیم ٹائپ کریں (مثلاً my_lingodesk_bot) اور اسے منتخب کریں۔
  2. اجازتیں: "Reply to messages" فعال کریں — اس کے بغیر بوٹ پڑھ تو سکتا ہے مگر کبھی آپ کی طرف سے بھیج نہیں سکتا۔
  3. "کون سی چیٹس" کے لیے، All 1:1 Chats منتخب کریں؛ جو نجی رابطے آپ ریلے سے باہر رکھنا چاہتے ہیں انہیں Excluded Chats فہرست میں شامل کریں۔
منسلک ہونے کے بعد، آپ کو موصول ہونے والا ہر نجی پیغام خاموشی سے بوٹ کو "cc" ہو جاتا ہے — دوسری طرف کسی کو کچھ محسوس نہیں ہوتا، اور آپ کے اپنے چیٹ کے تجربے میں بالکل کوئی تبدیلی نہیں آتی۔

3اپنا کنسول فورم گروپ بنائیں

یہ گروپ آپ کا ورک بینچ ہے: ہر رابطے کے لیے ایک ٹاپک، جس کے اندر دو لسانی پیغام کارڈز نمودار ہوتے ہیں۔

  1. ایک گروپ بنائیں: New → New Group، اپنے بوٹ کو واحد رکن کے طور پر شامل کریں (اس کا یوزر نیم تلاش کریں)۔ اسے کوئی بھی نام دیں، مثلاً "LingoDesk Console"۔
  2. Topics فعال کریں: گروپ کھولیں → پروفائل کے لیے نام پر ٹیپ کریں → Edit → Topics آن کریں۔ گروپ سپر گروپ میں اپ گریڈ ہو جاتا ہے اور ایک ٹاپک فہرست حاصل کر لیتا ہے۔
  3. بوٹ کو ایڈمن بنائیں: پروفائل → Administrators → Add Admin → آپ کا بوٹ → "Manage Topics" پر نشان لگائیں (باقی پہلے سے طے شدہ چھوڑ دیں) → محفوظ کریں۔
بوٹ ہر رابطے کے لیے خودکار طور پر ایک ٹاپک بناتا ہے۔ ایڈمن حقوق + "Manage Topics" کے بغیر یہ ناکام ہو جاتا ہے — علامت یہ ہوتی ہے کہ "ایک گاہک نے مجھے لکھا مگر گروپ میں کچھ ظاہر نہیں ہوتا"۔
گروپ کو صرف آپ اور بوٹ کی ضرورت ہے — کوئی اور انسان نہیں۔ اگر آپ کسی ساتھی کو شامل کرتے ہیں، تو ٹاپک میں ان کے جوابات بھی آپ کی طرح ترجمے اور بھیجنے کو متحرک کرتے ہیں۔

4ایک منتخب کریں: ☁️ کلاؤڈ ہوسٹڈ یا 💻 خود ہوسٹ

فون کی طرف سب کچھ ہو گیا۔ اب اپنا راستہ منتخب کریں — کوئی سرور نہیں؟ A منتخب کریں: انسٹال کرنے کو کچھ نہیں۔

☁️ آپشن A · کلاؤڈ ہوسٹڈ (تجویز کردہ: کوئی سرور نہیں، کوئی کوڈ نہیں، فوری)

  1. سرکاری فعالی بوٹ @LingoDeskbot کو DM کریں، /start بھیجیں، پھر قدم 1 کا BOT_TOKEN سیدھا چیٹ میں پیسٹ کریں۔
  2. فوری خودکار فعالی: ٹوکن کی تصدیق ہوتے ہی یہ "🎉 Activated" کا جواب دیتا ہے (اور آپ کا ٹوکن پیغام حذف کر دیتا ہے)۔ مفت پلان میں 300 ترجمہ شدہ جوابات/ماہ شامل ہیں؛ لامحدود کے لیے کسی بھی وقت Pro (500 ⭐/ماہ) پر اپ گریڈ کریں۔ ترجمے کا انجن ہماری طرف سے ہے — سائن اپ کرنے کے لیے کوئی API keys نہیں۔
  3. منسلک کرنا مکمل کرنے کے لیے اس کے جواب پر عمل کریں، پھر اپنے کنسول گروپ میں /bind بھیجیں — بوٹ "✅ bound" کا جواب دیتا ہے اور آپ کا کام ہو گیا۔ ٹیسٹ کے لیے قدم 5 پر جائیں۔ کسی بھی وقت اسے /status DM کریں، یا اپنی زبان مقرر کرنے کے لیے /native en۔
ٹوکن دینے کے بارے میں فکرمند ہیں؟ یہ خفیہ کاری کے ساتھ محفوظ ہوتا ہے اور صرف انہی چیٹس کو ریلے کرنے کے لیے استعمال ہوتا ہے جن کی آپ نے ٹیلیگرام بزنس میں اجازت دی تھی — اور کنٹرول آپ کے ہاتھ میں رہتا ہے: اسے کسی بھی وقت BotFather میں منسوخ کریں (/mybots → API Token → Revoke) اور پرانا ٹوکن فوراً ختم ہو جاتا ہے۔

💻 آپشن B · خود ہوسٹ (آپ کی اپنی مشین، آپ کا اپنا ڈیٹا)

پہلے console.anthropic.com → API Keys → Create Key پر ترجمے کی ایک 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ٹیسٹ چیٹ

کسی مختلف ٹیلیگرام اکاؤنٹ سے (دوسرا اکاؤنٹ یا کوئی دوست)، اپنے ذاتی اکاؤنٹ کو ایک غیر ملکی زبان میں 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…)

[ ✅ گاہک کو بھیجیں ] [ ✏️ منسوخ کریں ]

"✅ گاہک کو بھیجیں" پر ٹیپ کریں — دوسری طرف آپ کا ذاتی اکاؤنٹ روانی سے ہسپانوی میں جواب دیتا نظر آتا ہے۔ پورا لوپ اب لائیو ہے 🎉

🔧 مسائل کا حل

ایک گاہک نے مجھے لکھا مگر کنسول گروپ میں کچھ ظاہر نہیں ہوتا

ترتیب سے جانچیں: ① 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 دینا محفوظ ہے؟

ٹوکن خفیہ کاری کے ساتھ محفوظ ہوتا ہے اور صرف اسی دائرہ کار کے اندر چیٹس ریلے کرنے کے لیے استعمال ہوتا ہے جس کی آپ نے ٹیلیگرام بزنس میں اجازت دی تھی — اور آپ نجی رابطوں کو خارج کر سکتے ہیں (قدم 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 گھنٹے سے زیادہ عرصے سے پیغام نہیں بھیجا — ٹیلیگرام بوٹ کی جانب سے شروع کیے گئے پیغامات کو روکتا ہے؛ ان سے کہیں کہ پہلے کچھ بھیجیں۔ کلاؤڈ ہوسٹڈ صارفین: @LingoDeskbot کو /status DM کریں — "reply permission" کی سطر آپ کو سیدھا جواب دیتی ہے۔

"گاہک کو بھیجیں" ناکام: رابطہ بہت دیر سے غیر فعال

ایک ٹیلیگرام پابندی: اگر کوئی گفتگو بہت دیر سے بیکار پڑی ہو، تو بوٹ آپ کی طرف سے شروع نہیں کر سکتا (BUSINESS_PEER_USAGE_MISSING)۔ ان سے کہیں کہ دوبارہ فعال کرنے کے لیے کچھ بھیجیں، یا اس بار اپنے فون سے دستی طور پر جواب دیں۔

بھیجنا ناکام: business connection غلط

Settings → Telegram Business → Chatbots پر جائیں، بوٹ کو ہٹا کر دوبارہ شامل کریں — یا بس گاہک کے اگلے پیغام کا انتظار کریں، جو بوٹ کو خودکار طور پر ایک تازہ کنکشن حاصل کرنے دیتا ہے۔

غلط زبان پہچانی گئی / مختلف ہدف زبان چاہتے ہیں

زبان رابطے کے پہلے پیغام پر مقفل ہو جاتی ہے (تاکہ مختصر متن پر بار بار بدلنے سے بچا جا سکے)۔ اسے درست کرنے کے لیے اُس رابطے کے ٹاپک میں /lang code بھیجیں، مثلاً /lang pt (پرتگالی) یا /lang ar (عربی)۔

دوبارہ شروع کرنے کے بعد، پرانے "Send / Cancel" بٹن کام کرنا بند کر گئے

زیر التوا پیش نظارے میموری میں رہتے ہیں اور دوبارہ شروع کرنے پر ختم ہو جاتے ہیں (بٹن آپ کو بتا دے گا)۔ بس ٹاپک میں اپنا جواب دوبارہ ٹائپ کریں۔ رابطے اور چیٹ ہسٹری ڈیٹابیس میں رہتے ہیں — کچھ ضائع نہیں ہوتا۔

🎉 سب کام کر رہا ہے؟

اب سے، گاہک جس زبان میں چاہیں لکھیں — آپ بس اپنی زبان میں ٹائپ کریں۔ اگر کچھ خراب ہو، تو پہلے اوپر دی گئی مسائل کے حل کی فہرست دیکھیں؛ پھر بھی اٹکے ہوں، تو ٹرمینل کی خرابی کے سکرین شاٹ کے ساتھ ہمیں ای میل کریں۔

✉️ [email protected]