LightVela

Kanal Telegram

Ringkasan

Kanal Telegram dihubungkan dengan bot token, sehingga menjadi cara cepat membawa Hermes Agent ke pesan pribadi atau grup Telegram: buat bot melalui BotFather di Telegram, salin bot token-nya, lalu tempelkan ke bagian Kanal pada konsol LightVela. Anda memerlukan akun Telegram dan model yang sudah dikonfigurasi (atau cukup kredit model bulanan dari paket Anda). Bot token adalah kredensial sensitif — jangan dibagikan secara publik. Setelah terhubung, Agent di Telegram berbagi persona dan memori jangka panjang yang sama dengan kanal lain.


Kanal Telegram memakai akses Bot Token dan cocok untuk menghubungkan Hermes Agent dengan cepat ke chat pribadi atau grup Telegram.

Yang dibahas di halaman ini

  • Memberi otorisasi akses dengan memindai kode atau membuka tautan di Telegram pada ponsel Anda

  • Mengobrol dengan Hermes Agent di Telegram


Langkah-langkah

1. Masuk ke konsol

Masuk ke LightVela, pilih Bot yang dituju, lalu buka Sehari-hari → Kanal di konsol.

2. Pilih kanal Telegram

Temukan kartu Telegram lalu klik "+ Connect".

3. Buka Telegram

  1. Buka aplikasi Telegram di ponsel Anda

  2. Cari @BotFather lalu buka percakapannya

Cari BotFather di Telegram
  1. Kirim /start

  2. Kirim /newbot

  3. Masukkan nama untuk Agent Anda: username harus unik dan diakhiri dengan "bot"

  4. Salin HTTP API token:

4. Hubungkan Bot di LightVela

Kembali ke LightVela, pilih Bot tujuan dan buka Sehari-hari → Kanal → Telegram. Masukkan HTTP API Token dari BotFather, pilih cakupan akses, kirim dan tunggu status terhubung. Token adalah kredensial; jangan kirim ke chat biasa, grup atau posting publik.

Pintu koneksi Telegram di LightVela

Cakupan akses: siapa yang boleh menggunakan bot ini

Anda dapat memilih cakupan akses saat menghubungkan. Nilai bawaan adalah "Siapa pun boleh menggunakan", sama seperti perilaku sebelumnya:

Cakupan aksesEfek
Siapa pun boleh menggunakan (bawaan)Siapa pun yang menemukan bot dapat berbicara dengan Agent Anda dan menggunakan kredit Anda
Hanya pengguna tertentu (disarankan)Hanya pengguna Telegram yang ada dalam daftar yang dapat mengobrol dengan bot ini

Saat memilih "Hanya pengguna tertentu", masukkan ID pengguna Telegram yang diizinkan:

  • Hanya ID berupa angka; pisahkan beberapa pengguna dengan koma atau spasi
  • ID pertama menjadi target notifikasi bawaan, yakni tempat hasil tugas terjadwal dikirim

Untuk mengetahui ID pengguna Telegram Anda sendiri, cari @userinfobot di Telegram lalu kirim pesan apa saja; Id yang dikembalikan (angka) adalah ID pengguna Anda. Agar orang lain juga dapat menggunakan bot, tambahkan ID pengguna mereka ke dalam daftar.

5. Mengobrol dengan bot baru di Telegram

Klik tautan yang diberikan BotFather lalu mulai berinteraksi dengan bot tersebut.

Buka percakapan dengan bot tersebut lalu kirim pesan uji:

Hi

Anda semestinya menerima balasan Hermes Agent dalam beberapa detik.

Periksa balasan Bot di Telegram

6. Opsional: Aktifkan pesan grup di BotFather

Selesaikan langkah 6 dan 7 hanya jika Anda ingin menggunakan Bot di grup. Pesan langsung sudah dapat digunakan setelah langkah 5.

  1. Buka @BotFather di Telegram.
  2. Kirim /mybots.
  3. Pilih Bot yang sudah terhubung ke Hermes Agent Anda.
  4. Buka "Bot Settings".
  5. Pilih "Group Privacy".
  6. Pilih "Turn off" atau "Disable privacy mode".

7. Opsional: Tambahkan dan uji Bot di grup

  1. Buka grup Telegram yang ingin digunakan.
  2. Pilih "Add Members" atau tindakan pengelolaan grup yang setara.
  3. Cari Bot berdasarkan username-nya lalu tambahkan ke grup.
  4. Sebut Bot dengan @username_bot lalu kirim pesan uji.

Setelah Group Privacy dinonaktifkan, bot dapat menerima dan membalas pesan grup yang menyebutnya.


Kondisi berhasil

  • Kartu Telegram milik Bot tujuan menunjukkan Terhubung.

  • Bot terkait dapat ditemukan di kontak Telegram

  • Hermes Agent membalas setelah Anda mengirim pesan

  • Hermes Agent membalas setelah Anda menyebut bot dan mengirim pesan di grup tempat bot telah ditambahkan


