Logo TelegramTelegram
Pembuatan Bot Telegram

Bagaimana cara menggunakan BotFather untuk membuat bot Telegram?

Oleh Telegram Official Team
cara membuat bot Telegram, BotFather tutorial, buat bot Telegram sendiri, langkah-langkah BotFather, mengatur bot Telegram, bot Telegram tidak bekerja, optimasi bot Telegram, API token bot, perintah BotFather, buat bot dengan BotFather

Pendahuluan: Mengapa BotFather?

BotFather adalah bot resmi Telegram yang menjadi pintu gerbang utama untuk membuat dan mengelola bot Telegram. Dengan BotFather, Anda bisa mendaftarkan bot baru, mengatur nama, deskripsi, foto profil, daftar perintah, hingga fitur inline dan pembayaran. Artikel ini akan memandu Anda langkah demi langkah, mulai dari persiapan hingga pemecahan masalah, dengan mempertimbangkan batasan dan trade-off yang perlu diketahui.

Perlu dicatat, membuat bot Telegram tidak memerlukan kemampuan pemrograman tingkat tinggi di awal – BotFather menangani sebagian besar konfigurasi administratif. Namun, untuk membuat bot yang interaktif dan berguna, Anda tetap perlu menulis kode backend atau menggunakan platform bot builder. Artikel ini secara spesifik membahas konfigurasi administratif melalui BotFather, yang merupakan pondasi penting sebelum Anda menyentuh baris kode atau layanan otomatisasi pihak ketiga.

Persiapan Awal

Sebelum memulai, pastikan Anda memiliki akun Telegram yang aktif. BotFather dapat diakses melalui semua platform Telegram: versi web, desktop (Windows, macOS, Linux), dan aplikasi mobile (Android, iOS). Tidak ada perbedaan signifikan dalam antarmuka BotFather di berbagai platform – semua perintah berbasis teks. Untuk memulai, cari @BotFather di bilah pencarian atau buka langsung tautan t.me/BotFather.

Setelah masuk ke chat dengan BotFather, mulailah dengan mengklik tombol Start atau mengirimkan perintah /start. Sebagai balasan, BotFather akan menyambut Anda dengan daftar perintah yang tersedia, memperkenalkan antarmuka komandonya. Perintah utama yang akan kita gunakan pertama kali adalah /newbot.

Perbedaan Platform yang Perlu Diperhatikan

Meskipun perintah BotFather identik di semua platform, nuansa navigasi tertentu layak diperhatikan agar pengalaman Anda tetap lancar:

  • Desktop (Windows/macOS/Linux): Buka aplikasi Telegram, cari @BotFather di kolom pencarian kiri. Chat akan terbuka; cukup ketik perintah. Anda bisa memanfaatkan pintasan keyboard seperti Ctrl+Enter untuk mempercepat pengiriman.
  • Mobile (iOS/Android): Buka aplikasi, ketuk ikon pensil (iOS) atau ikon pencarian (Android) di kanan atas, lalu ketik “BotFather”. Setelah chat terbuka, ketik perintah secara manual. Beberapa perintah mungkin memunculkan tombol inline yang memudahkan pemilihan opsi tanpa mengetik ulang.

Pada versi terbaru per 2026, BotFather juga mendukung beberapa perintah dengan tombol balasan (reply keyboard) yang memudahkan navigasi. Meski demikian, semua fungsi utama tetap dapat diakses melalui teks biasa, sehingga konsistensi lintas platform tetap terjaga.

Langkah Demi Langkah Membuat Bot Baru

1. Gunakan Perintah /newbot

Kirim /newbot ke BotFather. Ia akan meminta dua informasi penting: nama tampilan (display name) yang akan dilihat pengguna, dan nama pengguna (username) yang harus diakhiri dengan kata “bot” atau “Bot” (contoh: MyAwesomeBot, contoh_bot). Username bersifat unik dan menjadi identifier global bot Anda.

