Cara Hubungkan Hermes Agent ke WhatsApp

Kalau artikel 2 November membahas koneksi Hermes ke Telegram, sedangkan artikel 8 November membedah bot Telegram yang diam, artikel ini mengambil jalur berbeda: memasang koneksi WhatsApp baru. Hermes menyediakan dua pilihan, dan pilihan yang tepat bergantung pada apakah Anda ingin uji coba pribadi atau bot bisnis yang lebih resmi. Jika Telegram sudah dipakai, lihat juga panduan menghubungkan Hermes Agent ke Telegram.

Kenali dua jalurnya

1. WhatsApp bridge dengan Baileys

Bridge ini bekerja dengan meniru sesi WhatsApp Web melalui Baileys. Setup-nya cepat, dapat memakai akun personal, dan tidak membutuhkan akun Meta atau webhook publik. Karena bukan WhatsApp Business API resmi, jalur ini berstatus unofficial. Ada risiko nomor dibatasi atau bahkan diblokir WhatsApp.

Untuk mengurangi dampaknya, gunakan nomor sekunder khusus bot, bukan nomor utama. Hindari spam, pengiriman massal, dan pesan otomatis kepada orang yang belum lebih dulu menghubungi Anda. Pahami risikonya sebelum melakukan pairing. Sesi yang tersimpan juga bersifat sensitif karena dapat memberi akses ke akun, jadi jangan membagikan folder kredensialnya.

Cara umumnya:

1. Jalankan hermes gateway setup, lalu pilih WhatsApp pada wizard.
2. Ikuti pilihan mode yang ditampilkan, misalnya bot atau self-chat.
3. Saat QR muncul di terminal, buka WhatsApp di ponsel, masuk ke Setelan/Settings > Perangkat tertaut/Linked Devices > Tautkan perangkat, lalu pindai QR. Nama menu dapat sedikit berbeda menurut bahasa dan versi aplikasi.
4. Setelah pairing berhasil, jalankan gateway dan uji dengan pesan sederhana. Jika sesi putus setelah pembaruan WhatsApp, dokumentasi Hermes menyarankan menjalankan kembali perintah pairing dan memindai QR baru.

Dokumentasi bridge juga menampilkan hermes whatsapp sebagai wizard khusus. Perintah itu dapat berubah mengikuti versi Hermes, jadi prioritaskan bantuan yang muncul dari instalasi Anda.

2. WhatsApp Business Cloud API

Jalur ini memakai WhatsApp Business Cloud API resmi Meta dan lebih cocok untuk kebutuhan bisnis. Anda memerlukan akun Meta Business, nomor bisnis khusus, serta aplikasi WhatsApp di Meta. Hermes juga harus dapat menerima webhook melalui URL HTTPS publik agar Meta bisa mengirim pesan masuk.

Mulailah dari hermes gateway setup dan pilih opsi WhatsApp yang tersedia, atau gunakan wizard Cloud yang disebut dokumentasi versi Anda. Siapkan kredensial yang diminta wizard, jalankan gateway, lalu ikuti instruksi untuk mengekspos endpoint webhook dan mendaftarkan callback di dashboard Meta. Pastikan URL publik, token verifikasi, dan konfigurasi webhook cocok; jangan menebak nilai atau nama field jika wizard menampilkannya berbeda.

Cloud API tidak memakai QR pairing. Pengiriman pesan juga mengikuti aturan Meta, termasuk ketentuan template untuk pesan yang dikirim di luar jendela layanan pelanggan. Karena konfigurasi Meta dan tampilan dashboard dapat berubah, selesaikan verifikasi dari petunjuk wizard dan dokumentasi resmi, bukan dari contoh lama.

Pilih yang mana?

Untuk eksperimen pribadi yang cepat, bridge Baileys lebih sederhana, tetapi gunakan nomor sekunder dan terima risiko pembatasan akun. Untuk operasi bisnis, Cloud API lebih tepat karena jalurnya resmi, walau perlu webhook publik, akun bisnis, dan kepatuhan aturan pesan Meta. Setelah aktif, batasi pengirim yang boleh memicu agen dan uji koneksi sebelum dipakai rutin.

Catatan: perintah dan nama menu Hermes dapat berubah antarversi. Periksa dokumentasi resmi sebelum menjalankan setup, terutama ketika memilih adapter WhatsApp Cloud.