Telegram — Platform Bot Paling Populer

Telegram — Platform Bot Paling Populer

Kalau kamu pernah pakai Telegram, kamu pasti paham kenapa platform ini jadi rumah yang pas untuk bot. Cepat, jalan di semua perangkat, dan punya basis pengguna yang besar. Tapi ini dia: Telegram bukan cuma tempat bot ada — ini tempat di mana Hermes Agent kamu bisa benar-benar bersinar.

Begitu Hermes terhubung ke Telegram, kamu dapat bot percakapan berfitur lengkap yang bisa diajak ngobrol dari mana saja. Kirim memo suara dan bot akan otomatis mengubahnya jadi teks. Minta laporan terjadwal dan laporan itu langsung mampir di chat kamu. Kamu bahkan bisa menambahkan bot ke grup dan biarkan dia ikut nimbrung dalam percakapan. Bot ini bisa menangani teks, suara, gambar, dan lampiran file — semua lewat library python-telegram-bot yang solid.

Mari kita bahas langkah demi langkah.

Langkah 1: Buat Bot Kamu dengan BotFather

Setiap bot Telegram dimulai dari token API dari @BotFather, pengelola bot resmi Telegram. Begini cara mendapatkannya:

1. Buka Telegram dan cari @BotFather, atau buka t.me/BotFather
2. Kirim /newbot
3. Pilih nama tampilan — terserah kamu, misalnya “Hermes Agent”
4. Pilih username — ini harus unik dan diakhiri dengan bot (contoh: my_hermes_bot)
5. BotFather akan membalas dengan token API kamu, yang bentuknya seperti ini:

123456789:ABCdefGHIjklMNOpqrSTUvwxYZ

Jaga kerahasiaan token kamu! Siapa pun yang punya token ini bisa mengendalikan bot kamu. Kalau bocor, segera cabut dengan /revoke di BotFather.

Langkah 2: Kustomisasi Bot Kamu (Opsional tapi Sepadan)

Beberapa perintah BotFather singkat bisa bikin bot kamu terasa rapi dan profesional:

Perintah	Kegunaan
/setdescription	Teks “Bot ini bisa apa?” yang tampil sebelum seseorang mulai mengobrol
/setabouttext	Teks singkat di halaman profil bot
/setuserpic	Unggah avatar untuk bot kamu
/setcommands	Tentukan menu perintah (tombol / di chat)
/setprivacy	Atur apakah bot bisa melihat semua pesan grup (lihat Langkah 3)

Untuk /setcommands, set awal yang berguna adalah:

help - Tampilkan informasi bantuan
new - Mulai percakapan baru
sethome - Set chat ini sebagai kanal utama

Indikator Status Online/Offline (Opsional)

Bot Telegram tidak punya titik “online” hijau seperti akun pengguna. Yang paling mirip adalah deskripsi singkat bot — baris di bawah namanya di halaman profil.

Aktifkan status_indicator dan Hermes akan mengatur deskripsi itu menjadi Online saat gateway terhubung dan Offline saat dimatikan dengan benar:

gateway:
  platforms:
    telegram:
      extra:
        status_indicator: true
        status_online: "🟢 Online"
        status_offline: "🔴 Offline"

Beberapa catatan: deskripsi ini bersifat global (terlihat oleh semua pengguna), dan hanya penutupan yang bersih yang menulis “Offline” — kalau crash mendadak, status terakhir tetap tersimpan. Fitur ini nonaktif secara bawaan karena mengubah profil bot kamu.

Prioritas dan Batas Menu Perintah (Opsional)

Hermes otomatis mendaftarkan menu perintahnya saat gateway Telegram dimulai. Secara bawaan, batasnya 60 perintah — cukup untuk semua perintah bawaan plus skill umum. Kalau kamu punya perintah plugin yang harus tetap terlihat di pemilih /, kamu bisa prioritaskan:

platforms:
  telegram:
    extra:
      command_menu:
        max_commands: 60
        priority_mode: prepend  # prepend | append | replace
        priority:
          - my_plugin_command

• prepend: perintah kamu dulu, lalu bawaan Hermes
• append: bawaan Hermes dulu, lalu punya kamu
• replace: gunakan hanya daftar kamu untuk urutan prioritas

Telegram mengizinkan hingga 100 perintah, tapi payload besar bisa gagal. Hermes memakai bawaan 60 demi keandalan dan menjepit nilai ke 1..100.

Langkah 3: Mode Privasi — Krusial untuk Grup

Ini sumber kebingungan nomor 1 saat memakai bot di grup: mode privasi AKTIF secara bawaan.

Dengan mode privasi AKTIF, bot kamu hanya melihat:

• Pesan yang diawali dengan /
• Balasan ke pesan bot itu sendiri
• Pesan layanan (anggota masuk, keluar, pin)
• Pesan di kanal tempat bot menjadi admin

Dengan mode privasi NONAKTIF, bot melihat semua pesan di grup.

Untuk menonaktifkannya:

1. Kirim pesan ke @BotFather
2. Kirim /mybots
3. Pilih bot kamu
4. Masuk ke Bot Settings → Group Privacy → Turn off

Penting: Kamu harus hapus dan tambahkan ulang bot ke grup mana pun setelah mengubah pengaturan ini. Telegram menyimpan status privasi saat bot bergabung, dan tidak akan diperbarui sampai bot ditambahkan ulang.

Alternatif: Naikkan bot menjadi admin grup. Bot admin selalu menerima semua pesan, tanpa perlu mengubah toggle privasi.

Mengamati Obrolan Grup Tanpa Auto-Balas

Mau bot kamu melihat pesan grup tapi hanya merespons saat disebut? Atur seperti ini:

telegram:
  allowed_chats:
    - "-1001234567890"
  group_allowed_chats:
    - "-1001234567890"
  require_mention: true
  observe_unmentioned_group_messages: true

Pesan yang tidak menyebut bot dari chat yang diizinkan akan ditambahkan ke transkrip sesi sebagai konteks yang diamati — tapi tidak memicu agent. Hanya sebutan @namabot di kemudian hari yang benar-benar memicu respons.

---

Itu saja! Dengan tiga langkah ini, kamu punya bot Telegram berfungsi penuh yang ditenagai Hermes Agent. Silakan coba — kirim memo suara, taruh di grup, dan lihat bot itu bekerja dengan magisnya.