LightVela

Kanal Lark

Ringkasan

Kanal Lark cocok untuk lingkungan kerja, mendukung pesan rich text dan @mention bot di obrolan grup, serta dihubungkan dengan cara yang sama seperti WeChat: pilih Lark di bagian Kanal pada konsol, klik untuk memberi otorisasi dan menghasilkan kode QR, lalu pindai dengan Lark untuk mulai berbicara. Anda memerlukan Lark di ponsel (atau sudah masuk di desktop) dan model yang sudah dikonfigurasi (atau cukup kredit model bulanan dari paket Anda). Kanal yang terhubung ke Bot yang sama berbagi persona dan memori jangka panjang Bot tersebut. Bot berbeda memiliki Profile terpisah dengan memori dan skill masing-masing. Pesan chat tidak otomatis menjadi memori jangka panjang hanya karena diterima Bot yang sama.


Kanal Lark cocok untuk skenario perkantoran. Kanal ini mendukung pesan rich text dan mention bot di chat grup. Integrasinya memakai otorisasi kode QR, serupa dengan WeChat.

Yang dibahas di halaman ini

  • Membuat kode QR akses Lark di LightVela

  • Memindai kode QR tersebut dengan Lark untuk memberi otorisasi

  • Mengobrol dengan Hermes Agent di Lark


Langkah-langkah

1. Masuk ke konsol

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

2. Pilih kanal Lark

Temukan kartu Lark di Kanal, lalu pilih + Hubungkan.

Kartu koneksi pada halaman Kanal saat ini

3. Pindai untuk mengotorisasi

Sebuah kode QR akan muncul di halaman tersebut.

4. Pindai dengan Lark

Di ponsel:

  1. Buka Lark

  2. Ketuk "+" di kanan atas → "Scan"

  3. Pindai kode QR di layar komputer Anda

  4. Ikuti petunjuk untuk menyelesaikan otorisasi

5. Temukan Hermes Agent di Lark

Setelah pemindaian berhasil:

  • Pastikan kartu Lark menampilkan Terhubung, lalu kirim pesan uji dari platform tersebut.

  • Lark otomatis menambahkan bot tersebut ke kontak Anda

Cari di Lark dengan nama aplikasi yang Anda buat.

Buka jendela percakapan bot tersebut lalu kirim pesan uji:

Hello

Kondisi berhasil

  • Pastikan kartu Lark menampilkan Terhubung, lalu kirim pesan uji dari platform tersebut.

  • Bot tersebut dapat ditemukan melalui pencarian Lark

  • Mengirim pesan akan mendapat balasan Hermes Agent


Jenis pesan yang didukung

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

Bot Lark — jenis pesan dan fitur yang didukungDidukung
Menerima pesan teks✅ Ya
Menerima gambar✅ Ya
Menerima file✅ Ya
Menerima audio / video✅ Ya
Membalas dengan pesan teks✅ Ya
Membalas dengan gambar✅ Ya
Membalas dengan file✅ Ya
Membalas dengan audio✅ Ya
Isi balasan mendukung Markdown✅ Ya
Mengirim pesan secara proaktif (misalnya pengingat terjadwal)✅ Ya

Chat grup dan izin

Dalam grup internal, buka Settings → Bots → Add Bot di desktop, atau Bots → Add di ponsel. Cari bot aplikasi yang sudah terhubung, tambahkan, lalu kirim pesan uji dengan @mention. Anda harus berada dalam cakupan visibilitas aplikasi, dan pengaturan grup harus mengizinkan penambahan bot serta pengiriman pesan. Periksa syarat ini jika bot tidak muncul. Lark.

Langkah ini untuk grup internal. Grup eksternal memiliki batasan tambahan; periksa aturan resmi platform mengenai jenis grup dan bot. Bot webhook khusus berbeda dari bot aplikasi.

Izin dokumen dan Drive

Menghubungkan kanal pesan tidak memberikan akses ke semua dokumen, Wiki, atau Drive. Operasi sumber daya memerlukan alat atau skill yang sesuai, izin API aplikasi, dan izin akses ke sumber daya tujuan. Aplikasi yang mengakses sumber daya milik orang lain memerlukan otorisasi pemiliknya. Jika izin ditolak, periksa otorisasi dan kepemilikan, lalu uji dengan dokumen yang telah dibagikan secara eksplisit. Lark API.


FAQ

GejalaKemungkinan penyebabPenyelesaian
Pemindaian menampilkan "Application not authorized"Admin tenant membatasi aplikasi pihak ketigaMinta admin tenant Anda mengizinkan aplikasi tersebut, atau beralih ke tenant pribadi
Kontak bot tidak ditemukanLark melipat bot secara defaultCari nama aplikasi Hermes Agent dari bagian atas Lark
Cara menambahkan bot ke grup—Dalam grup internal, buka Settings → Bots → Add Bot di desktop, atau Bots → Add di ponsel
Kode QR kedaluwarsaTidak dipindai dalam masa berlakunyaTutup dialog tersebut lalu klik "Hubungkan" lagi
Tidak ada balasan setelah mengirim pesanModel belum dikonfigurasi atau kredit uji coba habisPeriksa status "Current Model"
Masalah rendering rich textLark tidak mendukung sebagian sintaks MarkdownPercakapan teks biasa tidak terpengaruh

Catatan kanal

  • Jenis pesan: Teks, rich text, gambar, file, audio, video, dan lainnya — lihat "Jenis pesan yang didukung" di atas

  • Dukungan chat grup: Bot dapat ditambahkan ke chat grup dan akan merespons ketika disebut dengan @mention

  • Batasan tenant: Apakah tenant Lark perusahaan mengizinkan bot pihak ketiga bergantung pada kebijakan admin tenant


Langkah berikutnya

Terakhir diperbarui 2026-11-15