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.

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.
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.
| Fitur | Bridge Baileys (bawaan) | Cloud API (bawaan) | MCP Kirimi |
|---|---|---|---|
| Penyiapan | |||
| Cara menyambung | Scan QR dari terminal (hermes whatsapp) | Meta app, akun WABA, dan token akses | Tambah alamat server, lalu login OAuth |
| Yang Anda jalankan sendiri | Bridge Node.js v20+ di mesin Hermes | Webhook HTTPS publik (port default 8090) | Tidak ada. Server MCP dan sesi nomor ada di Kirimi |
| Kemampuan | |||
| Peran WhatsApp | Channel untuk ngobrol dengan agen | Channel untuk ngobrol dengan agen | Tool: agen membaca inbox dan mengirim atas perintah Anda |
| Grup WhatsApp | Ya, lewat pengaturan grup | Tidak, hanya pesan langsung | Belum ada tool khusus grup |
| Pesan di luar jendela 24 jam | Tidak berlaku (bukan API resmi) | Gagal dengan error 131047; template belum didukung | Nomor WABA: kirim template yang sudah disetujui Meta |
| Risiko dan biaya | |||
| Risiko pembatasan akun | Ada. Dokumentasi Hermes menyebutnya "unofficial and ban-prone" | Jalur resmi. Dokumentasi Hermes menyebut tidak ada risiko banned; aturan pesan Meta tetap berlaku | Nomor QR: ada, sama-sama tidak resmi. Nomor WABA: jalur resmi |
| Biaya layanan | Tidak ada biaya layanan WhatsApp | Mengikuti tarif pesan Meta | Paket 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.
Lima Langkah Menyambungkan Hermes ke Kirimi
- 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
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
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
Tes sambungan
Jalankan hermes mcp test kirimi. Kalau Hermes sedang berjalan, ketik /reload-mcp di sesi agar daftar tool dimuat ulang.
- 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.
mcp_servers:
kirimi:
url: https://api.kirimi.id/mcp
auth: oauth# 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-mcpFormat 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.
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_devicesget_device_statuslist_conversationsget_conversation_messagessearch_contactslist_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_noteset_conversation_statusset_contact_tagadd_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_messageprepare_templateconfirm_send
OTP
Menyiapkan, mengirim, dan memverifikasi kode OTP lewat WhatsApp dengan pola dua langkah yang sama. Izin OTP harus dicentang saat login.
prepare_otpconfirm_otpverify_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?"
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.
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.
Bacaan lanjutan
- MCP WhatsApp: hubungkan AI ke inbox WhatsApp lewat Kirimi
- WhatsApp MCP server: tidak resmi vs API resmi
- Aman tidak AI membaca chat WhatsApp? Risiko dan cara menjaganya
- 10 prompt untuk merangkum chat WhatsApp yang belum dibalas
- Claude Code + WhatsApp: setup MCP dari terminal
Lihat juga dokumentasi API dan harga paket.
Pertanyaan tentang Hermes Agent dan WhatsApp
Bisa, lewat tiga jalur. Dua jalur bawaan Hermes adalah bridge Baileys dengan scan QR dan WhatsApp Cloud API resmi Meta. Jalur ketiga adalah server MCP seperti Kirimi, yang menjadikan WhatsApp sebagai tool bagi agen.
Tambahkan server kirimi dengan url https://api.kirimi.id/mcp dan auth: oauth di bawah mcp_servers pada ~/.hermes/config.yaml. Jalankan hermes mcp login kirimi, pilih nomor dan izin di halaman persetujuan Kirimi, lalu tes dengan hermes mcp test kirimi.
Bisa, kalau memakai jalur tidak resmi. Dokumentasi Hermes menyebut bridge Baileys membawa risiko pembatasan akun dan menyarankan nomor khusus. Nomor yang dihubungkan ke Kirimi lewat QR juga jalur tidak resmi dengan risiko serupa. Jalur resminya adalah WhatsApp Cloud API atau akun WABA.
Tidak lewat MCP. MCP Kirimi membuat Hermes bisa membaca dan mengirim pesan di WhatsApp bisnis Anda, tetapi Anda tetap memberi perintah dari terminal atau channel lain. Untuk ngobrol dengan agen lewat WhatsApp, pakai jalur bawaan Hermes.
Tidak. MCP bukan bot auto-reply: pesan masuk tidak didorong ke Hermes, dan setiap pengiriman melewati dua langkah, yaitu disiapkan lalu dikonfirmasi. Untuk balasan otomatis ke pelanggan, pakai AI Agent atau Chatbot Flow di dashboard Kirimi.
Server MCP remote tersedia untuk paket Basic (Rp49.000 per bulan) dan Pro (Rp99.000 per bulan), karena memakai fitur chat. Paket Lite belum bisa.
Tidak. Server remote Kirimi memakai OAuth. Hermes menyimpan token hasil login, dan Anda bisa mencabut aksesnya dari dashboard Kirimi kapan saja.
Bisa, lewat tool prepare_template lalu confirm_send, untuk template yang sudah disetujui Meta. Template dengan header gambar, video, atau dokumen belum didukung.
Dokumentasi MCP Hermes menyediakan beberapa cara untuk login OAuth dari mesin tanpa browser, antara lain menempel URL redirect ke terminal dan port forward SSH. Halaman persetujuannya tetap dibuka di browser perangkat Anda.
Sambungkan Hermes ke WhatsApp Bisnis Anda
Daftar, hubungkan satu nomor, lalu tambahkan server MCP Kirimi ke config Hermes. Mulai dari perintah baca dulu.

