Cara Mengatasi Meta Error 131052: Template Parameter Mismatch (Variabel Tidak Cocok)

🛡️ 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 131052 terjadi ketika jumlah parameter variabel yang Anda kirimkan melalui API tidak cocok dengan jumlah placeholder variabel ({{1}}, {{2}}, dsb) yang didaftarkan pada template.

⚠️

Analisis Panik: MEDIUM (Masalah Integrasi Kode)

Dampak Sistem: Pesan gagal terkirim secara langsung. Reputasi nomor aman karena kegagalan divalidasi di awal.

Aksi Segera: Sesuaikan isi array parameters pada kode Anda agar sama persis dengan definisi variabel di template.

Penyebab Utama (Root Cause)

Apabila template Anda berisi 2 variabel di bagian body, tetapi kode API Anda mengirimkan 1 variabel atau 3 variabel, Meta akan menolak pesan tersebut dengan error 131052.

Contoh Kode Pemicu Error

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

// Memicu 131052 karena parameter template kurang
const axios = require('axios');
 
axios.post('https://graph.facebook.com/v18.0/YOUR_PHONE_NUMBER_ID/messages', {
  messaging_product: "whatsapp",
  to: "628123456789",
  type: "template",
  template: {
    name: "template_dua_parameter",
    language: { code: "id" },
    components: [{
      type: "body",
      parameters: [
        { type: "text", text: "Hanya satu parameter" } // Kurang satu parameter
      ]
    }]
  }
}, {
  headers: { 'Authorization': 'Bearer VALID_TOKEN' }
})
.catch(err => console.log(err.response.data.error.code)); // 131052

Strategi Retry Dunia Nyata (MCP Moat)

⛔ Hentikan Loop Retry: Data payload salah dan tidak akan terkirim tanpa revisi kode.

Implementasi MCP:

  • Queue Response: Set status pesan ke FAIL_INVALID_PAYLOAD.
  • Mitigasi: Gunakan validasi skema internal MCP untuk memeriksa jumlah parameter sebelum melakukan hit ke API Meta.

Solusi & Langkah Penanganan Langkah demi Langkah

  1. Lihat pratinjau template Anda di WhatsApp Manager.
  2. Hitung total tag variabel seperti {{1}}, {{2}} yang ada di teks template.
  3. Sesuaikan array parameters di kode program Anda agar memiliki jumlah item yang sama.
  4. Jika template memiliki header gambar atau dokumen, pastikan komponen header diisi dengan parameter bertipe image atau document.
  5. Pastikan tidak ada variabel kosong atau bernilai null.
⚡

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

Bolehkah saya mengosongkan variabel tertentu jika tidak dibutuhkan?

Tidak boleh. WhatsApp API tidak mengenal variabel opsional. Jika variabel terdaftar di template, nilainya wajib dikirimkan.

Apakah kegagalan parameter mismatch ini dikenakan biaya tarif percakapan?

Tidak. Pembatasan terjadi di tingkat gateway API Meta sebelum proses transmisi pesan dimulai, sehingga tidak ada tagihan.

Error Terkait

Architecture