Lewati ke isi

AI & Otomasi

WhatsApp API Self-Hosted dengan WAHA: Notifikasi & Chatbot

WAHA membuat nomor WhatsApp bisa dipakai lewat API dari server sendiri. Pahami cara kerja, kegunaan, risiko blokir, dan kapan perlu API resmi.

Terbit 5 menit baca

Jawaban singkat

WAHA (WhatsApp HTTP API) adalah aplikasi self-hosted yang membuat nomor WhatsApp bisa mengirim dan menerima pesan lewat API, dengan cara kerja seperti WhatsApp Web. Cocok untuk notifikasi dan chatbot bervolume kecil ke pelanggan yang setuju dihubungi. WAHA bukan API resmi Meta.

Daftar isi
  1. Bagaimana WAHA bekerja?
  2. WAHA dan WhatsApp Business Platform resmi itu berbeda
  3. Untuk apa WAHA cocok dipakai?
  4. Menghubungkan WAHA ke n8n
  5. Bagaimana memakai WAHA dengan aman?
  6. Pasang WAHA tanpa mengurus server
  7. Pertanyaan yang sering diajukan

WAHA (WhatsApp HTTP API) adalah aplikasi open-source yang kamu pasang di server agar nomor WhatsApp bisa mengirim dan menerima pesan lewat permintaan HTTP biasa.

Kenapa ini penting? Banyak bisnis ingin WhatsApp bekerja sendiri: pelanggan langsung menerima konfirmasi pesanan, tim gudang diberi tahu saat ada order baru, dan pertanyaan sederhana terjawab tanpa menunggu admin. Semua itu butuh WhatsApp yang bisa diakses aplikasi lain. WAHA adalah salah satu jalannya, dengan satu catatan besar: ia bukan layanan resmi dari Meta.

Bagaimana WAHA bekerja?

Cara kerjanya mirip saat kamu membuka WhatsApp Web di browser. Kamu memindai kode QR dari aplikasi WhatsApp di HP, lalu WAHA menjalankan sesi WhatsApp itu di server.

Setelah sesi aktif, aplikasimu cukup memanggil API WAHA untuk mengirim pesan teks, gambar, atau dokumen. Pesan yang masuk diteruskan ke aplikasimu lewat webhook, sehingga bisa diolah chatbot atau alur otomasi. WAHA juga menyediakan dashboard dan dokumentasi API (Swagger) untuk mencoba setiap perintah1.

WAHA dan WhatsApp Business Platform resmi itu berbeda

Ini hal terpenting sebelum memakai WAHA. Meta punya WhatsApp Business Platform (dikenal juga sebagai WhatsApp Cloud API) yang resmi, dengan aturan template pesan, verifikasi bisnis, dan biaya percakapan sesuai ketentuan Meta2. WAHA tidak termasuk platform itu. Ia memakai nomor WhatsApp biasa atau WhatsApp Business di HP, lewat jalur yang sama dengan WhatsApp Web.

Perbedaannya, poin demi poin:

  • Status
    • WAHA: tidak resmi, berbasis WhatsApp Web.
    • Platform resmi: resmi dari Meta.
  • Cara menghubungkan
    • WAHA: pindai kode QR dari HP.
    • Platform resmi: daftar akun bisnis dan nomor di Meta.
  • Biaya
    • WAHA: biaya server.
    • Platform resmi: biaya sesuai ketentuan Meta, plus server atau penyedia.
  • Template pesan
    • WAHA: tidak ada aturan template.
    • Platform resmi: pesan pembuka wajib memakai template yang disetujui.
  • Risiko blokir
    • WAHA: ada, terutama bila dipakai untuk pesan massal.
    • Platform resmi: lebih kecil selama mengikuti kebijakan Meta.
  • Cocok untuk
    • WAHA: notifikasi dan chatbot skala kecil.
    • Platform resmi: skala besar, broadcast, kebutuhan resmi.

Untuk apa WAHA cocok dipakai?

