Halo, Sob! Artikel ini akan membahas cara menghubungkan WhatsApp dengan n8n untuk membuat otomatisasi tugas. Integrasi ini dapat dimanfaatkan, misalnya oleh tim Customer Service, agar bisa memberikan respon cepat kepada pelanggan.
Untuk melakukan integrasi, dibutuhkan API WhatsApp.Secara umum, ada dua jenis API, yaitu Official yang berasal dari WhatsApp resmi dan Unofficial. Perbedaannya, yang official terdapat limitasi penggunaan 1000 chat per bulan pada versi gratis. Sedangkan, versi unofficial dapat digunakan secara gratis tetapi rentan dibanned jika diidentifikasi ada penggunaan tidak normal, misalnya mengirim pesan broadcast ke banyak kontak.
Dan di artikel ini, akan mendemokan menggunakan API WhatsApp versi gratis (unofficial) yaitu WAHA. Dengan WAHA kamu dapat dengan mudah menghubungkan kontak WA ke proyek di n8n. Yuk, simak caranya di bawah ini!
Langkah-Langkah Untuk Menguhubungkan WhatsApp dengan n8n
STEP 1: Instal WAHA di VPS
Pertama, buat koneksi SSH ke layanan n8n kamu melalui terminal. Jika menggunakan sistem operasi Windows, kamu bisa menggunakan PuTTY.
Untuk koneksi SSH, isi username sebagai root dan bagian password gunakan yang tertera pada informasi akses panelnya.
Cara mengetahui detail informasi awal layanan ada di artikel Informasi Awal Layanan VM.
Karena WAHA ini memerlukan docker untuk instalasinya jadi kamu harus menginstal docker di VPS jika belum ada. Pastikan docker kamu minimal versi 26.1.3. Di Jagoan Hosting, layanan n8n sudah terinstal docker jadi langsung jalankan perintah di bawah ini untuk instal WAHA.
# Download the env file template
wget -O .env https://raw.githubusercontent.com/devlikeapro/waha/refs/heads/core/.env.example
# Download the Docker compose template
wget -O docker-compose.yaml https://raw.githubusercontent.com/devlikeapro/waha/refs/heads/core/docker-compose.yaml
Kemudian, jalankan proyek WAHA menggunakan perintah docker berikut.
docker run -d -p 3001:3000 --name waha --restart unless-stopped devlikeapro/waha
Setelah itu, kamu bisa akses WAHA melalui http://ip-server:3001. Lalu, buka halaman admin WAHA dengan klik Dashboard.
Nah, nanti kamu akan mengintegrasikan dengan WhatsApp di bagian Sessions ini.
STEP 2: Instal Modul WAHA di n8n
Buka n8n lalu klik ikon titik tiga disamping ikon profil dan pilih Settings.
Pilih menu Community nodes lalu klik Install a community node.
Pada pop-up yang muncul, klik Browse untuk mencari modul WAHA.
Masukkan kata kunci pencarian ‘waha’ lalu pada hasil pencarian teratas, salin nama modulnya.
Kembali lagi ke pop-up dan masukkan nama modul WAHA yang sudah disalin kemudian centang persetujuan lanjut klik Install untuk menginstal modul WAHA.
STEP 3: Buat Workflow dan Konfigurasi WAHA API
Setelah menambahkan modul WAHA, buat workflow baru lalu tambahkan WAHA trigger. Cara membuat workflow ada di artikel Mengenal Interface n8n (Node, WorkFlow, dan Credential)
Buka workflow yang sudah dibuat kemudian tambahkan node WAHA Trigger.
Akan muncul pop-up Parameters seperti gambar di bawah. Di sini kamu perlu mengambil URL webhook Test URL dan Production URL untuk dikonfigurasi pada WAHA API.
Kembali ke WAHA API di bagian Sessions buka Configuration.
Tambahkan dua webhook URL tadi dengan klik tombol + Webhook. Pastikan di bagian Events pilih message. Dan pengaturan Retries bisa kamu sesuaikan dengan kebutuhan tapi di sini memakai settingan defaultnya. Setelah itu klik Update untuk menyimpan perubahan.
Selanjutnya, klik tombol Start untuk menjalankannya.
Tunggu beberapa saat, hingga tombol dengan simbol login menjadi aktif.
Jika sudah aktif klik tombol tersebut dan scan QR code di perangkat yang memasang WhatsApp.
Apabila scan berhasil, akan muncul otomatis nomor telepon WhatsApp yang akan digunakan sebagai bot.
Kamu bisa coba workflow dengan klik Execute step lalu coba kirim pesan ke nomor WhatsApp bot dan lihat hasilnya di Output.
STEP 4: Buat Node AI Agent
Berikutnya tambahkan node AI Agent untuk memberikan balasan otomatis. Kembali ke canvas workflow lalu tambahkan node AI dan pilih opsi AI Agent.
Akan muncul setting Parameters dan atur menjadi seperti gambar di bawah ini. Yang perlu kamu ingat, di langkah ini mengatur Prompt user secara manual yaitu apabila user mengirim pesan tersebut bot akan membalasnya. Lalu, di bagian properties klik Add Option.
Pilih opsi System Message dan masukkan kalimat prompt yang akan digunakan AI Agent untuk memproses pesan yang dikirim user. Tujuannya adalah untuk melatih AI dan memberikan data ke AI. Contoh kalimatnya seperti di bawah ini:
Kamu adalah Jagoan CS, customer service AI dari Jagoan Hosting.
Gunakan bahasa Indonesia yang santai dan panggil customer dengan sapaan 'Sob'.
Toko kami bernama Jagoan Hosting.
Alamat toko:
Jalan MT Haryono I, Dinoyo, Lowokwaru Kota Malang, Jawa Timur
Social media:
IG: https://www.instagram.com/jagoanhosting/
URL order produk:
Shopee: https://shopee.co.id/jagoanhosting
Tokopedia: https://tokopedia.com/jagoanhosting
Kontak WA untuk order hosting dan domain:
WhatsApp: 0812345678
Tugasmu adalah:
1. Sapa customer dengan "Halo Sob" HANYA pada awal percakapan atau jika customer memulai topik baru/sapaan pembuka. Untuk balasan selanjutnya dalam satu alur percakapan, langsung berikan informasi tanpa sapaan pembuka lagi.
2. Menjawab pertanyaan umum tentang Jagoan Hosting, alamat, social media, atau informasi kontak WhatsApp.
3. Jika customer bertanya stok barang, maka jawab hanya seputar stok barangnya ready atau kosong.
4. Jika customer menanyakan harga, berikan harga produknya (jika data harga tersedia, jika tidak, arahkan ke platform order).
5. Jika pertanyaan tentang stok, gunakan "get_stock_data" tool untuk mengecek data stok di Google Sheets.
6. Jika pertanyaan seputar order barang atau cara beli, arahkan ke URL order produk yang sudah disediakan, dan berikan juga info kontak WhatsApp.
7. Berikan respon yang rapi dan mudah dibaca. Jangan gunakan format teks seperti bold atau italic, dan untuk link sertakan URL lengkapnya secara langsung (jangan gunakan format Markdown [teks](url)).
8. Di akhir setiap balasan, tawarkan bantuan lain dengan kalimat yang bervariasi dan santai.
Catatan untuk stok:
1. Jika kamu menggunakan tool "get_stock_data", berikan hasil pengecekan stoknya ready atau kosong.
2. Jika tidak menemukan barang yang ditanyakan di data stok, informasikan bahwa barang tidak ditemukan atau tanyakan apakah nama barangnya sudah benar.
Jika sudah melengkapi form klik Execute step tapi nanti kamu akan mendapati pesan error karena belum menambahkan model AI Agent nya.
STEP 5: Menambahkan Modul AI Agent
Untuk menambahkan modul AI Agent, kembali ke canvas workflow lalu di node AI Agent klik ikon tambah di kategori Chat Model. Pilih opsi Google Gemini Chat Model untuk versi gratis tapi kamu bisa pilih sesuai kebutuhan.
Akan muncul Parameters, di sini buat dulu Credential Modul AI Agent nya jika belum ada.
Ketika mengisi credential, akan diminta mengisi API Key. Ini bisa kamu dapatkan melalui Google Studio.
Buka Google Studio di browser. Apabila baru pertama kali akses, pada tampilan ini pilih Get API Key lalu centang semua persetujuan yang diminta dan klik I accept.
Setelah masuk ke dashboard Google Studio, klik Create API key.
Pilih Create API key in new project.
Lalu, salin API key yang diberikan di notepad atau catatan kamu.
Dan masukkan pada Credential tadi lalu Save.
Nah, sekarang bagian Credential akan otomatis terisi berdasarkan yang sudah ditambahkan tadi. Di bagian Model kamu pilih model sesuai gambar di bawah ini. Jika ingin memilih versi lain, pastikan versi yang tergolong baru dan bukan yang thinking ya, Sob.
Kemudian close pop-up ini untuk kembali ke workflow.
STEP 6: Tes AI Agent
Setelah berada di halaman workflow, kamu akan melihat bahwa AI Agent kamu menggunakan modul Google Gemini. Selanjutnya hubungkan node WAHA jenis message ke AI Agent.
Jika sudah hasilnya seperti gambar berikut.
Arahkan kursor ke node AI Agent, setelah terlihat ikon titik tiga pilih Open dan coba lagi klik Execute step untuk menjalankan workflownya. Lihat output yang dihasilkan pasti akan memberikan respon tergantung Prompt (User Message) yang sudah ditetapkan di awal tadi.
Agar Prompt (User Message) ini tidak di set manual sehingga user dapat dengan bebas mengirim pesan pertama ke bot. Cari bagian body di kategori payload lalu drag&drop body tersebut ke kolom Prompt (User Message) seperti gambar di bawah ini.
Coba lagi menjalankan workflow nya, lalu kirim pesan random ke botnya. Misalnya “Halo, apa kabar?”
Output yang diberikan AI Agent dapat dilihat di log seperti berikut.
STEP 7: Tambahkan Node Action WAHA
Agar output ini dikirim balik ke pengguna yang memulai percakapan dengan bot. Tambahkan node action WAHA.
Lalu cari kategori Chatting Actions dan pilih Send a text message.
Buat credential untuk WAHA API nya jika belum ada.
Ganti host URL dengan WAHA API yang ada di dashboard WAHA.
Salin URL yang ada di Workers berikut. Dan masukkan ke Host URL di atas lalu klik Save dan tutup pop-up credentialnya.
Lalu bagian Credential nanti akan otomatis terisi dengan WAHA account yang sudah dibuat barusan. Kamu sesuaikan saja isian kolomnya seperti gambar di bawah ini. Tapi dibagian Text, drag&drop bagian output AI Agent ke kolom Text lalu klik Execute step.
Jika muncul error seperti ini:
Solusinya ubah script di bagian Session dan Chat Id menjadi seperti ini.
#Session
{{ $('WAHA Trigger').item.json.session }}
#Chat Id
{{ $('WAHA Trigger').item.json.payload.from }}
Coba Execute step lagi maka sekarang akan menampilkan output yang akan dikirimkan ke pengguna.
STEP 8: Uji Coba Workflow
Buka canvas workflownya dan lakukan uji coba dari sana dengan klik Execute workflow. Lalu, coba kirim pesan ke nomot WhatsApp bot.
Kamu akan melihat proses eksekusinya di workflow dan jika selesai pesan otomatis akan dikirimkan.
Dengan mengikuti panduan ini, kamu sekarang sudah bisa mengintegrasikan WhatsApp ke dalam workflow di n8n menggunakan WAHA. Solusi ini cocok untuk kebutuhan percobaan, belajar, maupun implementasi ringan tanpa biaya tambahan.
Namun, jika nantinya ingin digunakan untuk skala besar atau keperluan bisnis yang lebih serius, sebaiknya pertimbangkan beralih ke Official WhatsApp API agar lebih stabil dan minim risiko.
Artikel lainnya tentang n8n dapat kamu akses di menu sidebar sebelah kiri, selamat bereksplorasi dan kalau ada yang masih bikin bingung, jangan ragu hubungi Tim Support Jagoan Hosting melalui Live Chat atau Open Ticket, Sob!
Simak juga tips-tips dari Jagoan Hosting di laman Pusat Tutorial Hosting dan Domain Jagoan Hosting Indonesia. Good luck!