LightVela

Kanal QQ

Konfigurasikan QQ Open Platform dan hubungkan kredensial bot ke LightVela.

Kanal QQ memerlukan pembuatan bot di QQ Open Platform, lalu memasukkan AppID dan AppSecret yang dihasilkan ke LightVela. Seluruh prosesnya memakan waktu sekitar 5–10 menit.

Yang dibahas di halaman ini

  • Mendaftar dan membuat bot di QQ Open Platform

  • Mendapatkan AppID dan AppSecret

  • Memasukkan kredensial tersebut ke LightVela untuk menyelesaikan integrasi

  • Mengobrol dengan Hermes Agent di QQ

Langkah-langkah

1. Masuk ke konsol

Masuk ke LightVela, klik "My Hermes" di kanan atas untuk membuka konsol, lalu temukan tombol "Channel".

2. Pilih kanal QQ

Klik dropdown lalu pilih "QQ". Pengantar kanal QQ akan muncul di bawahnya.

3. Daftar di QQ Open Platform

Kunjungi QQ Open Platform lalu pindai kode QR di halaman tersebut memakai aplikasi QQ di ponsel untuk mendaftar / masuk. Pada kunjungan pertama, pemindaian akan otomatis mendaftarkan dan mengikat akun QQ saat ini ke akun Open Platform.

Setelah memindai di aplikasi QQ ponsel dan memilih Agree, pendaftaran selesai dan Anda akan masuk ke halaman konfigurasi bot QQ.

4. Buat bot QQ

Di halaman daftar bot pada QQ Open Platform, klik "Create Bot" untuk membuat bot QQ baru.

5. Dapatkan AppID dan AppSecret

Setelah bot dibuat, temukan AppID dan AppSecret di halaman tersebut. Klik tombol "Copy" di sebelah masing-masing lalu simpan ke file catatan lokal.

Setelah dibuat, QQ otomatis menambahkan bot tersebut ke daftar pesan Anda dan mengirim pesan sambutan. Pada tahap ini, bot belum terikat ke LightVela; mengirim pesan akan menghasilkan balasan "This bot has gone to Mars, try again later" — ini normal, lanjutkan ke langkah berikutnya.

6. Masukkan kredensial di LightVela

Kembali ke kartu "Channel" di konsol, pilih "QQ" dari dropdown, lalu tempel kredensial yang baru Anda salin:

  1. AppID: tempel AppID yang sudah disalin

  2. AppSecret: tempel AppSecret yang sudah disalin

7. Klik "Add and Apply"

LightVela memakai kredensial di atas untuk menghubungkan bot di QQ Open Platform. Setelah beberapa puluh detik, halaman akan menampilkan "Saved successfully", dan entri "QQ" muncul di daftar "Connected Channels".

8. Temukan Hermes Agent di QQ

Buka QQ, temukan bot yang baru Anda buat, lalu kirim pesan uji:

Hello

Anda akan menerima balasan Hermes Agent dalam beberapa detik.

✅ Mention di grup QQ didukung

Setelah pengikatan QQ berhasil, LightVela mengaktifkan kebijakan chat grup QQ milik Hermes secara default. Tambahkan bot tersebut ke grup QQ, lalu sebut bot itu dengan mention untuk memulai percakapan. Kebijakan defaultnya adalah open, yang berarti anggota grup QQ yang memuat bot tersebut dapat menyebutnya dengan mention untuk mengobrol. Pesan grup biasa tanpa mention tidak memicu percakapan.

Kondisi berhasil

  • Bot sudah dibuat di QQ Open Platform

  • Entri "QQ" muncul di daftar "Connected Channels" pada konsol

  • Bot di QQ membalas dengan benar memakai AI

  • Bot membalas di grup QQ ketika disebut dengan mention

Jenis pesan yang didukung

Setelah integrasi, bot QQ mendukung lebih dari teks dasar. Daftar lengkapnya:

Bot QQ — jenis pesan dan fitur yang didukungDidukung
Menerima pesan teks✅ Ya
Menerima gambar✅ Ya
Menerima file✅ Ya
Menerima pesan suara✅ Ya
Membalas dengan pesan teks✅ Ya
Membalas dengan gambar✅ Ya
Membalas dengan file✅ Ya
Isi balasan mendukung Markdown✅ Ya
Mengirim pesan secara proaktif (misalnya pengingat terjadwal)✅ Ya
Mengutip pesan lama❌ Belum

FAQ

GejalaKemungkinan penyebabPenyelesaian
Bot membalas "My 'soul' is offline, please check your host service deployment"AppID / AppSecret belum dikonfigurasi di LightVela, atau kredensialnya salahSalin ulang parameter dari QQ Open Platform, pastikan tidak ada spasi di awal / akhir, lalu masukkan kembali di LightVela
Bot membalas "This bot has gone to Mars, try again later"Bot QQ sudah dibuat tetapi belum terikat ke LightVelaIkuti halaman ini untuk memasukkan AppID / AppSecret
Bot masih tidak membalas setelah semua konfigurasiModel belum dikonfigurasi atau kredit uji coba habisPeriksa status "Current Model" di kartu "1. Model"
AppSecret tidak dapat ditemukanAppSecret hanya terlihat saat pembuatanKlik "Reset Secret" di QQ Open Platform untuk membuat nilai baru, lalu masukkan kembali di LightVela
AppSecret bocor—Buka "Reset Secret" di QQ Open Platform, lalu masukkan AppSecret baru tersebut di LightVela
Kode QR kedaluwarsaTidak dipindai dalam masa berlakunyaTutup dialog tersebut lalu klik "Authorize Access" lagi

Catatan kanal

  • Jenis pesan: Teks, gambar, file, suara, dan lainnya — lihat "Jenis pesan yang didukung" di atas

  • Dukungan chat grup: Mention di grup aktif secara default setelah pengikatan. Konsol menerapkan kebijakan open, yang mengizinkan anggota grup QQ yang memuat bot tersebut menyebutnya dengan mention untuk mengobrol. Untuk membatasi akses ke grup tertentu saja, ubah konfigurasi instans Hermes ke allowlist lalu kelola daftar izinnya di sana; kartu kanal belum menyediakan pengalih ini

  • Pengelolaan kredensial: AppSecret hanya terlihat dalam bentuk plaintext saat pembuatan; jika hilang atau bocor, kredensial tersebut harus direset

Langkah berikutnya

  • Kanal WeCom — Kolaborasi internal perusahaan dan skenario perkantoran

  • Kanal Lark — Skenario perkantoran dengan rich text dan chat grup

  • Konfigurasi Skill — Perluas kemampuan Hermes Agent

Kanal WeChat

Hubungkan Hermes Agent ke WeChat dan pastikan percakapan dapat dijadikan kanal notifikasi.

Kanal WeCom

Siapkan WeCom sebagai kanal percakapan dan notifikasi untuk Hermes Agent.

Di halaman ini

Yang dibahas di halaman iniLangkah-langkah1. Masuk ke konsol2. Pilih kanal QQ3. Daftar di QQ Open Platform4. Buat bot QQ5. Dapatkan AppID dan AppSecret6. Masukkan kredensial di LightVela7. Klik "Add and Apply"8. Temukan Hermes Agent di QQKondisi berhasilJenis pesan yang didukungFAQCatatan kanalLangkah berikutnya