Hermes Agent + WhatsApp

Hubungkan Hermes Agent ke WhatsApp Lewat MCP Kirimi

Tambahkan satu server MCP ke config Hermes, login OAuth, lalu agen bisa membaca inbox WhatsApp bisnis Anda dan mengirim pesan setelah Anda setuju. Tidak ada bridge Node.js yang perlu Anda jalankan.

Butuh paket Basic atau Pro. Diperbarui , fakta Hermes dari dokumentasi resminya.

Pemilik toko memberi perintah dari laptop, lalu robot asisten bersayap mengantar balon chat ke ponsel
Jawaban Singkat

Bagaimana Cara Hermes Agent Terhubung ke WhatsApp?

Hermes Agent punya dua jalur WhatsApp bawaan: bridge Baileys (scan QR, tidak resmi) dan WhatsApp Cloud API resmi Meta. Jalur ketiga adalah MCP. Tambahkan server Kirimi https://api.kirimi.id/mcp ke ~/.hermes/config.yaml, login OAuth, lalu Hermes bisa membaca inbox WhatsApp bisnis Anda, mencari kontak, dan mengirim pesan atau template WABA setelah Anda setuju.

Bridge Baileys (bawaan)

Scan QR dari terminal dan butuh Node.js v20 ke atas. Sesi dijaga di mesin Anda sendiri. Dokumentasi Hermes menyebut jalur ini membawa risiko pembatasan akun dan menyarankan nomor khusus.

WhatsApp Cloud API (bawaan)

Jalur resmi Meta. Butuh Meta app, akun WABA, dan webhook HTTPS publik. Hanya pesan langsung, tanpa grup, dan template belum didukung.

MCP Kirimi

WhatsApp menjadi tool yang dipakai Hermes. Sesi nomor ada di Kirimi, izin diatur lewat OAuth, dan template WABA bisa dikirim.

Bedanya

Lewat MCP, Anda tidak ngobrol dengan Hermes di WhatsApp. Anda memerintah Hermes dari terminal atau channel lain, lalu Hermes bekerja di WhatsApp bisnis Anda.

Perbandingan

Tiga Jalur WhatsApp untuk Hermes Agent

Dua jalur pertama adalah bawaan Hermes dan menjadikan WhatsApp tempat ngobrol dengan agen. Jalur MCP menjadikan WhatsApp sebagai tool kerja agen.

Perbandingan bridge Baileys, WhatsApp Cloud API, dan MCP Kirimi untuk Hermes Agent
FiturBridge Baileys (bawaan)Cloud API (bawaan)MCP Kirimi
Penyiapan
Cara menyambungScan QR dari terminal (hermes whatsapp)Meta app, akun WABA, dan token aksesTambah alamat server, lalu login OAuth
Yang Anda jalankan sendiriBridge Node.js v20+ di mesin HermesWebhook HTTPS publik (port default 8090)Tidak ada. Server MCP dan sesi nomor ada di Kirimi
Kemampuan
Peran WhatsAppChannel untuk ngobrol dengan agenChannel untuk ngobrol dengan agenTool: agen membaca inbox dan mengirim atas perintah Anda
Grup WhatsAppYa, lewat pengaturan grupTidak, hanya pesan langsungBelum ada tool khusus grup
Pesan di luar jendela 24 jamTidak berlaku (bukan API resmi)Gagal dengan error 131047; template belum didukungNomor WABA: kirim template yang sudah disetujui Meta
Risiko dan biaya
Risiko pembatasan akunAda. Dokumentasi Hermes menyebutnya "unofficial and ban-prone"Jalur resmi. Dokumentasi Hermes menyebut tidak ada risiko banned; aturan pesan Meta tetap berlakuNomor QR: ada, sama-sama tidak resmi. Nomor WABA: jalur resmi
Biaya layananTidak ada biaya layanan WhatsAppMengikuti tarif pesan MetaPaket Basic Rp49.000 atau Pro Rp99.000 per bulan

Data Hermes per 17 November 2026, dari Hermes Agent: WhatsApp (bridge Baileys), Hermes Agent: WhatsApp Cloud API, Hermes Agent: MCP. Hermes Agent adalah proyek open source Nous Research. Kirimi tidak berafiliasi dengan Nous Research.

Cara Hubungkan