Jika nama pengguna yang Anda pilih sudah digunakan, BotFather akan memberi tahu dan meminta alternatif. Proses ini mirip dengan pendaftaran username di platform lain. Oleh karena itu, disarankan memilih nama yang singkat, mudah diingat, dan relevan dengan fungsi bot Anda.

2. Dapatkan Token API

Setelah username disetujui, BotFather akan mengirimkan pesan berisi token API – sebuah string panjang yang menjadi kunci otentikasi untuk menghubungkan bot Anda dengan server Telegram. Token ini bersifat rahasia dan merupakan gerbang kendali penuh atas bot Anda; jangan membagikannya secara publik atau menyimpannya di kode klien yang bisa diekspos.

Peringatan: Jika token bocor, orang lain bisa mengendalikan bot Anda. Segera gunakan perintah /revoke di BotFather untuk membuat token baru dan batalkan token lama. Simpan token di variabel lingkungan (environment variables) atau layanan manajemen rahasia.

Salin token dan simpan di tempat aman. Anda akan membutuhkannya saat menulis kode bot, misalnya menggunakan library seperti python-telegram-bot, node-telegram-bot-api, atau pustaka resmi Telegram lainnya.

3. Atur Nama dan Deskripsi Bot

Setelah membuat bot, Anda bisa menyesuaikan tampilannya menggunakan tiga perintah utama. Gunakan perintah /setname untuk mengubah nama tampilan, /setdescription untuk deskripsi singkat (maksimal 512 karakter, ditampilkan di halaman informasi bot), dan /setabouttext untuk teks “About” (maksimal 120 karakter, muncul di profil bot).

Deskripsi yang baik adalah ringkasan fungsional yang jelas; ini sering menjadi kesan pertama pengguna potensial sebelum mereka memutuskan untuk memulai bot. Pastikan deskripsi mencakup nilai utama yang ditawarkan bot Anda.

4. Upload Foto Profil

Gunakan perintah /setuserpic untuk mengunggah foto profil bot. Kirimkan foto ke BotFather (atau balas dengan foto). Ukuran yang disarankan adalah persegi, minimal 512x512 piksel. BotFather akan memotongnya menjadi bentuk lingkaran seperti biasa. Foto yang menarik dan relevan membantu pengguna mengenali serta mengingat bot Anda di chat yang padat.

5. Atur Daftar Perintah (Commands)

Salah satu fitur terpenting untuk pengalaman pengguna adalah daftar perintah yang muncul saat pengguna mengetik / di chat. Gunakan perintah /setcommands untuk mengatur daftar tersebut. Formatnya sederhana: command1 - Deskripsi singkat setiap baris. Contoh:

start - Memulai bot
help - Bantuan
greet - Sapaan

Perintah ini akan ditampilkan di kolom input pengguna, memberikan panduan cepat tentang kemampuan bot. Usahakan perintah tetap singkat (huruf kecil, tanpa spasi) dan deskripsi tidak lebih dari 256 karakter agar mudah dipindai.

Fitur Lanjutan BotFather

Mode Inline

Bot Anda bisa bekerja dalam mode inline: pengguna dapat memanggil bot dengan @username_bot di chat mana pun dan mendapatkan hasil langsung tanpa harus membuka chat pribadi. Untuk mengaktifkannya, gunakan perintah /setinline. BotFather akan meminta placeholder teks yang muncul saat pengguna mengetik query kosong.

Mode inline membutuhkan penanganan di sisi kode – bot harus merespons query inline dengan daftar hasil yang relevan. Skenario umum termasuk bot pencarian, bot stiker, atau bot yang menyediakan informasi cepat seperti cuaca atau definisi kata.

Payment (Pembayaran)

BotFather juga memungkinkan Anda menghubungkan bot dengan penyedia pembayaran (misalnya Stripe, YooMoney). Gunakan perintah /mybots, pilih bot, lalu pilih Payments. Anda perlu mengonfigurasi token pembayaran dari penyedia yang didukung di wilayah Anda. Fitur ini hanya tersedia untuk bot yang memenuhi syarat dan membutuhkan verifikasi identitas.

