WhatsApp — AI untuk Chat yang Paling Banyak Dipakai di Dunia

WhatsApp ada di mana-mana. Lebih dari dua miliar orang menggunakannya setiap hari, dan sekarang kamu bisa langsung menyambungkan Hermes ke dalamnya. Tanpa akun developer Meta. Tanpa verifikasi bisnis. Tanpa pengaturan API yang rumit. Cukup scan kode QR dan kamu sudah bisa ngobrol dengan agen AI-mu dari aplikasi yang sama yang kamu pakai untuk chat teman-temanmu.

Cara Kerjanya

Hermes terhubung ke WhatsApp melalui jembatan bawaan yang berbasis Baileys. Anggap saja ini seperti meniru sesi WhatsApp Web — sama seperti saat kamu menautkan browser ke ponselmu. Ini bukan WhatsApp Business API resmi, yang artinya kamu tidak butuh persetujuan khusus apa pun untuk memulai.

Jalankan hermes gateway setup dan pilih WhatsApp untuk panduan langkah demi langkah.

Dua Cara Pemakaian

Mode	Cara kerjanya	Paling cocok untuk
Nomor bot terpisah (disarankan)	Dedikasikan satu nomor telepon untuk bot. Orang-orang mengirim pesan langsung ke nomor itu.	UX yang bersih, banyak pengguna, risiko banned lebih rendah
Self-chat pribadi	Pakai WhatsApp-mu sendiri. Kamu mengirim pesan ke dirimu sendiri untuk ngobrol dengan agen.	Setup cepat, pengguna tunggal, uji coba

Pendekatan nomor bot terpisah lebih bersih — AI-mu punya identitas sendiri, dan kamu tidak mencampur chat pribadi dengan percakapan bot. Mode self-chat sangat cocok untuk uji coba cepat.

Sebelum Memulai

Kamu perlu:

Node.js v18+ dan npm — jembatan WhatsApp berjalan sebagai proses Node.js
Ponsel dengan WhatsApp terinstal (untuk scan kode QR)

Kabar baiknya: tidak seperti jembatan berbasis browser yang lama, kamu tidak perlu menginstal Chromium atau Puppeteer. Setup-nya jauh lebih ringan.

Langkah 1: Jalankan Wizard Setup

hermes whatsapp

Wizard akan:

Menanyakan mode mana yang kamu inginkan (bot atau self-chat)
Menginstal dependensi jembatan jika diperlukan
Menampilkan kode QR di terminal-mu
Menunggu kamu untuk memindainya

Untuk scan kode QR:

Buka WhatsApp di ponselmu
Masuk ke Setelan → Perangkat Tertaut
Ketuk Tautkan Perangkat
Arahkan kamera ke kode QR di terminal

Setelah terhubung, wizard mengonfirmasi koneksi dan keluar. Sesi-mu tersimpan otomatis.

Tips: Jika kode QR terlihat berantakan, pastikan terminal-mu memiliki lebar minimal 60 kolom dan mendukung Unicode. Kamu juga bisa mencoba emulator terminal lain.

Langkah 2: Mendapatkan Nomor Telepon Kedua (Mode Bot)

Untuk mode bot, kamu perlu nomor yang belum terdaftar di WhatsApp. Berikut pilihanmu:

Opsi	Biaya	Catatan
Google Voice	Gratis	Khusus AS. Dapatkan nomor di voice.google.com. Verifikasi WhatsApp melalui SMS lewat aplikasi Google Voice.
SIM Prabayar	$5–15 sekali bayar	Operator mana pun. Aktifkan, verifikasi WhatsApp, lalu SIM bisa disimpan di laci. Nomor harus tetap aktif (lakukan panggilan setiap 90 hari).
Layanan VoIP	Gratis–$5/bulan	TextNow, TextFree, atau sejenisnya. Beberapa nomor VoIP diblokir oleh WhatsApp — coba beberapa jika yang pertama tidak berhasil.

Setelah mendapatkan nomor:

Instal WhatsApp di ponsel (atau gunakan aplikasi WhatsApp Business dengan dual-SIM)
Daftarkan nomor baru dengan WhatsApp
Jalankan hermes whatsapp dan scan kode QR dari akun WhatsApp tersebut