Lima Langkah Menyambungkan Hermes ke Kirimi

  1. 1

    Siapkan akun dan nomor di Kirimi

    Pakai paket Basic atau Pro, lalu hubungkan minimal satu nomor WhatsApp di dashboard: scan QR untuk nomor biasa, atau akun WABA untuk jalur resmi.

  2. 2

    Tambahkan server MCP ke config Hermes

    Buka ~/.hermes/config.yaml dan tambahkan kirimi di bawah mcp_servers dengan auth: oauth. Tidak ada API key yang perlu disalin.

  3. 3

    Login dan pilih izin

    Jalankan hermes mcp login kirimi. Browser membuka halaman persetujuan Kirimi. Pilih nomor yang boleh diakses dan izin yang diberikan. Izin baca aktif secara default. Izin kelola, kirim pesan, dan OTP harus Anda centang sendiri.

  4. 4

    Tes sambungan

    Jalankan hermes mcp test kirimi. Kalau Hermes sedang berjalan, ketik /reload-mcp di sesi agar daftar tool dimuat ulang.

  5. 5

    Mulai dari perintah baca

    Contoh: "Tampilkan 5 chat WhatsApp terakhir yang belum dibalas." Tool Kirimi muncul di Hermes dengan awalan mcp_kirimi_, misalnya mcp_kirimi_list_conversations.

~/.hermes/config.yaml
mcp_servers:
  kirimi:
    url: https://api.kirimi.id/mcp
    auth: oauth
Terminal
# login OAuth, browser membuka halaman persetujuan Kirimi
hermes mcp login kirimi

# cek sambungan dan daftar tool
hermes mcp test kirimi

# di dalam sesi Hermes yang sedang berjalan
/reload-mcp

Format config dan perintah mengikuti dokumentasi MCP Hermes Agent. Untuk Hermes di server tanpa browser, dokumentasi yang sama menjelaskan cara menempel URL redirect ke terminal dan port forward SSH.

Kemampuan

Yang Bisa Dilakukan Hermes di WhatsApp Anda

Server remote Kirimi menyediakan 16 tool dalam empat kelompok. Hermes hanya melihat tool yang izinnya Anda berikan.

Baca (izin default)

Daftar nomor dan statusnya, daftar percakapan yang bisa difilter (misalnya belum dibalas), isi percakapan, pencarian kontak, dan daftar template WABA.

  • list_devices
  • get_device_status
  • list_conversations
  • get_conversation_messages
  • search_contacts
  • list_templates

Kelola

Menambah catatan internal di percakapan, mengubah status percakapan, memberi label ke kontak, dan menambah perangkat WhatsApp. Izin ini harus dicentang saat login.

  • add_conversation_note
  • set_conversation_status
  • set_contact_tag
  • add_device

Kirim pesan dan template

Selalu dua langkah. Pesan disiapkan dulu dan Hermes menampilkan ringkasannya, lalu baru dikirim setelah dikonfirmasi. Token konfirmasi berlaku 10 menit dan sekali pakai. Izin kirim harus dicentang saat login.

  • prepare_message
  • prepare_template
  • confirm_send

OTP

Menyiapkan, mengirim, dan memverifikasi kode OTP lewat WhatsApp dengan pola dua langkah yang sama. Izin OTP harus dicentang saat login.

  • prepare_otp
  • confirm_otp
  • verify_otp

Batas per koneksi: baca 60 per menit, kelola 20 per menit, kirim 10 per menit dan 200 per jam, OTP 3 per menit dan 30 per jam. Satu panggilan membaca maksimal 50 pesan.

Contoh Perintah ke Hermes

Tulis dalam bahasa biasa. Hermes memilih tool Kirimi yang sesuai.

Rangkum chat yang belum dibalas

"Rangkum chat WhatsApp yang belum dibalas sejak kemarin, urutkan dari yang paling mendesak."

Siapkan balasan

"Buat draf balasan untuk chat dari Budi soal jadwal kirim. Tampilkan dulu sebelum dikirim."

Follow up dengan template WABA

"Kirim template pengingat pembayaran ke 0812-xxxx-1234." Berguna saat jendela 24 jam sudah lewat.

Rapikan kontak

"Beri label Prospek ke kontak yang menanyakan harga minggu ini."

Catatan untuk tim

