Cara Mengatasi Meta Error 190: Invalid OAuth Access Token (Token Tidak Valid)

🛡️ 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 190 terjadi ketika access token WhatsApp API yang disertakan pada header otorisasi HTTP telah kedaluwarsa, tidak valid, atau dicabut hak aksesnya.

🚨

Analisis Panik: CRITICAL (Masalah Sistemik (Butuh Perbaikan Kredensial))

Dampak Sistem: Seluruh operasional pengiriman WhatsApp lumpuh total.

Aksi Segera: Buat token baru di Business Manager dan perbarui variabel lingkungan (env) server Anda.

Penyebab Utama (Root Cause)

Penyebab token tidak valid antara lain:

  1. Token Sementara: Menggunakan token sementara dari portal developer yang kedaluwarsa setelah 24 jam.
  2. Ubah Kata Sandi: Mengubah password akun admin Facebook Business secara otomatis menggugurkan token aktif.
  3. Pencabutan Akses: Developer mencabut instalasi aplikasi dari akun bisnis.

Contoh Kode Pemicu Error

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

// Contoh pemicu 190 karena token kedaluwarsa
const axios = require('axios');
 
axios.get('https://graph.facebook.com/v18.0/me/whatsapp_business_accounts', {
  headers: { 'Authorization': 'Bearer TOKEN_KADALUWARSA' }
})
.catch(err => console.log(err.response.data.error.code)); // 190

Strategi Retry Dunia Nyata (MCP Moat)

🚨 Tangguhkan Antrean: Hentikan proses pengiriman queue agar tidak membebani server.

Implementasi MCP:

  • NATS Consumer: Matikan konsumsi queue seketika.
  • Alerting: Kirim alert darurat ke tim DevOps untuk memperbarui env token.

Solusi & Langkah Penanganan Langkah demi Langkah

  1. Buka Pengaturan Bisnis di Meta Business Manager.
  2. Masuk ke Pengguna > Pengguna Sistem (System Users).
  3. Klik “Buat Token Baru” (Generate New Token).
  4. Centang izin whatsapp_business_messaging dan whatsapp_business_management.
  5. Salin token baru tersebut dan masukkan ke berkas konfigurasi .env Anda.
⚡

Mencegah Error 190 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)

Bagaimana membuat token yang tidak pernah kedaluwarsa?

Gunakan token yang dihasilkan dari menu “System Users” (Pengguna Sistem) di Business Manager, bukan dari halaman “Facebook Login” atau token developer sementara.

Apakah mengganti password Facebook membatalkan token?

Ya. Demi alasan keamanan, penggantian password akan membatalkan semua token yang terhubung dengan akun tersebut.

Error Terkait

Architecture