Jenis pesan yang didukung

Setelah akses berhasil, bot Telegram dapat menerima dan membalas pesan teks dasar serta mendukung lebih banyak jenis pesan berikut:

Jenis pesan yang didukung bot TelegramDidukung
Menerima pesan teks✅ Didukung
Menerima gambar dan video✅ Didukung
Menerima file✅ Didukung
Membalas dengan pesan teks✅ Didukung
Membalas dengan gambar dan video✅ Didukung
Membalas dengan file✅ Didukung
Mengirim pesan secara proaktif (seperti pengingat terjadwal)✅ Didukung

FAQ

MasalahKemungkinan penyebabSolusi
BotFather tidak dapat membuat botNama bot atau username tidak memenuhi ketentuan TelegramNama tampilan boleh apa saja, tetapi username harus diakhiri bot, misalnya my_hermes_bot
BotFather tidak mengembalikan HTTP API tokenAlur pembuatan belum selesaiKembali ke percakapan BotFather, jalankan /newbot lagi, lalu ikuti petunjuk untuk mengatur nama dan username
Token dianggap tidak valid setelah ditempelToken tidak lengkap atau mengandung spasi / baris baru tambahanSalin ulang HTTP API token secara lengkap dari BotFather lalu tempel ke kolom token
Tidak ada respons setelah mengklik aksesKeterlambatan jaringan atau otorisasi belum selesaiSegarkan konsol untuk memastikan status; jika akses belum berhasil, coba lagi
Bot tidak dapat ditemukan di TelegramAnda belum mengklik tautan dari BotFather, atau belum memulai percakapanKlik tautan yang diberikan BotFather, lalu klik Start di halaman bot
Tidak ada balasan setelah mengirim pesanModel belum dikonfigurasi, kredit uji coba habis, atau bot belum berhasil terhubungPilih Bot tujuan, periksa model utama dan kuota pada halaman Model, lalu pastikan kartu Telegram terhubung dan uji pesan.
Bot tidak dapat menerima pesan grupGroup Privacy masih aktif, bot belum ditambahkan ke grup, atau pesan tidak menyebut botDi BotFather, kirim /mybots, pilih bot, lalu buka "Bot Settings" → "Group Privacy" dan nonaktifkan privacy mode. Tambahkan bot ke grup dan kirim pesan uji dengan @username_bot
Pengguna Telegram lain juga dapat menggunakan bot sayaCakupan akses bawaan adalah "Siapa pun boleh menggunakan"Pada kartu Telegram, pilih Hubungkan ulang, pilih "Hanya pengguna tertentu" lalu masukkan ID pengguna yang diizinkan
Bagaimana cara menemukan ID pengguna Telegram saya—Cari @userinfobot di Telegram lalu kirim pesan apa saja; Id yang dikembalikan adalah ID pengguna Anda
Hasil tugas terjadwal dikirim ke orang yang salahID pertama dalam daftar digunakan sebagai target notifikasi bawaanHubungkan ulang dan letakkan pengguna yang seharusnya menerima notifikasi di urutan pertama
Cara memutuskan tautan—Pilih Putuskan koneksi pada kartu Telegram milik Bot tujuan, ikuti konfirmasi lalu periksa status kartu.
Apakah satu bot Telegram yang sama dapat terhubung ke beberapa instans Hermes AgentTidak disarankan; satu Bot Token sebaiknya terikat pada satu Hermes AgentJika Anda memerlukan beberapa instans Hermes Agent, buat bot Telegram terpisah

Catatan kanal

  • Jenis pesan: Mendukung teks, gambar, video, file, pesan suara, dan lainnya. Lihat "Jenis pesan yang didukung" di atas

  • Dukungan chat grup: Pesan grup didukung setelah Anda menonaktifkan Group Privacy di BotFather, menambahkan bot ke grup, dan memulai percakapan dengan @username_bot

  • Cakupan akses: Nilai bawaan adalah "Siapa pun boleh menggunakan"; pilih "Hanya pengguna tertentu" dan masukkan ID pengguna untuk membatasi siapa yang boleh menggunakan bot

  • Koneksi terputus: Tidak ada respons dalam waktu lama dapat menandakan otorisasi sudah dicabut. Kembali ke konsol lalu berikan otorisasi akses lagi


Langkah berikutnya

  • Kanal WhatsApp — Komunikasi pengguna internasional dan layanan pelanggan

  • Kanal Discord — Operasional komunitas dan komunitas developer

  • Kanal Slack — Kolaborasi tim, notifikasi workspace, dan alur kerja kanal

  • Kanal QQ — Bot dibuat manual, diintegrasikan via AppID/AppSecret

  • Konfigurasi Skill — Perluas kemampuan Hermes Agent

Terakhir diperbarui 2026-10-19