"Tambahkan catatan internal di percakapan ini: pelanggan minta invoice ulang."

Cek status nomor

"Nomor WhatsApp mana yang sedang terputus?"

Masalah Umum

WhatsApp Hermes Agent Terputus atau QR Gagal?

Ini masalah yang dicatat dokumentasi Hermes untuk jalur bawaannya, beserta cara mengatasinya.

  • QR tidak bisa di-scan

    Lebarkan terminal sampai 60 kolom atau lebih, coba terminal lain, dan pastikan Anda scan dengan akun WhatsApp milik bot.

  • QR kedaluwarsa

    Kode QR berganti kira-kira tiap 20 detik. Jalankan ulang hermes whatsapp kalau waktunya habis.

  • Tiba-tiba logout

    WhatsApp memutus perangkat tertaut yang lama tidak aktif. Jaga ponsel tetap online dan pasangkan ulang bila perlu.

  • Berhenti setelah WhatsApp update

    Perbarui Hermes agar bridge ikut baru, lalu pasangkan ulang.

  • Bridge crash atau reconnect terus

    Restart gateway dan perbarui Hermes. Pasangkan ulang kalau perubahan protokol membuat sesi tidak berlaku.

  • Pesan tidak masuk

    Cek apakah nomor pengirim ada di WHATSAPP_ALLOWED_USERS, lalu nyalakan WHATSAPP_DEBUG untuk melihat bridge.log.

  • Error 131047 di Cloud API

    Pesan dikirim di luar jendela 24 jam. Di luar jendela itu Meta mewajibkan template, dan adapter Cloud API Hermes belum mendukung template.

  • Token Cloud API mati setelah sehari

    Token akses sementara berlaku 24 jam. Untuk produksi, pakai token System User.

Kalau tujuan Anda adalah agen yang mengurus WhatsApp bisnis, jalur MCP tidak melewati langkah-langkah di atas: tidak ada bridge yang dijalankan di mesin Hermes, dan pembaruan mesin WhatsApp diurus Kirimi. Nomor yang dihubungkan dengan QR tetap bisa terputus dan perlu scan ulang dari dashboard Kirimi.

Pilih dengan Jujur

Risiko Banned dan Kapan MCP Kirimi Cocok

Jujur soal risiko

Nomor yang dihubungkan ke Kirimi lewat scan QR juga memakai gateway tidak resmi, sama seperti bridge Baileys. WhatsApp bisa membatasi atau memblokir nomor, dan tidak ada layanan yang bisa menjamin sebaliknya. Yang berbeda adalah siapa yang merawat sesinya. Untuk jalur resmi, pakai akun WhatsApp Business API (WABA) di Kirimi, dan hindari pengiriman massal ke orang yang belum pernah menghubungi Anda.

Cocok kalau

  • Anda ingin Hermes membantu mengurus inbox WhatsApp bisnis: merangkum chat, menyiapkan balasan, dan memberi label kontak.
  • Anda perlu mengirim template WABA di luar jendela 24 jam, yang belum bisa dilakukan adapter Cloud API Hermes.
  • Anda tidak mau menjalankan dan merawat bridge Node.js atau webhook publik sendiri.
  • Anda ingin izin yang dibatasi per nomor dan bisa dicabut kapan saja dari dashboard.

Tetap pakai jalur bawaan kalau

  • Anda hanya ingin ngobrol dengan Hermes pribadi lewat WhatsApp. MCP Kirimi tidak menjadikan WhatsApp sebagai channel obrolan dengan agen.
  • Anda butuh agen ikut membalas di grup WhatsApp. Pakai bridge Baileys bawaan dengan pengaturan grupnya.
  • Anda ingin pelanggan dibalas otomatis tanpa Anda perintah. Untuk itu pakai AI Agent atau Chatbot Flow di dashboard Kirimi, bukan MCP.
  • Anda tidak butuh fitur chat Kirimi dan tidak ingin berlangganan paket Basic atau Pro.

Pertanyaan tentang Hermes Agent dan WhatsApp

Sambungkan Hermes ke WhatsApp Bisnis Anda

Daftar, hubungkan satu nomor, lalu tambahkan server MCP Kirimi ke config Hermes. Mulai dari perintah baca dulu.

Butuh bantuan?

Tim CS siap membantu via WhatsApp

Chat CS