Hızlı başlangıç: sıfırdan çalışır hale, hiçbir adım atlanmadan

Varsayılan yol bulutta barındırmadır: sadece bir telefon ve ~10 dakika — sunucu yok, kod yok. Her adım, hangi ekranı açacağınızı ve neye dokunacağınızı ayrıca insanların gerçekten karşılaştığı tuzakları anlatır.

İçindekiler Kontrol listesi Adım 1 · BotFather'da botunuzu oluşturun (iki kritik anahtar) Adım 2 · Botu Telegram Business'ta bağlayın Adım 3 · Konsol forum grubunuzu oluşturun Adım 4 · Birini seçin: ☁️ Bulutta barındırma (önerilen) / 💻 Kendi sunucunuz Adım 5 · Sohbeti test edin Sorun giderme

🧾 Kontrol listesi

1BotFather'da botunuzu oluşturun

Telegram'da @BotFather'ı aratın (mavi doğrulama rozetine dikkat edin) ve şu konuşmayı yapın:

🤖 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. Sekreter Modunu açın (zorunlu; eski adıyla "Business Mode")

⚠️ Mayıs 2026'da Telegram bu anahtarın adını Secretary Mode olarak değiştirdi; eski istemciler hâlâ Business Mode olarak etiketleyebilir — aynı şey. Bunu @BotFather sohbeti içinde yapın (botunuzun profil sayfasında değil, telefonunuzun Telegram ayarlarında da değil). İki arayüz — ikisi de işe yarar:

Arayüz ① Klasik komutlar — sadece mesaj gönderin:

/mybots→ @my_lingodesk_bot→ Bot Settings→ Secretary Mode→ Turn on

Arayüz ② Yeni yönetim paneli — BotFather'ın mesaj kutusunun yanındaki mavi Open düğmesine dokunun:

Open (panel)→ botunuzu seçin→ Settings→ Mode Settings→ Secretary Mode'u açın
Bulamıyor musunuz? ① İki adı var: yeni istemcilerde Secretary Mode, eskilerde Business Mode — ikisinden birini arayın; ② @BotFather içinde olduğunuzdan emin olun, kendi botunuzun ayarlarında değil; ③ bu anahtarın Telegram Premium ile hiçbir ilgisi yoktur — Premium yalnızca Adım 2'de kendi hesap tarafınızda bağlama için önemlidir; bu anahtarı herkes açabilir.
Sekreter Modu olmadan, Adım 2'de eklemeye çalıştığınızda Telegram bir açılır pencere gösterir — "This bot doesn't support Telegram Business yet". Bu, en yaygın engeldir. Anahtarı açın: anında geçerli olur, botu yeniden oluşturmaya gerek yok; sadece eklemeyi tekrar deneyin.

1b. Grup Gizliliğini kapatın (zorunlu)

/mybots→ @my_lingodesk_bot→ Bot Settings→ Group Privacy→ Turn off
Gizlilik varsayılan olarak açıktır ve açık olduğu sürece bot konsol grubunuzda yazdığınız yanıtları göremez — belirti şudur: "Konuya yazıyorum ama hiçbir şey olmuyor". Kapatın (BotFather Privacy mode is disabled demelidir).

2Botu Telegram Business'ta bağlayın

Mobil Telegram uygulamasında (bu ayar şu anda yalnızca mobilde bulunur):

⚙️ Ayarlar→ 💼 Telegram Business→ 🤖 Chatbots

Yeni istemcilerde bu öğe "Chat Automation" olarak adlandırılır — farklı etiket, aynı giriş.

  1. Arama kutusuna botunuzun kullanıcı adını (ör. my_lingodesk_bot) yazın ve seçin.
  2. İzinler: "Reply to messages" seçeneğini etkinleştirin — bu olmadan bot okuyabilir ama sizin adınıza asla gönderemez.
  3. "Hangi sohbetler" için All 1:1 Chats seçin; aktarma dışında tutmak istediğiniz özel kişileri Excluded Chats listesine ekleyin.
Bağlandıktan sonra, aldığınız her özel mesaj sessizce bota "cc"lenir — karşı taraf hiçbir şey fark etmez ve kendi sohbet deneyiminiz hiç değişmez.

3Konsol forum grubunuzu oluşturun

Bu grup sizin çalışma tezgâhınızdır: her kişi için bir konu, içinde beliren iki dilli mesaj kartlarıyla.

  1. Bir grup oluşturun: New → New Group, tek üye olarak botunuzu ekleyin (kullanıcı adını aratın). İstediğiniz adı verin, ör. "LingoDesk Console".
  2. Konuları etkinleştirin: grubu açın → profili için adına dokunun → Edit → Topics'i açın. Grup bir süper gruba yükselir ve bir konu listesi alır.
  3. Botu yöneticiliğe yükseltin: profil → Administrators → Add Admin → botunuz → "Manage Topics"i işaretleyin (geri kalanı varsayılan bırakın) → kaydedin.
