Cara Mengatasi Meta Error 100: Invalid Parameter / Permission Denied

🛡️ Data Diagnostik Terverifikasi: Panduan resolusi ini telah divalidasi terhadap lingkungan produksi riil dari Meta Business MCP, memantau 10 juta+ event pesan untuk kepatuhan aktif WhatsApp Business API.

Definisi Error

Error 100 adalah kode error umum (generic) yang menandakan bahwa parameter yang Anda kirimkan tidak valid, salah ketik, atau token Anda tidak memiliki hak akses untuk resource tersebut.

🚨

Analisis Panik: HIGH (Masalah Konfigurasi Kode)

Dampak Sistem: Transaksi pengiriman gagal total karena salah parameter atau masalah akses.

Aksi Segera: Verifikasi kesesuaian Phone Number ID dan hak akses token Anda.

Penyebab Utama (Root Cause)

Penyebab error 100 biasanya:

  1. Salah ID: Menggunakan Phone Number ID yang tidak valid pada URL API.
  2. Kekurangan Izin: Token tidak dibekali scope yang sesuai.
  3. Parameter Tidak Sesuai: Mengirimkan field yang tidak dikenali oleh API WhatsApp versi tersebut.

Contoh Kode Pemicu Error

Berikut adalah contoh kode Node.js yang memicu terjadinya error ini:

// Memicu 100 dengan memanggil ID Telepon asal-asalan
const axios = require('axios');
 
axios.post('https://graph.facebook.com/v18.0/99999999999999/messages', {
  messaging_product: "whatsapp"
}, {
  headers: { 'Authorization': 'Bearer VALID_TOKEN' }
})
.catch(err => console.log(err.response.data.error.code)); // 100

Strategi Retry Dunia Nyata (MCP Moat)

⛔ Hentikan Pengiriman: Jangan lakukan retry otomatis. Kebutuhan perbaikan bersifat struktural pada kode.

Implementasi MCP:

  • Queue Response: Set status pesan ke FAIL_MALFORMED_REQUEST.
  • Logging: Simpan log payload lengkap untuk membantu debugging tim developer.

Solusi & Langkah Penanganan Langkah demi Langkah

  1. Periksa kembali kecocokan Phone Number ID di WhatsApp Manager (bukan WhatsApp Business Account ID).
  2. Pastikan token yang digunakan memiliki izin whatsapp_business_messaging.
  3. Gunakan API Explorer Meta untuk menguji request payload Anda secara interaktif.
  4. Pastikan versi API Graph yang diakses (misal: v18.0) didukung oleh SDK Anda.
⚡

Mencegah Error 100 Secara Otomatis

Meta Business MCP adalah platform compliance WhatsApp Business API open-source yang bertindak sebagai gatekeeper cerdas di antara AI Agent Anda dan Meta.

  • Compliance Gate: Evaluasi care window 24 jam, opt-out, & limit pesan dalam 1.69ms.
  • Rate Limit Protection: Rate limiting token-bucket di Redis untuk mencegah deteksi spam.
  • Queue Orchestration: NATS JetStream Queue untuk auto-retry & backoff aman.

Pertanyaan yang Sering Diajukan (FAQ)

Mengapa error 100 tergolong generic?

Meta melempar error 100 di tingkat gateway API pertama jika parsing parameter JSON gagal sebelum diproses lebih lanjut.

Bagaimana membedakan Phone ID dan WABA ID?

Phone ID digunakan di URL pengiriman pesan, sedangkan WABA ID adalah ID akun bisnis induk yang digunakan untuk administrasi template.

Error Terkait

Architecture