Integrasi WhatsApp Business Cloud API Resmi untuk Pasar Indonesia

Di Indonesia, WhatsApp bukan sekadar aplikasi chat — ini adalah kanal default untuk segala hal, dari konfirmasi pesanan sampai pengingat pembayaran. Pada sebuah proyek untuk klien Indonesia baru-baru ini, saya butuh backend yang mengirim notifikasi andal begitu pesanan dikirim atau tagihan jatuh tempo. Godaannya selalu memakai library scraper yang mengotomasi WhatsApp Web. Saya sangat menyarankan untuk tidak melakukannya, dan artikel ini menjelaskan jalur resmi yang saya tempuh sebagai gantinya.

Opsi resmi adalah WhatsApp Business Platform Cloud API, yang di-hosting oleh Meta. Tidak ada server WhatsApp yang perlu Anda jalankan sendiri — Anda cukup memanggil satu endpoint HTTP, dan Meta menangani pengiriman, enkripsi, serta kesehatan akun. Keputusan tunggal itu menghilangkan satu kelas penuh insiden produksi yang biasa diciptakan oleh tools tidak resmi.

Kenapa Cloud API resmi mengalahkan library tidak resmi

Library Node dan Python populer yang menggerakkan WhatsApp Web lewat headless browser terlihat praktis karena gratis dan melewati proses persetujuan. Tapi ini adalah klien hasil reverse-engineering yang melanggar Ketentuan Layanan WhatsApp. Dalam praktiknya mereka rusak setiap kali WhatsApp memperbarui klien web-nya dan — lebih parah — sering membuat nomor pengirim diblokir. Untuk pipeline notifikasi bisnis, nomor yang diblokir berarti gangguan total tanpa peringatan. Berikut perbandingan kedua pendekatan tersebut.

Template pesan dan cara mendapatkan persetujuannya

Setiap pesan yang Anda kirim ke pelanggan yang belum pernah menghubungi Anda lebih dulu wajib memakai template yang sudah disetujui. Anda membuat template sekali lewat Graph API, Meta meninjaunya (biasanya dalam hitungan menit, maksimal 24 jam), dan baru setelah itu Anda bisa mengirimnya. Template mendukung variabel placeholder yang Anda isi saat pengiriman, jadi satu template yang disetujui bisa mencakup ribuan pesan yang dipersonalisasi. Pilih kategori yang tepat — utility untuk update transaksional, marketing untuk promosi, authentication untuk kode sekali pakai — karena kategori menentukan aturan persetujuan sekaligus penagihan.

// Create a UTILITY template (Bahasa Indonesia) via the Graph API
// POST https://graph.facebook.com/v21.0/<WABA_ID>/message_templates
// Authorization: Bearer <SYSTEM_USER_TOKEN>
{
  "name": "order_shipped_id",
  "language": "id",
  "category": "UTILITY",
  "components": [
    {
      "type": "BODY",
      "text": "Halo {{1}}, pesanan {{2}} Anda sudah dikirim dan diperkirakan tiba {{3}}."
    }
  ]
}

Jendela layanan pelanggan 24 jam

Begitu pelanggan mengirim pesan kepada Anda, jendela layanan pelanggan 24 jam terbuka. Selama jendela terbuka, Anda bisa membalas dengan pesan bebas — tanpa template — dan setiap pesan baru dari pelanggan mereset timer menjadi 24 jam lagi. Setelah jendela tertutup, satu-satunya cara menjangkau pelanggan itu lagi adalah lewat pesan template. Perbedaan inilah inti dari platform ini: template untuk kontak yang diinisiasi bisnis, pesan layanan bebas untuk percakapan yang dimulai pelanggan.

• Jendela terbuka: kirim teks, gambar, tombol, atau daftar dengan bebas — ideal untuk balasan support atau chatbot.
• Jendela tertutup: hanya pesan template yang disetujui yang bisa menghubungi pelanggan kembali.
• Setiap pesan masuk dari pelanggan mereset timer 24 jam, sehingga chat yang aktif tetap bisa bebas template.

Mengirim pesan template dari backend

Semua pesan keluar menuju satu endpoint. Anda butuh phone number ID dari dashboard Meta, access token permanen, dan nomor penerima dalam format E.164 — untuk Indonesia berarti kode negara 62 tanpa angka nol di depan dan tanpa tanda plus, jadi nomor yang diawali 0812 menjadi 62812. Parameter body mengisi placeholder template sesuai urutan.