Bot her kişi için otomatik olarak bir konu oluşturur. Yönetici hakları + "Manage Topics" olmadan bu başarısız olur — belirti şudur: "Bir müşteri bana yazdı ama grupta hiçbir şey görünmüyor".
Grubun yalnızca size ve bota ihtiyacı var — başka insana gerek yok. Bir ortak eklerseniz, onların bir konudaki yanıtları da tıpkı sizinkiler gibi çeviri ve gönderimi tetikler.

4Birini seçin: ☁️ Bulutta barındırma veya 💻 Kendi sunucunuz

Telefon tarafındaki her şey tamam. Şimdi yolunuzu seçin — sunucunuz yok mu? A'yı seçin: kurulacak hiçbir şey yok.

☁️ Seçenek A · Bulutta barındırma (önerilen: sunucu yok, kod yok, anında)

  1. Resmi etkinleştirme botu @LingoDeskbot'a özelden yazın, /start gönderin, ardından Adım 1'deki BOT_TOKEN'ı doğrudan sohbete yapıştırın.
  2. Anında otomatik etkinleştirme: token doğrulanır doğrulanmaz "🎉 Activated" yanıtı verir (ve token mesajınızı siler). Ücretsiz plan ayda 300 çevrilmiş yanıtı kapsar; sınırsız için istediğiniz zaman Pro'ya (ayda 500 ⭐) yükseltin. Çeviri motoru bizden — kaydolmanız gereken bir API anahtarı yok.
  3. Bağlamayı tamamlamak için yanıtını izleyin, ardından konsol grubunuzda /bind gönderin — bot "✅ bound" yanıtı verir ve işiniz biter. Test etmek için Adım 5'e geçin. İstediğiniz zaman ona özelden /status yazın ya da kendi dilinizi ayarlamak için /native en.
Token'ı teslim etmek konusunda mı endişelisiniz? Şifreli olarak saklanır ve yalnızca Telegram Business'ta yetkilendirdiğiniz sohbetleri aktarmak için kullanılır — ve kontrol sizde kalır: BotFather'da istediğiniz zaman iptal edin (/mybots → API Token → Revoke) ve eski token anında geçersiz olur.

💻 Seçenek B · Kendi sunucunuzda barındırma (kendi makineniz, kendi verileriniz)

Önce console.anthropic.com → API Keys → Create Key adresinden bir çeviri anahtarı alın (sk-ant-…; mesaj başına ~$0.001 ile birkaç dolarlık kredi uzun süre yeter). Ardından:

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

Başlangıç afişini gördüğünüzde, bağlamak için konsol grubunuzda /bind gönderin (grup kimliği ve kullanıcı kimliğiniz otomatik olarak algılanır — aranacak numara yok). Bir sunucuda Docker tek komuttur: docker compose up -d — GitHub README'ye bakın.

Bir bot token'ı = küresel olarak tek çalışan örnek (409 Conflict = eski bir işlem hâlâ onu tutuyor). Sizi biz barındırıyorsak, ayrıca yerel bir örnek çalıştırmayın.

5Sohbeti test edin

Farklı bir Telegram hesabından (ikinci bir hesap ya da bir arkadaş), kişisel hesabınıza (bota değil!) yabancı dilde bir özel mesaj gönderin — örneğin İspanyolca "Hola, ¿cuánto cuesta?". Saniyeler içinde, konsol grubunuzda gönderenin adını taşıyan yeni bir konu belirmelidir:

📋 LingoDesk Konsolu · konu: @amigo_es
my_lingodesk_bot🆕 Yeni kişi @amigo_es (es)
Orijinal: Hola, ¿cuánto cuesta?
🌐 Merhaba, ne kadar?
─────
↳ Buraya kendi dilinizde yazın — es dilinde gider, sizin adınıza
A Paketi 100 dolar ve tüm özellikleri içeriyor.
my_lingodesk_bot📤 Çeviri önizlemesi (→es), yalnızca siz onayladıktan sonra gönderilir:

El paquete A cuesta 100 dólares e incluye todas las funciones.

(Mesajınız: A Paketi 100 dolar…)

[ ✅ Müşteriye gönder ] [ ✏️ İptal ]

"✅ Müşteriye gönder"e dokunun — karşı taraf, akıcı İspanyolca yanıt veren kişisel hesabınızı görür. Tüm döngü artık aktif 🎉

🔧 Sorun giderme

Bir müşteri bana yazdı ama konsol grubunda hiçbir şey görünmüyor

Sırayla kontrol edin: ① BotFather → Business Mode açık mı (Adım 1a); ② Telegram Business → Chatbots'ta botunuz bağlı mı ve o sohbet kapsam içinde mi (Adım 2); ③ bot, "Manage Topics" yetkisiyle grup yöneticisi mi (Adım 3); ④ konsol grubu bağlı mı — içinde /bind gönderin; ⑤ kendi sunucusunda barındıranlar: bot işlemi hâlâ hatasız çalışıyor mu.

