Buat bot Telegram, peroleh API Token-nya, dan konfigurasikan izin admin kelompok serta channel untuk integrasi dengan Chat App Message Service.
Kasus penggunaan
Chat App Message Service menjangkau pengguna global melalui Telegram. Anda membuat bot, memperoleh API Token-nya sebagai kredensial, lalu mengonfigurasi izin admin di kelompok dan channel untuk menyiarkan pesan serta mengelola komunitas.
Ikhtisar
Proses ini mencakup langkah-langkah berikut:
-
Buat bot baru dengan BotFather.
-
Tetapkan nama tampilan dan username bot.
-
Peroleh dan simpan API Token.
-
Lengkapi profil bot (opsional).
-
Konfigurasikan izin admin untuk kelompok dan channel.
BotFather adalah alat manajemen bot resmi Telegram. Seluruh proses pembuatan dan konfigurasi dilakukan melalui percakapan dengan BotFather.
Langkah 1: Buka BotFather dan buat bot
Buka BotFather di klien Telegram Anda (mobile, desktop, atau web):
-
Search: Di bilah pencarian Telegram, masukkan
BotFatherdan pilih akun dengan lencana verifikasi resmi. -
Link: Buka langsung ke https://t.me/BotFather.
Klik Start, lalu kirim /newbot. BotFather akan memandu Anda dalam menetapkan nama tampilan dan username bot.
Pastikan jaringan Anda dapat mengakses Telegram. Klien mobile atau desktop memberikan pengalaman yang lebih stabil.
Langkah 2: Tetapkan nama tampilan bot
BotFather pertama-tama meminta nama tampilan. Nama ini ditampilkan kepada pengguna akhir dan dapat menggunakan bahasa apa pun. Contoh:
-
Support Assistant -
My Shop Assistant -
Order Service Bot
Langkah 3: Tetapkan username bot
Selanjutnya, BotFather meminta username. Username harus memenuhi persyaratan berikut:
-
Hanya boleh berisi huruf Inggris, angka, dan garis bawah (underscore).
-
Harus diakhiri dengan
bot.
Contoh: my_demo_bot atau MyShopHelperBot.
Username berikut tidak valid dan tidak dapat digunakan:
|
Username tidak valid |
Alasan |
|
|
Berisi karakter non-Inggris. |
|
|
Tidak diakhiri dengan |
|
|
Berisi tanda hubung (hyphen) dan tidak diakhiri dengan |
|
|
Terlalu pendek atau sudah digunakan. |
Jika username tersebut sudah digunakan, coba tambahkan angka atau garis bawah: my_shop_bot atau service_01_bot.
Langkah 4: Peroleh dan simpan API Token
Jika berhasil, BotFather akan mengembalikan API Token seperti: 123456789:AAExampleTokenxxxxxxxxxxxxxxxxxxx
API Token adalah kredensial untuk memanggil Telegram Bot API dan menghubungkan bot Anda ke Chat App Message Service. Catat informasi berikut:
|
Item |
Contoh |
|
Bot display name |
Customer Service Bot |
|
Bot username |
my_demo_bot |
|
API Token |
123456789:AAExxxxxxxxxxxxxxxxx |
API Token adalah kata sandi bot Anda. Siapa pun yang memiliki token ini dapat mengendalikan bot Anda. Jangan bagikan token ini di obrolan kelompok, unggah tangkapan layarnya, atau commit ke repositori kode publik. Jika Anda mencurigai token telah dikompromikan, segera cabut token tersebut di BotFather dan perbarui token di Konsol Chat App Message Service.
Langkah 5: Lengkapi profil bot (opsional)
Tingkatkan profil bot di BotFather dengan pengaturan opsional berikut:
|
Perintah |
Fungsi |
|
|
Tetapkan deskripsi bot. |
|
|
Tetapkan pengantar singkat yang ditampilkan saat pengguna membuka bot. |
|
|
Unggah gambar profil untuk bot. |
Langkah 6: Konfigurasikan izin bot
Untuk menggunakan bot Anda di kelompok atau channel, aktifkan izin yang diperlukan di BotFather.
Aktifkan akses kelompok
Diperlukan untuk menambahkan bot ke kelompok.
Jalur: /mybots > Pilih bot Anda > Bot Settings > Allow Groups > Turn groups on
Matikan privasi kelompok
Secara default, bot hanya menerima pesan yang menyebut (@-mention) atau membalasnya. Mematikan Group Privacy memungkinkan bot menerima semua pesan kelompok.
Jalur: /mybots > Pilih bot Anda > Bot Settings > Group Privacy > Turn off
Konfigurasikan hak admin kelompok
Jalur: /mybots > Pilih bot Anda > Bot Settings > Group Admin Rights > Pilih izin yang diperlukan
Konfigurasikan Group Admin Rights sesuai kebutuhan Anda:
Rekomendasi didasarkan pada dokumentasi resmi Telegram dan mungkin berbeda dari fitur saat ini. Pilih izin berdasarkan kebutuhan aktual Anda.
|
Izin |
Deskripsi |
Rekomendasi |
|
Change group name, photo, etc. |
Ubah nama, foto, dan deskripsi kelompok. |
Recommended |
|
Delete messages |
Hapus pesan apa pun yang dikirim oleh anggota kelompok. |
Required |
|
Restrict, ban or unban members |
Blokir, batalkan blokir, atau batasi anggota. |
Required |
|
Invite new users |
Buat tautan undangan atau tambahkan pengguna langsung ke kelompok. |
Recommended |
|
Pin messages |
Pin pesan di bagian atas obrolan kelompok. |
Optional |
|
Add new administrators |
Tunjuk anggota lain sebagai administrator. |
Optional |
|
Manage voice chats |
Mulai, hentikan, atau kelola obrolan suara atau video di kelompok. |
Optional |
|
Promote anonymous admins |
Perbolehkan administrator memposting secara anonim atas nama kelompok. |
Optional |
|
Manage Topics |
Kelola topik di supergroup tempat topik diaktifkan. |
Optional |
|
Post stories |
Posting cerita ke Telegram Stories atas nama kelompok. Memerlukan Telegram Premium. |
Not Recommended |
|
Edit stories |
Edit cerita yang diposting oleh kelompok. Memerlukan Telegram Premium. |
Not Recommended |
|
Delete stories |
Hapus cerita yang diposting oleh kelompok. Memerlukan Telegram Premium. |
Not Recommended |
|
Manage chat |
Ubah pengaturan lanjutan kelompok, seperti mode lambat dan izin anggota default. |
Required |
Konfigurasikan hak admin channel
Jalur: /mybots > Pilih bot Anda > Bot Settings > Channel Admin Rights > Pilih izin yang diperlukan
Konfigurasikan Channel Admin Rights sesuai kebutuhan Anda:
Rekomendasi didasarkan pada dokumentasi resmi Telegram dan mungkin berbeda dari fitur saat ini. Pilih izin berdasarkan kebutuhan aktual Anda.
|
Izin |
Deskripsi |
Rekomendasi |
|
Change the chat name, photo, etc. |
Ubah nama, foto, dan deskripsi channel. |
Recommended |
|
Post in the channel |
Kirim pesan langsung sebagai channel. |
Required |
|
Edit messages of other users, pin messages |
Edit pesan yang diposting oleh administrator lain atau pin pesan. |
Recommended |
|
Delete messages |
Hapus pesan apa pun yang telah diposting di channel. |
Recommended |
|
Delete participants |
Hapus atau bisukan subscriber di channel. |
Recommended |
|
Add new administrators |
Tunjuk anggota lain sebagai administrator channel. |
Optional |
|
Invite via link |
Buat, kelola, dan cabut tautan undangan channel. |
Recommended |
|
Manage video chat / live stream |
Mulai, hentikan, atau kelola siaran langsung suara atau video di channel. |
Not Recommended |
|
Manage direct messages |
Terima dan balas pesan langsung yang dikirim ke channel. Memerlukan Telegram Premium. |
Not Recommended |
|
Post stories |
Posting cerita ke Telegram Stories atas nama channel. Memerlukan Telegram Premium. |
Not Recommended |
|
Edit stories |
Edit cerita yang diposting oleh channel. Memerlukan Telegram Premium. |
Not Recommended |
|
Delete stories |
Hapus cerita yang diposting oleh channel. Memerlukan Telegram Premium. |
Not Recommended |
|
Manage channel |
Ubah pengaturan lanjutan channel dan lihat log audit channel. |
Required |
Verifikasi bot
Setelah konfigurasi, verifikasi bahwa bot berfungsi:
-
Cari username bot Anda (misalnya,
my_demo_bot) dan pastikan bot tersebut muncul dalam hasil pencarian. -
Buka profil bot dan klik Start untuk memastikan bot merespons.
-
Buka
https://t.me/<your_bot_username>dan pastikan tautan terbuka dengan benar. -
Tambahkan bot ke kelompok atau channel uji untuk memastikan izinnya berfungsi.
Langkah selanjutnya
Buat saluran Telegram di Konsol Chat App Message Service, lalu ikatkan Token API bot untuk mulai mengirim pesan.
FAQ
Tidak dapat menemukan BotFather
Pastikan hal berikut:
-
Anda mencari istilah persis
BotFather(case-sensitive). -
Anda memilih akun dengan lencana verifikasi resmi.
-
Koneksi jaringan Anda memungkinkan akses ke Telegram.
Anda juga dapat langsung membuka https://t.me/BotFather.
Username tidak tersedia
Username tersebut sudah digunakan. Coba penyesuaian berikut:
-
Gunakan kata kunci berbeda dalam nama.
-
Tambahkan akhiran numerik.
-
Gunakan garis bawah sebagai pemisah.
Username yang disesuaikan tetap harus diakhiri dengan bot. Contoh: my_shop_bot, myshophelper1_bot, atau service_01_bot.
Kehilangan API token
Kirim /mybots ke BotFather dan pilih bot Anda untuk melihat atau membuat ulang API Token.