Mulai cepat: dari nol hingga berjalan, tanpa langkah yang dilewati

Jalur bawaan adalah di-cloud: cukup sebuah ponsel dan ~10 menit — tanpa server, tanpa kode. Setiap langkah memberi tahu Anda layar mana yang harus dibuka dan apa yang harus ditekan, plus jebakan yang benar-benar sering dialami orang.

Daftar Isi Daftar periksa Langkah 1 · Buat bot Anda di BotFather (dua sakelar penting) Langkah 2 · Tautkan bot di Telegram Business Langkah 3 · Buat grup forum konsol Anda Langkah 4 · Pilih salah satu: ☁️ Di-cloud (direkomendasikan) / 💻 Host sendiri Langkah 5 · Uji obrolan Pemecahan masalah

🧾 Daftar periksa

1Buat bot Anda di BotFather

Di Telegram, cari @BotFather (perhatikan lencana verifikasi biru) dan lakukan percakapan ini:

🤖 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. Aktifkan Secretary Mode (wajib; dulu bernama "Business Mode")

⚠️ Pada Mei 2026 Telegram mengganti nama sakelar ini menjadi Secretary Mode; klien lama mungkin masih menamainya Business Mode — sama saja. Lakukan ini di dalam obrolan @BotFather (bukan halaman profil bot Anda, dan bukan pengaturan Telegram di ponsel Anda). Dua antarmuka — keduanya bisa:

Antarmuka ① Perintah klasik — cukup kirim pesan:

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

Antarmuka ② Panel pengelolaan baru — tekan tombol biru Open di sebelah kotak pesan BotFather:

Open (panel)→ pilih bot Anda→ Settings→ Mode Settings→ nyalakan Secretary Mode
Tidak menemukannya? ① Ia punya dua nama: Secretary Mode di klien baru, Business Mode di klien lama — cari salah satunya; ② pastikan Anda berada di dalam @BotFather, bukan pengaturan bot Anda sendiri; ③ sakelar ini sama sekali tidak berkaitan dengan Telegram Premium — Premium hanya penting untuk penautan di sisi akun Anda pada Langkah 2; siapa pun bisa membalik sakelar ini.
Tanpa Secretary Mode, Telegram menampilkan pop-up — "This bot doesn't support Telegram Business yet" — saat Anda mencoba menambahkannya di Langkah 2. Ini penghambat paling umum. Balik sakelarnya: langsung berlaku seketika, tak perlu membuat ulang bot; cukup coba tambahkan lagi.

1b. Matikan Group Privacy (wajib)

/mybots→ @my_lingodesk_bot→ Bot Settings→ Group Privacy→ Turn off
Privacy menyala secara bawaan, dan selama menyala, bot tidak bisa melihat balasan yang Anda ketik di grup konsol — gejalanya adalah "saya mengetik di topik tapi tidak terjadi apa-apa". Matikan (BotFather harus mengatakan Privacy mode is disabled).

2Tautkan bot di Telegram Business

Di aplikasi Telegram seluler (pengaturan ini saat ini hanya ada di seluler):

⚙️ Settings→ 💼 Telegram Business→ 🤖 Chatbots

Di klien yang lebih baru, item ini disebut "Chat Automation" — label berbeda, pintu masuk yang sama.

  1. Ketik username bot Anda (mis. my_lingodesk_bot) di kotak pencarian lalu pilih.
  2. Izin: aktifkan "Reply to messages" — tanpa itu, bot bisa membaca tetapi tak pernah bisa mengirim atas nama Anda.
  3. Untuk "chat mana", pilih All 1:1 Chats; tambahkan kontak pribadi mana pun yang ingin Anda jauhkan dari relai ke daftar Excluded Chats.
Setelah tertaut, setiap pesan pribadi yang Anda terima secara diam-diam "di-cc" ke bot — pihak lain tidak menyadari apa pun, dan pengalaman obrolan Anda sendiri sama sekali tidak berubah.

3Buat grup forum konsol Anda

Grup ini adalah meja kerja Anda: satu topik per kontak, dengan kartu pesan dwibahasa bermunculan di dalamnya.

  1. Buat grup: New → New Group, tambahkan bot Anda sebagai satu-satunya anggota (cari usernamenya). Beri nama apa saja, mis. "LingoDesk Console".
  2. Aktifkan Topics: buka grup → ketuk namanya untuk profil → Edit → nyalakan Topics. Grup naik menjadi supergrup dan mendapat daftar topik.
  3. Jadikan bot admin: profil → Administrators → Add Admin → bot Anda → centang "Manage Topics" (biarkan sisanya bawaan) → simpan.