Botu eklerken açılan pencere: "This bot doesn't support Telegram Business yet"

BotFather'da Business Mode etkin değil (Adım 1a). @BotFather → /mybots → botunuz → Bot Settings → Business Mode → Turn on yolunu izleyin. Anında geçerli olur — botu yeniden oluşturmaya ya da token'ı tekrar göndermeye gerek yok; sadece Telegram Business → Chatbots'a geri dönüp tekrar ekleyin. Bulutta barındırma kullanıcıları, bu öğeyi tekrar kontrol etmek için @LingoDeskbot'a özelden /status yazabilir.

Grupta /bind gönderiyorum ama hiçbir şey olmuyor

① Grup Gizliliği hâlâ açık (Adım 1b) — kapatın, ardından botu çıkarıp yeniden ekleyin; ② Grupta Konular etkin değil; ③ bulutta barındırma kullanıcıları: @LingoDeskbot'un "Activated" yanıtı verdiğinden emin olun (kontrol için ona /status yazın); ④ kendi sunucusunda barındıranlar: işlemin çalıştığından emin olun.

Bulut barındırma için BOT_TOKEN'ımı teslim etmek güvenli mi?

Token şifreli olarak saklanır ve yalnızca Telegram Business'ta yetkilendirdiğiniz kapsamdaki sohbetleri aktarmak için kullanılır — ve özel kişileri hariç tutabilirsiniz (Adım 2). Kontrol sizde kalır: BotFather → /mybots → API Token → Revoke ile istediğiniz zaman iptal edin; eski token anında geçersiz olur ve hizmet durur. Devam etmek için yeni token'ı @LingoDeskbot'a gönderin.

Bir konuya yazıyorum ama bot hiçbir şey yapmıyor

On seferin dokuzunda sorun, Grup Gizliliğinin hâlâ açık olmasıdır (Adım 1b). BotFather → Bot Settings → Group Privacy → Turn off yolunu izleyin, ardından botu gruptan çıkarıp yeniden ekleyin (değişiklik yalnızca yeniden katıldıktan sonra geçerli olur) ve tekrar yöneticiliğe yükseltin.

Başlatma 409 Conflict ile başarısız oluyor

Aynı token üzerinde iki örnek çalışıyor. Eski işlemi bulup durdurun (Ctrl+C ya da pkill -f "tsx.*main.ts"), on saniye bekleyin, tekrar başlatın.

"Müşteriye gönder" genel bir hatayla başarısız oluyor

Olasılık sırasına göre kontrol edin: ① "Reply to messages" izni kapalı (en yaygın) — Settings → Telegram Business → Chat Automation (Chatbots) → botunuz → "Reply to messages"i etkinleştirin; bu olmadan bot okuyabilir ama asla gönderemez; ② müşterinin sohbeti, botun erişebildiği sohbetler kapsamında değil (aynı sayfa); ③ kişi size 24 saatten uzun süredir mesaj atmadı — Telegram, bot tarafından başlatılan gönderimleri engeller; önce herhangi bir şey göndermelerini isteyin. Bulutta barındırma kullanıcıları: @LingoDeskbot'a özelden /status yazın — "reply permission" satırı size cevabı doğrudan verir.

"Müşteriye gönder" başarısız: kişi çok uzun süredir etkin değil

Bir Telegram kısıtlaması: bir sohbet çok uzun süre atıl kaldıysa, bot sizin adınıza başlatamaz (BUSINESS_PEER_USAGE_MISSING). Yeniden etkinleştirmek için herhangi bir şey göndermelerini isteyin ya da bu seferlik telefonunuzdan elle yanıt verin.

Gönderim başarısız: business connection geçersiz

Settings → Telegram Business → Chatbots'a gidin, botu çıkarıp yeniden ekleyin — ya da müşterinin bir sonraki mesajını bekleyin; bu, botun otomatik olarak yeni bir bağlantı yakalamasını sağlar.

Yanlış dil algılandı / farklı bir hedef dil istiyorum

Dil, kişinin ilk mesajında sabitlenir (kısa metinlerde ileri geri gidip gelmeyi önlemek için). Düzeltmek için o kişinin konusunda /lang code gönderin, ör. /lang pt (Portekizce) ya da /lang ar (Arapça).

Yeniden başlattıktan sonra eski "Gönder / İptal" düğmeleri çalışmayı durdurdu

Bekleyen önizlemeler bellekte tutulur ve yeniden başlatmada süresi dolar (düğme size bunu söyler). Yanıtınızı konuya tekrar yazmanız yeterli. Kişiler ve sohbet geçmişi veritabanında saklanır — hiçbir şey kaybolmaz.

🎉 Her şey çalışıyor mu?

Bundan böyle müşteriler istedikleri dilde yazsın — siz sadece kendi dilinizde yazın. Bir şey bozulursa, önce yukarıdaki sorun giderme listesini gözden geçirin; hâlâ takılıysanız, terminal hatasının ekran görüntüsüyle bize e-posta gönderin.

✉️ [email protected]