// POST https://graph.facebook.com/v21.0/<PHONE_NUMBER_ID>/messages
// Authorization: Bearer <ACCESS_TOKEN>
{
  "messaging_product": "whatsapp",
  "to": "6281234567890",
  "type": "template",
  "template": {
    "name": "order_shipped_id",
    "language": { "code": "id" },
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "Budi" },
          { "type": "text", "text": "INV-2026-0817" },
          { "type": "text", "text": "besok sore" }
        ]
      }
    ]
  }
}

Menerima pesan masuk dengan webhook

Untuk merespons balasan pelanggan — dan untuk tahu bahwa jendela layanan baru saja terbuka — Anda berlangganan webhook. Meta pertama-tama memanggil endpoint Anda dengan request GET untuk memverifikasinya terhadap token yang Anda tetapkan, lalu mengirim setiap pesan masuk dan update status pengiriman sebagai POST. Selalu balas dengan HTTP 200 secepatnya, kalau tidak Meta akan mengulang dan Anda mendapat pengiriman ganda. Lakukan proses berat di antrean (queue), bukan langsung di dalam handler webhook.

// Express webhook: verification (GET) + inbound handling (POST)
app.get("/webhook", (req, res) => {
  const mode = req.query["hub.mode"];
  const token = req.query["hub.verify_token"];
  const challenge = req.query["hub.challenge"];
  if (mode === "subscribe" && token === process.env.VERIFY_TOKEN) {
    return res.status(200).send(challenge);
  }
  return res.sendStatus(403);
});

app.post("/webhook", (req, res) => {
  res.sendStatus(200); // ack immediately, then process
  const value = req.body.entry?.[0]?.changes?.[0]?.value;
  const message = value?.messages?.[0];
  if (message) {
    // Customer messaged us -> 24-hour service window is now open
    enqueue({ from: message.from, text: message.text?.body });
  }
});

Kategori percakapan dan pricing per-pesan

Sejak 1 Juli 2025, Meta beralih dari model lama berbasis percakapan ke pricing per-pesan: Anda ditagih setiap kali sebuah pesan template terkirim, dan tarifnya bergantung pada kategori template serta kode negara penerima. Yang penting, pesan layanan yang Anda kirim di dalam jendela 24 jam yang terbuka adalah gratis, dan sejak perubahan yang sama, template utility yang terkirim di dalam jendela terbuka juga gratis. Untuk nomor Indonesia, pesan utility dan authentication ditagih dengan tarif per-pesan yang relatif kecil — verifikasi rate card Indonesia terbaru sebelum menyusun anggaran, karena Meta menyesuaikannya secara berkala.

Aturan opt-in dan kepatuhan

Meta mewajibkan opt-in eksplisit sebelum Anda mengirim pesan ke siapa pun. Pelanggan harus secara aktif setuju menerima pesan WhatsApp dari bisnis Anda, opt-in harus menyebut WhatsApp secara spesifik, dan Anda wajib mencatat kapan serta bagaimana persetujuan itu diperoleh. Ini bukan sekadar aturan Meta — ini selaras dengan UU Perlindungan Data Pribadi (UU PDP) Indonesia, yang memperlakukan nomor telepon sebagai data pribadi yang butuh dasar hukum. Simpan jejak persetujuan; Anda akan membutuhkannya jika pelanggan komplain atau jika Meta mengaudit quality rating Anda.

• Ambil opt-in di kanal yang sudah dipakai pelanggan — checkout web, aplikasi, atau formulir fisik Anda.
• Nyatakan dengan jelas bahwa mereka akan menerima pesan WhatsApp, dan dari nama bisnis mana.
• Hormati opt-out dengan segera dan simpan daftar berhenti agar Anda tidak pernah mengirim ke nomor yang berhenti berlangganan.
• Jaga kualitas tetap tinggi: pesan tidak relevan atau tanpa izin menurunkan rating Anda dan bisa membatasi limit pengiriman.

Digabungkan, inilah pipeline yang saya percayai di produksi: template yang disetujui untuk peringatan keluar, webhook yang mengubah pelanggan ke jendela layanan gratis, pengiriman yang sadar kategori untuk mengendalikan biaya, dan catatan persetujuan yang menjaga kepatuhan. Setup-nya memang lebih banyak daripada library scraper, tapi inilah satu-satunya versi yang bertahan menghadapi trafik nyata di Indonesia.