Langkah 3: Konfigurasi Hermes

Tambahkan berikut ini ke file ~/.hermes/.env milikmu:

# Wajib
WHATSAPP_ENABLED=true
WHATSAPP_MODE=bot                          # "bot" atau "self-chat"

# Kontrol akses — pilih SALAH SATU dari opsi ini:
WHATSAPP_ALLOWED_USERS=15551234567         # Nomor telepon dipisahkan koma (dengan kode negara, tanpa +)
# WHATSAPP_ALLOWED_USERS=*                 # ATAU gunakan * untuk mengizinkan semua orang
# WHATSAPP_ALLOW_ALL_USERS=true            # ATAU setel flag ini sebagai gantinya (efeknya sama dengan *)

Singkatan izin-semua: Menyetel WHATSAPP_ALLOWED_USERS=* mengizinkan semua pengirim. Untuk menggunakan alur pairing sebagai gantinya, hapus kedua variabel dan andalkan sistem pairing DM.

Pengaturan perilaku opsional di ~/.hermes/config.yaml:

unauthorized_dm_behavior: pair

whatsapp:
  unauthorized_dm_behavior: ignore

unauthorized_dm_behavior: pair adalah default global. Pengirim DM yang tidak dikenal akan mendapatkan kode pairing.
whatsapp.unauthorized_dm_behavior: ignore membuat WhatsApp tetap diam untuk DM yang tidak sah — biasanya pilihan yang lebih baik untuk nomor pribadi.

Lalu mulai gateway:

hermes gateway              # Latar depan
hermes gateway install      # Instal sebagai layanan pengguna
sudo hermes gateway install --system   # Khusus Linux: layanan sistem saat boot

Gateway memulai jembatan WhatsApp secara otomatis menggunakan sesi yang tersimpan.

Persistensi Sesi

Jembatan Baileys menyimpan sesinya di ~/.hermes/platforms/whatsapp/session. Artinya:

Sesi bertahan setelah restart — kamu tidak perlu scan ulang kode QR setiap kali
Data sesi mencakup kunci enkripsi dan kredensial perangkat
Jangan bagikan atau commit direktori sesi ini — direktori ini memberikan akses penuh ke akun WhatsApp

Pairing Ulang

Jika sesi rusak (reset ponsel, pembaruan WhatsApp, ditautkan secara manual), kamu akan melihat error koneksi di log gateway. Untuk memperbaikinya:

hermes whatsapp

Ini akan menghasilkan kode QR baru untuk pairing ulang.

Catatan Peringatan

WhatsApp tidak mendukung secara resmi bot pihak ketiga di luar Business API. Menggunakan jembatan pihak ketiga membawa risiko kecil pembatasan akun. Untuk meminimalkan risiko:

Gunakan nomor telepon khusus untuk bot (bukan nomor pribadimu)
Jangan kirim pesan massal/spam — jaga penggunaan tetap bersifat percakapan
Jangan otomatiskan pesan keluar ke orang yang belum menghubungimu lebih dulu

Selain itu, WhatsApp secara berkala memperbarui protokol Web mereka, yang bisa sementara memutus kompatibilitas dengan jembatan pihak ketiga. Saat ini terjadi, Hermes akan memperbarui dependensi jembatan. Jika bot berhenti bekerja setelah pembaruan WhatsApp, tarik versi Hermes terbaru dan lakukan pairing ulang.

Ingin yang Lebih Resmi?

Jika kamu menjalankan bot bisnis sungguhan dan menginginkan stabilitas, lihat panduan WhatsApp Business Cloud API. Itu adalah jalur resmi yang didukung Meta: tanpa risiko banned akun, tetapi memerlukan akun Meta Business dan URL webhook publik. Kedua adapter juga bisa berjalan paralel dengan nomor telepon berbeda jika kamu punya alasannya.

Namun untuk sebagian besar proyek pribadi dan eksperimen, jembatan Baileys adalah cara tercepat untuk menghadirkan AI ke WhatsApp-mu. Scan, konfigurasi, dan mulai mengobrol.