Trade-off: Mengaktifkan pembayaran meningkatkan kepercayaan pengguna dan membuka peluang monetisasi, tetapi juga menambah kewajiban kepatuhan terhadap peraturan keuangan setempat. Pertimbangkan apakah bot Anda benar-benar membutuhkan transaksi moneter sebelum mengaktifkan fitur ini.

Pengaturan Grup dan Privasi

Saat Anda menambahkan bot ke grup, ada dua mode yang bisa dipilih: privacy mode (default) dan non-privacy mode. Dalam privacy mode, bot hanya melihat pesan yang secara eksplisit ditujukan padanya (misalnya perintah dengan /). Untuk melihat semua pesan di grup, Anda perlu menonaktifkan privacy mode menggunakan BotFather: perintah /mybots → pilih bot → Bot Settings → Group Privacy → pilih Disable.

Trade-off: Non-privacy mode memungkinkan bot membaca semua pesan, berguna untuk bot moderasi atau bot yang merespons kata kunci tertentu. Namun, ini berpotensi menimbulkan masalah privasi. Pastikan pengguna grup mengetahui bot akan membaca semua pesan. Dari sisi etika dan teknis, bot harus diprogram untuk tidak menyimpan atau menyalahgunakan data yang tidak diperlukan.

Mengelola Token dan Keamanan

Keamanan token adalah prioritas tertinggi dalam pengelolaan bot. Gunakan perintah /revoke di BotFather kapan pun Anda mencurigai token bocor. BotFather akan menghasilkan token baru dan yang lama menjadi tidak valid, memutus akses siapa pun yang memiliki token lama.

Jika Anda lupa token, Anda dapat mengambilnya kembali menggunakan perintah /token setelah memilih bot melalui /mybots. Jangan pernah membagikan token di repositori publik atau forum. Gunakan file konfigurasi lokal atau environment variable pada server untuk penyimpanan yang aman.

Pemecahan Masalah Umum

Saat mengembangkan bot, menemui hambatan adalah hal yang wajar. Berikut adalah masalah paling umum dan cara mengatasinya:

Bot Tidak Merespon Perintah

Jika bot Anda tidak merespon, periksa beberapa hal berikut:

  • Apakah token sudah benar? Coba perbarui dengan /token di BotFather.
  • Apakah kode backend berjalan? Pastikan server bot Anda aktif dan terhubung ke internet.
  • Apakah bot di-set ke privacy mode dan pengguna tidak menggunakan perintah? Coba nonaktifkan privacy mode jika perlu.
  • Periksa log server untuk pesan error dari API Telegram; library biasanya memberikan petunjuk spesifik seperti kesalahan token atau pembatasan laju (rate limiting).

Nama Pengguna Ditolak

BotFather menolak nama pengguna yang tidak diakhiri “bot” atau “Bot”. Pastikan username Anda diakhiri dengan kata “bot” (tidak case-sensitive). Selain itu, username harus unik dan hanya berisi huruf, angka, dan underscore. Hindari penggunaan karakter khusus atau spasi.

Perintah Daftar Perintah Tidak Muncul

Setelah mengatur perintah dengan /setcommands, mungkin ada jeda beberapa detik hingga perubahan muncul di klien. Tekan / di chat untuk memicu daftar. Jika tetap tidak muncul, pastikan Anda tidak menggunakan bot dalam mode inline yang membutuhkan query khusus. Perintah diperbarui secara global, jadi tidak perlu restart bot.

Kapan Sebaiknya Tidak Menggunakan BotFather untuk Konfigurasi Tertentu?

