Cara Mengatasi Meta Error 131047: Message Rejected (24-Hour Window Expired)

🛡️ 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 131047 terjadi ketika Anda mencoba mengirim pesan teks biasa (free-form) ke pengguna, tetapi waktu sejak pesan masuk terakhir dari pengguna tersebut sudah melebihi 24 jam.

🚨

Analisis Panik: HIGH (Sementara / Transaksional)

Dampak Sistem: Pesan gagal terkirim dengan status rejected. Tidak mempengaruhi skor reputasi nomor.

Aksi Segera: Ubah format pesan dari teks biasa menjadi Message Template (Template WhatsApp).

Penyebab Utama (Root Cause)

Meta menerapkan batasan “24-hour customer care window”. Di luar batas waktu ini, Anda tidak diperbolehkan mengirimkan pesan teks bebas, melainkan wajib menggunakan WhatsApp Message Template yang sudah disetujui.

Contoh Kode Pemicu Error

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

// Memicu 131047 saat mengirim pesan teks di luar jendela 24 jam
const axios = require('axios');
 
axios.post('https://graph.facebook.com/v18.0/YOUR_PHONE_NUMBER_ID/messages', {
  messaging_product: "whatsapp",
  to: "628123456789",
  type: "text",
  text: { body: "Halo, kami ingin menanyakan status tiket Anda." }
}, {
  headers: { 'Authorization': 'Bearer VALID_TOKEN' }
})
.catch(err => console.log(err.response.data.error.code)); // 131047

Strategi Retry Dunia Nyata (MCP Moat)

🔄 Fallback ke Template: Jangan kirim ulang pesan teks bebas yang sama. Alihkan alur pengiriman ke Template Fallback.

Implementasi MCP:

  • NATS Queue Routing: Deteksi error 131047, batalkan pesan teks bebas, cari template follow-up yang sesuai di Redis.
  • Eksekusi: Kirim template tersebut untuk membuka kembali sesi obrolan.

Solusi & Langkah Penanganan Langkah demi Langkah

  1. Periksa kapan terakhir kali pengguna mengirim pesan ke nomor Anda di database/log webhook.
  2. Pastikan Anda tidak mengirimkan teks bebas atau media non-template di luar jendela 24 jam.
  3. Pilihlah template yang terdaftar (misal: template follow-up/utility).
  4. Kirim pesan template tersebut dan tunggu respon balik dari pengguna untuk membuka jendela chat baru.
⚡

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

Apakah error 131047 menurunkan kualitas nomor WA?

Tidak. Ini adalah penegakan kebijakan sesi normal dan tidak berdampak buruk pada reputasi atau skor spam nomor Anda.

Apakah durasi 24 jam bisa ditawar atau ditambah?

Tidak bisa. Meta menerapkan aturan ini secara ketat pada platform global mereka.

Error Terkait

Architecture