Pegangannya sederhana: pesan yang ditunggu penerimanya, dengan volume yang wajar.

  • Notifikasi transaksi: konfirmasi pesanan, status pengiriman, atau pengingat jadwal untuk pelanggan yang sudah memberi nomornya dan setuju dihubungi.
  • Notifikasi internal: pesan ke grup tim saat ada order baru, pembayaran masuk, atau server bermasalah.
  • Chatbot sederhana: menjawab pertanyaan berulang seperti jam buka, cara order, atau cek status, untuk pelanggan yang lebih dulu mengirim pesan.
  • Integrasi: menghubungkan WhatsApp ke CRM, toko online, atau sistem tiket.

Yang tidak cocok: broadcast promosi ke ribuan nomor, apalagi ke daftar kontak yang dibeli atau dikumpulkan tanpa izin. Untuk skala besar dan pesan pemasaran, gunakan WhatsApp Business Platform resmi.

Menghubungkan WAHA ke n8n

Kombinasi yang sering dipakai adalah WAHA untuk jalur WhatsApp dan n8n untuk logikanya. Dokumentasi WAHA juga menyediakan panduan integrasinya.

  1. Hubungkan nomor. Buka dashboard WAHA, buat sesi, lalu pindai kode QR dari WhatsApp di HP.
  2. Atur webhook. Arahkan webhook WAHA ke alur n8n, supaya setiap pesan masuk memicu workflow.
  3. Susun logika. Di n8n, cek isi pesan, cari data di spreadsheet atau database, atau minta AI menyusun jawaban.
  4. Kirim balasan. n8n memanggil API WAHA untuk mengirim pesan kembali ke pengirim.
  5. Uji dengan nomor sendiri. Coba dari HP lain sebelum dibuka untuk pelanggan.

Kalau tim CS butuh satu kotak masuk bersama untuk WhatsApp, email, dan live chat, baca juga Chatwoot untuk customer service.

Bagaimana memakai WAHA dengan aman?

Kebiasaan berikut sejalan dengan panduan di dokumentasi WAHA:

  • Kirim ke yang setuju (opt-in). Hubungi hanya pelanggan yang memberi nomornya untuk keperluan itu.
  • Utamakan membalas. Chatbot yang menjawab pesan masuk jauh lebih aman daripada mengirim pesan pertama ke banyak orang.
  • Jaga volume tetap rendah. Beri jeda antar pesan dan hindari isi yang sama persis ke banyak nomor.
  • Sediakan cara berhenti. Hormati pelanggan yang meminta tidak dihubungi lagi.
  • Lindungi API. Pasang kunci API di WAHA dan jangan sebarkan alamat dashboard ke orang lain.

Pasang WAHA tanpa mengurus server

Di Nivelva Apps, WAHA bisa dipasang sekali klik di server terisolasi. Kamu langsung mendapat alamat namamu.nivelva.app dengan SSL otomatis, dan bisa menambahkan domain sendiri kapan saja. Paket minimal WAHA adalah Medium:

PaketvCPURAMHarga per bulan
Medium12 GBRp25.000
Pro22 GBRp35.000
Enterprise24 GBRp50.000

Harga mengikuti halaman Apps saat artikel ini ditulis. Pengelolaan lewat panel (restart, update, log, pantauan CPU dan RAM), tanpa akses SSH. Backup harian tersedia sebagai add-on berbayar. Daftar aplikasi lain yang bisa dipasang dengan cara serupa ada di artikel aplikasi open-source 1 klik.

Pertanyaan yang sering diajukan

Nomor apa yang sebaiknya dipakai untuk WAHA?

Nomor khusus untuk notifikasi atau chatbot, bukan nomor utama bisnis. Jadi bila terjadi pembatasan, komunikasi utama dengan pelanggan tetap aman.

Apakah WAHA boleh dipakai untuk broadcast promosi?

Tidak disarankan. Pesan massal ke orang yang tidak meminta adalah penyebab umum nomor diblokir. Untuk broadcast skala besar, gunakan WhatsApp Business Platform resmi.

Bisakah paket WAHA dinaikkan nanti?

Bisa. Mulai dari paket minimal Medium (1 vCPU, 2 GB RAM), lalu upgrade ke Pro atau Enterprise dari panel bila kebutuhan bertambah.

Sumber & referensi

  1. 1

    Fitur, cara instalasi, dan panduan menghindari blokir dijelaskan di dokumentasi resmi WAHA (waha.devlike.pro/docs).

  2. 2

    Ketentuan WhatsApp Business Platform ada di dokumentasi Meta for Developers.

Baca juga