Cara Integrasi AI Agent Hermes ke Grup Telegram

AI agent Hermes nggak cuma bisa diajak chat pribadi. Agent yang sama juga bisa dimasukin ke grup Telegram, jadi satu tim bisa nyuruh agent bareng-bareng dan semua anggota grup bisa lihat hasilnya.

Supaya bisa jalan di grup, ada beberapa pengaturan yang perlu diubah dulu. Di tulisan ini aku bahas langkah-langkahnya, dari BotFather sampai konfigurasi Hermes.

Kenapa Agent Perlu Masuk Grup?

Beberapa contoh yang menurutku berguna:

  • Grup tim support. Agent bisa bantu jawab pertanyaan teknis atau ngerangkum laporan yang masuk.
  • Grup project. Agent bisa bantu bikin ringkasan diskusi atau ngingetin tugas.
  • Grup notifikasi. Agent bisa kirim laporan rutin ke grup, misalnya rekap harian.

Intinya, kalau agent dipakai bareng-bareng, grup itu tempat yang paling praktis.

Sebelum Mulai

Pastiin kamu udah punya agent Hermes yang tersambung ke Telegram dan bisa dichat pribadi. Kalau belum, kamu bisa pakai installer satu perintah yang pernah aku bahas di blog Install Hermes Cukup Dengan 1 Perintah, atau ikutin tutorial di Ngoprek Anshin #2.

Langkah 1: Matiin Privacy Mode di BotFather

Ini bagian yang paling sering bikin bingung.

Secara bawaan, bot Telegram punya privacy mode yang nyala. Dalam mode ini, bot di grup cuma bisa “dengar” perintah yang diawali garis miring (/), balasan ke pesannya sendiri, dan pesan sistem. Obrolan biasa di grup nggak bakal sampai ke bot.

Makanya banyak yang ngeluh, “Kok agent-ku diam aja di grup?” Padahal agent-nya baik-baik aja, cuma pesannya nggak pernah sampai.

Cara matiinnya:

  1. Buka chat @BotFather, kirim /mybots.
  2. Pilih bot kamu.
  3. Masuk ke Bot Settings → Group Privacy → Turn off.

Alternatif lain, kamu bisa jadiin bot sebagai admin grup. Bot yang jadi admin bisa nerima semua pesan, walaupun privacy mode masih nyala.

Note: kalau bot udah terlanjur ada di grup sebelum privacy mode dimatiin, keluarin dulu bot-nya dari grup, terus masukin lagi. Telegram nyimpen pengaturan lama waktu bot pertama kali gabung, jadi perubahannya baru berlaku setelah bot masuk ulang.

Langkah 2: Masukin Bot ke Grup

Buka grup Telegram, ketuk nama grup, pilih Add Members atau Tambah Anggota, terus cari username bot kamu. Kalau mau, sekalian jadiin admin.

Langkah 3: Cari Chat ID Grup

Hermes perlu tahu grup mana aja yang boleh pakai agent. Caranya pakai chat ID, yaitu nomor unik milik grup.

Chat ID grup selalu angka negatif, dan untuk supergroup diawali -100. Contohnya -1xxxxxxxxxx0.

Cara gampang buat lihatnya, buka grup lewat Telegram Web. Chat ID-nya kelihatan di ujung alamat URL, misalnya web.telegram.org/a/#-1xxxxxxxxx0.

Langkah 4: Atur Siapa yang Boleh Nyuruh Agent

Hermes punya beberapa pilihan buat ngatur akses di grup. Tambahin salah satunya di file ~/.hermes/.env:

VariabelFungsinya
TELEGRAM_ALLOWED_USERSUser ID yang boleh nyuruh agent, baik di chat pribadi maupun di grup
TELEGRAM_GROUP_ALLOWED_USERSUser ID yang cuma boleh nyuruh agent di grup, tapi nggak bisa chat pribadi
TELEGRAM_GROUP_ALLOWED_CHATSChat ID grup yang semua anggotanya boleh nyuruh agent

Kalau mau semua anggota grup tim bisa pakai agent, cara paling simpel pakai TELEGRAM_GROUP_ALLOWED_CHATS:

TELEGRAM_GROUP_ALLOWED_CHATS=-1xxxxxxxx0

Kalau grupnya lebih dari satu, pisahin pakai koma.

Tapi hati-hati ya. Dengan pengaturan ini, siapa pun yang ada di grup itu bisa nyuruh agent kamu. Jadi pastiin isinya memang orang-orang yang kamu percaya.

Langkah 5: Biar Agent Cuma Jawab Kalau Dipanggil

Kalau privacy mode udah mati, agent bisa “dengar” semua obrolan di grup. Tanpa pengaturan tambahan, agent bakal nanggepin setiap pesan. Bayangin satu grup lagi ngobrol santai, terus agent ikut nimbrung di tiap chat. Pasti rame banget.

Solusinya, aktifin require_mention di file konfigurasi Hermes (~/.hermes/config.yaml):

telegram:
  require_mention: true

Dengan pengaturan ini, agent cuma bakal jawab kalau:

  • di-mention, misalnya @nama_bot tolong rangkum diskusi tadi,
  • ada yang bales langsung ke pesan agent,
  • ada yang kirim perintah kayak /new@nama_bot.

Setelah semua pengaturan beres, restart agent-nya:

sudo systemctl restart hermes-agent

Tes Pertama di Grup

Setelah semuanya siap, aku coba mention agent-nya di grup dan minta dia ngenalin diri. Nggak lama, agent-nya bales di grup, dan semua anggota bisa lihat jawabannya.

Terus aku coba ngobrol biasa tanpa mention. Agent-nya diam aja, sesuai yang diharapkan karena require_mention udah aktif. Baru pas di-mention lagi, dia ikut jawab.

Kalau Agent Masih Diam di Grup

Cek urutan ini satu per satu:

CekKemungkinan masalahSolusinya
1Pesan nggak sampai ke botMatiin privacy mode atau jadiin bot admin grup
2Pengaturan privacy mode belum berlakuKeluarin bot dari grup, terus masukin lagi
3Pengirim atau grup belum diizininTambahin user ID atau chat ID grup ke variabel akses di .env
4Pesan nggak nge-mention botMention @nama_bot atau bales langsung ke pesan agent
5Konfigurasi belum kebacaRestart agent pakai sudo systemctl restart hermes-agent

Kalau masih belum jalan juga, cek log-nya:

sudo journalctl -u hermes-agent -n 50

Sekarang agent-nya bisa dipakai bareng satu tim. Nggak perlu lagi tiap orang chat pribadi satu per satu. Cukup mention di grup, dan semua orang bisa lihat hasilnya.

Yang paling penting, jangan lupa atur aksesnya dengan benar. Agent di grup itu ibarat rekan kerja baru yang bisa disuruh siapa aja di ruangan itu. Jadi pastiin yang ada di “ruangan” itu memang orang-orang yang kamu percaya.

Kalau kamu nyobain tutorial ini terus nyangkut di salah satu langkah, tulis aja di kolom komentar ya.

Okey, segitu dulu… See you next blog ya guys!

Leave a Reply

Your email address will not be published. Required fields are marked *