Bot membuat topik secara otomatis untuk setiap kontak. Tanpa hak admin + "Manage Topics", itu gagal — gejalanya adalah "pelanggan menulis ke saya tapi tak ada apa pun yang muncul di grup".
Grup hanya perlu Anda dan bot — tanpa manusia lain. Jika Anda menambahkan rekan, balasan mereka di sebuah topik memicu terjemahan dan pengiriman persis seperti balasan Anda.

4Pilih salah satu: ☁️ Di-cloud atau 💻 Host sendiri

Semua bagian di ponsel sudah selesai. Sekarang pilih jalur Anda — tidak punya server? Pilih A: tak ada yang perlu dipasang.

☁️ Opsi A · Di-cloud (direkomendasikan: tanpa server, tanpa kode, instan)

  1. Kirim DM ke bot aktivasi resmi @LingoDeskbot, kirim /start, lalu tempel BOT_TOKEN dari Langkah 1 langsung ke dalam obrolan.
  2. Aktivasi otomatis instan: begitu token tervalidasi, ia membalas "🎉 Activated" (dan menghapus pesan token Anda). Paket Gratis mencakup 300 balasan terjemahan/bulan; naik ke Pro (500 ⭐/bln) kapan saja untuk tanpa batas. Mesin terjemahan gratis dari kami — tanpa perlu mendaftar API Key.
  3. Ikuti balasannya untuk menyelesaikan penautan, lalu kirim /bind di grup konsol Anda — bot membalas "✅ bound" dan Anda selesai. Lompat ke Langkah 5 untuk menguji. Kirim DM /status kapan saja, atau /native en untuk mengatur bahasa Anda sendiri.
Khawatir menyerahkan token? Token disimpan terenkripsi dan hanya digunakan untuk merelai obrolan yang Anda otorisasi di Telegram Business — dan Anda tetap memegang kendali: cabut kapan saja di BotFather (/mybots → API Token → Revoke) dan token lama langsung mati seketika.

💻 Opsi B · Host sendiri (mesin Anda sendiri, data Anda sendiri)

Pertama, ambil kunci terjemahan di console.anthropic.com → API Keys → Create Key (sk-ant-…; kredit beberapa dolar bertahan lama dengan ~$0.001 per pesan). Lalu:

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

Begitu Anda melihat banner-nya, kirim /bind di grup konsol Anda untuk menautkannya (ID grup dan ID pengguna Anda terdeteksi otomatis — tak ada angka yang perlu dicari). Di server, Docker cukup satu perintah: docker compose up -d — lihat README di GitHub.

Satu token bot = satu instance berjalan, secara global (409 Conflict = sebuah proses lama masih memegangnya). Jika kami meng-host Anda, jangan sekaligus menjalankan instance lokal.

5Uji obrolan

Dari akun Telegram yang berbeda (akun kedua atau seorang teman), kirim DM berbahasa asing ke akun pribadi Anda (bukan ke bot!) — misalnya, "Hola, ¿cuánto cuesta?" dalam bahasa Spanyol. Dalam hitungan detik, sebuah topik baru bernama sesuai pengirim akan muncul di grup konsol Anda:

📋 LingoDesk Console · topik: @amigo_es
my_lingodesk_bot🆕 Kontak baru @amigo_es (es)
Asli: Hola, ¿cuánto cuesta?
🌐 Hai, berapa harganya?
─────
↳ Ketik di sini dalam bahasa Anda — pesan dikirim dalam es, sebagai Anda sendiri
Paket A seharga $100 dan mencakup semua fitur.
my_lingodesk_bot📤 Pratinjau terjemahan (→es), dikirim hanya setelah Anda konfirmasi:

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

(Pesan Anda: Paket A seharga $100…)

[ ✅ Kirim ke pelanggan ] [ ✏️ Batal ]

Ketuk "✅ Kirim ke pelanggan" — pihak lain melihat akun pribadi Anda membalas dalam bahasa Spanyol yang fasih. Seluruh alurnya kini aktif 🎉

🔧 Pemecahan masalah

Pelanggan menulis ke saya tapi tak ada apa pun yang muncul di grup konsol

Periksa berurutan: ① BotFather → Business Mode sudah dinyalakan (Langkah 1a); ② Telegram Business → Chatbots sudah menautkan bot Anda dan obrolan itu berada dalam cakupan (Langkah 2); ③ bot adalah admin grup dengan "Manage Topics" (Langkah 3); ④ grup konsol sudah terikat — kirim /bind di dalamnya; ⑤ pengguna host sendiri: proses bot masih berjalan tanpa error.