Meskipun BotFather adalah alat yang ampuh, ada situasi di mana API langsung atau layanan pihak ketiga lebih tepat:

  • Bot dengan banyak perintah kompleks: Jika Anda perlu mendefinisikan hierarki perintah bersarang atau perintah dengan parameter, BotFather hanya mendukung daftar datar. Anda tetap harus menangani parsing dan logika di kode backend.
  • Kustomisasi nama bot yang sering berubah: BotFather memungkinkan perubahan nama, tetapi setiap perubahan memerlukan interaksi manual. Jika bot Anda perlu mengganti nama secara otomatis (misalnya berdasarkan negara atau sesi), Anda harus menggunakan method API setMyName dan setMyDescription setelah token didapat.
  • BotFather tidak bisa mengatur webhook: Untuk mengatur webhook (endpoint yang dipanggil Telegram saat ada update), Anda harus menggunakan API langsung melalui setWebhook. BotFather hanya memberikan token; sisanya dikelola oleh kode Anda.

Praktik Terbaik dan Daftar Periksa

Berikut adalah langkah-langkah yang sebaiknya dilakukan setelah membuat bot dengan BotFather untuk memastikan keamanan dan kegunaan optimal:

  1. Simpan token dengan aman – jangan hardcode, gunakan environment variable.
  2. Aktifkan fitur inline jika bot menyediakan informasi cepat atau pencarian.
  3. Atur daftar perintah yang jelas agar pengguna tahu kemampuan bot.
  4. Set deskripsi dan foto profil untuk branding yang konsisten.
  5. Nonaktifkan privacy mode hanya jika diperlukan, dan beri tahu pengguna.
  6. Uji bot dengan akun pengguna lain untuk memastikan semua perintah berfungsi.
  7. Pantau log error dan tangani rate limiting dengan backoff.
  8. Perbaharui token secara berkala jika ada indikasi kebocoran.

Daftar periksa di atas merangkum langkah-langkah minimal yang diperlukan untuk meluncurkan bot yang andal dan mudah digunakan. Dengan mengikuti panduan ini, Anda dapat menghindari banyak jebakan umum sejak awal.

Kesimpulan

BotFather menyediakan antarmuka yang mudah untuk mendaftarkan dan mengelola bot Telegram. Dengan mengikuti langkah-langkah di atas, Anda bisa membuat bot dalam hitungan menit. Ingatlah bahwa BotFather hanyalah langkah awal – kemampuan sebenarnya bot Anda bergantung pada kode backend dan bagaimana Anda memanfaatkan API Telegram. Mulailah dengan bot sederhana, lalu perluas fiturnya secara bertahap. Selamat membuat bot!

Pertanyaan yang Sering Diajukan

Apakah saya harus bisa coding untuk membuat bot dengan BotFather?

Tidak wajib. BotFather hanya mendaftarkan bot dan memberikan token. Untuk membuat bot merespon perintah, Anda harus menulis kode backend atau menggunakan platform no-code seperti Manybot. Namun, proses registrasi dan konfigurasi awal melalui BotFather sendiri tidak memerlukan coding.

Bagaimana cara mengganti token bot yang sudah bocor?

Buka chat dengan BotFather, gunakan perintah /mybots, pilih bot yang dimaksud, lalu pilih API Token dan tekan tombol Revoke current token. Token baru akan diberikan dan token lama langsung tidak berlaku.

Apakah bot bisa digunakan di grup tanpa diundang?

Tidak, bot harus ditambahkan secara manual oleh admin grup. Setelah ditambahkan, bot bisa membaca pesan sesuai pengaturan privacy mode. Bot tidak bisa bergabung sendiri ke grup mana pun.

Berapa banyak bot yang bisa dibuat dengan satu akun?

Tidak ada batasan resmi yang dipublikasikan oleh Telegram. Dalam praktiknya, setiap akun bisa membuat puluhan bot tanpa masalah. Jika mencapai batas tidak resmi, BotFather akan memberi tahu Anda.

Apakah saya bisa menghapus bot yang sudah dibuat?

Ya, gunakan perintah /mybots, pilih bot yang dituju, lalu pilih opsi Delete Bot. Token akan dicabut dan bot tidak bisa diakses lagi. Harap dicatat, tindakan ini bersifat permanen dan tidak dapat dibatalkan.

#BotFather#Telegram Bot#API Bot#Konfigurasi Bot#Otomatisasi