Pop-up saat menambahkan bot: "This bot doesn't support Telegram Business yet"

Business Mode belum diaktifkan di BotFather (Langkah 1a). Buka @BotFather → /mybots → bot Anda → Bot Settings → Business Mode → Turn on. Langsung berlaku seketika — tak perlu membuat ulang bot atau mengirim ulang token; cukup kembali ke Telegram Business → Chatbots dan tambahkan lagi. Pengguna di-cloud bisa DM @LingoDeskbot /status untuk memastikan ulang item ini.

Saya kirim /bind di grup tapi tak terjadi apa-apa

① Group Privacy masih menyala (Langkah 1b) — matikan, lalu keluarkan dan tambahkan ulang botnya; ② Topics belum diaktifkan di grup; ③ pengguna di-cloud: pastikan @LingoDeskbot sudah membalas "Activated" (DM /status untuk memeriksa); ④ pengguna host sendiri: pastikan prosesnya berjalan.

Apakah aman menyerahkan BOT_TOKEN saya untuk hosting di cloud?

Token disimpan terenkripsi dan hanya digunakan untuk merelai obrolan dalam cakupan yang Anda otorisasi di Telegram Business — dan Anda bisa mengecualikan kontak pribadi (Langkah 2). Anda tetap memegang kendali: cabut kapan saja via BotFather → /mybots → API Token → Revoke; token lama langsung mati seketika dan layanan berhenti. Untuk melanjutkan, cukup kirim token baru ke @LingoDeskbot.

Saya mengetik di topik tapi bot tak melakukan apa-apa

Sembilan dari sepuluh kasus penyebabnya Group Privacy yang masih menyala (Langkah 1b). BotFather → Bot Settings → Group Privacy → Turn off, lalu keluarkan bot dari grup dan tambahkan ulang (perubahan hanya berlaku setelah bergabung kembali), dan jadikan admin lagi.

Startup gagal dengan 409 Conflict

Dua instance berjalan pada token yang sama. Temukan dan hentikan proses lama (Ctrl+C atau pkill -f "tsx.*main.ts"), tunggu sepuluh detik, jalankan lagi.

"Kirim ke pelanggan" gagal dengan error umum

Periksa menurut kemungkinan terbesar: ① izin "Reply to messages" mati (paling umum) — Settings → Telegram Business → Chat Automation (Chatbots) → bot Anda → aktifkan "Reply to messages"; tanpa itu bot bisa membaca tapi tak pernah mengirim; ② obrolan pelanggan tak berada dalam cakupan obrolan yang bisa diakses bot (halaman yang sama); ③ kontak belum mengirim pesan kepada Anda selama lebih dari 24 jam — Telegram memblokir pengiriman yang diprakarsai bot; minta mereka mengirim apa pun terlebih dahulu. Pengguna di-cloud: DM @LingoDeskbot /status — baris "reply permission" memberi Anda jawaban langsung.

"Kirim ke pelanggan" gagal: kontak tidak aktif terlalu lama

Pembatasan Telegram: jika percakapan terlalu lama menganggur, bot tak bisa memprakarsai atas nama Anda (BUSINESS_PEER_USAGE_MISSING). Minta mereka mengirim apa pun untuk mengaktifkan kembali, atau balas manual dari ponsel Anda untuk kali ini.

Pengiriman gagal: business connection invalid

Buka Settings → Telegram Business → Chatbots, keluarkan dan tambahkan ulang botnya — atau cukup tunggu pesan berikutnya dari pelanggan, yang membuat bot menangkap koneksi baru secara otomatis.

Bahasa terdeteksi salah / ingin bahasa target yang berbeda

Bahasa terkunci pada pesan pertama kontak (untuk menghindari bolak-balik pada teks pendek). Kirim /lang code di dalam topik kontak tersebut untuk memperbaikinya, mis. /lang pt (Portugis) atau /lang ar (Arab).

Setelah restart, tombol "Kirim / Batal" yang lama berhenti berfungsi

Pratinjau yang tertunda tersimpan di memori dan kedaluwarsa saat restart (tombolnya akan memberi tahu Anda). Cukup ketik ulang balasan Anda di dalam topik. Kontak dan riwayat obrolan tersimpan di basis data — tak ada yang hilang.

🎉 Semua berjalan?

Mulai sekarang, pelanggan menulis dalam bahasa apa pun yang mereka suka — Anda cukup mengetik dalam bahasa Anda. Jika ada yang bermasalah, telusuri dulu daftar pemecahan masalah di atas; jika masih buntu, email kami dengan tangkapan layar error di terminal.

✉️ [email protected]