Throughput dan Rate Limit WhatsApp Cloud API: Penjelasan Lengkap

Kode error apa yang muncul saat saya mencapai batas?

Cocokkan kode dengan batasnya, lalu pilih respons.

Kode 131048 dan 131049 berkaitan dengan kualitas dan keterlibatan, bukan kecepatan, jadi mencoba lebih cepat tidak akan membantu. Lihat pemecahan masalah kode error API WhatsApp.

Di API OmniChannels.ai, penolakan dari upstream tiba sebagai HTTP 502 dengan kode error dan teks Meta di message, dan rate limiting kami sendiri mengembalikan 429 dengan header Retry-After. Lihat error dan batas untuk tabel lengkap dan batas default.

Bagaimana cara mengantrekan dan mencoba ulang?

Letakkan antrean di antara aplikasi Anda dan API, batasi laju di bawah plafon Anda, dan coba ulang hanya yang bisa berhasil di lain waktu.

1. Antrekan setiap pengiriman. Aplikasi Anda menulis pesan ke antrean dan sekelompok worker menguranginya. Jangan pernah mengulang daftar pelanggan dalam satu handler permintaan.
2. Batasi laju dengan token bucket yang diatur di bawah throughput Anda, sisakan ruang untuk balasan dan lalu lintas lain yang berbagi batas yang sama.
3. Catat setiap percobaan lebih dulu. Tulis satu baris per pesan dengan kunci ID operasi Anda sendiri, simpan ID pesan yang dikembalikan, dan lewati apa pun yang sudah diterima.
4. Coba ulang kegagalan sementara. Throttling dan error server sementara dicoba ulang; error validasi (400), autentikasi, dan template tidak.
5. Gunakan backoff dengan jitter. Tunggu lebih lama setelah setiap percobaan, tambahkan keacakan agar worker tidak mencoba ulang bersamaan, dan batasi baik jeda maupun jumlah percobaan.
6. Patuhi Retry-After bila respons menyertakannya.
7. Periksa sebelum mengirim ulang setelah timeout. Respons yang hilang tidak berarti pesan hilang; lihat dulu event status.

const RETRYABLE = new Set([429, 500, 502, 503, 504]);

async function sendWithBackoff(send, { maxAttempts = 5, baseMs = 500, capMs = 30000 } = {}) {
  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
    const res = await send();
    if (res.ok) return res;
    if (!RETRYABLE.has(res.status) || attempt === maxAttempts) throw new Error(`failed: ${res.status}`);
    const wait = Math.random() * Math.min(capMs, baseMs * 2 ** (attempt - 1)); // full jitter
    await new Promise((r) => setTimeout(r, wait));
  }
}

Halaman throughput Meta tidak memberi aturan backoff untuk error 130429, jadi ini adalah praktik rekayasa standar. Untuk 502 yang membawa kode throttling Meta, perlakukan sebagai dapat dicoba ulang; untuk kode upstream lainnya, baca dulu pesannya. Halaman error dan batas kami memuat tabel retry lengkap dan perlindungan pengiriman ganda.

Bagaimana merencanakan pengiriman besar?

Hitung waktu, batas, dan beban webhook sebelum Anda memulai.

1. Hitung penerima unik dan bandingkan dengan batas pesan Anda. Mulailah dengan rencana peningkatan yang aman jika daftar lebih besar dari tingkat Anda.
2. Perkirakan durasi. Jumlah pesan dibagi throughput Anda menghasilkan detik. Secara aritmetika, 100.000 pesan pada 80 per detik membutuhkan 1.250 detik, sekitar 21 menit, jika tidak ada lalu lintas lain yang memakai batas.
3. Sisakan kapasitas. Batas ini juga menghitung pesan masuk, jadi sisakan ruang untuk balasan pelanggan selama pengiriman.
4. Sesuaikan ukuran server webhook Anda. Meta menyatakan server webhook harus mampu menangani tiga kali lalu lintas pesan keluar Anda ditambah perkiraan lalu lintas masuk, dengan latensi median tidak lebih dari 250 ms dan kurang dari 1% permintaan di atas 1 detik. Lihat panduan webhook.
5. Periksa kesehatan dan kualitas template terlebih dahulu, dan bagi pengiriman dalam beberapa batch agar Anda bisa berhenti jika kegagalan atau pemblokiran meningkat. Lihat kirim pesan massal tanpa diblokir.
6. Gunakan media ID alih-alih tautan saat mengirim file dalam volume besar, sebagaimana disarankan Meta. Lihat jenis dan batas media.

Di OmniChannels.ai, endpoint massal menerima banyak penerima dalam satu permintaan dan kolom delay dapat membatasi laju pengiriman. Sepakati rencana puncak dengan tim kami sebelumnya.

Contoh kasus: flash sale di Dubai

"Marina Gadgets" (sintetis) merencanakan template flash sale ke 60.000 pelanggan yang sudah opt-in.

1. Batas mereka mengizinkannya, jadi volume bukan kendala; kecepatanlah yang menjadi kendala. Pada 80 mps, 60.000 pesan membutuhkan 750 detik.
2. Mereka mengirim dalam enam batch berisi 10.000 dengan rate limiter di 60 mps, yang menyisakan ruang untuk balasan.
3. Satu batch menampilkan beberapa error 131056 untuk pelanggan yang juga menerima pembaruan pesanan pada menit yang sama. Mereka menunda pengiriman tersebut beberapa menit.
4. Sebuah worker mencoba ulang permintaan yang terkena throttling dengan backoff berjitter, dan tidak ada pesan yang dicoba ulang setelah memiliki ID.
5. Endpoint webhook menyimpan event dan mengembalikan 200, lalu worker memperbarui status.
6. Setelah setiap batch, mereka memeriksa kegagalan dan kualitas template sebelum melanjutkan.

Apa saja kesalahan yang umum terjadi?

• Mencampuradukkan batas. Throughput, pair, Graph API, dan batas pesan adalah masalah yang berbeda.
• Langsung mencoba ulang, yang membuat nomor tetap di batas dan memperpanjang masalah.
• Mengirim tepat di batas, sehingga balasan dan status bersaing dengan kampanye.
• Mengirim ulang setelah timeout tanpa memeriksa status, yang menggandakan pesan.
• Polling endpoint Graph API dalam loop dan menabrak batas per jam.
• Server webhook yang terlalu kecil sehingga tertinggal dan memicu retry.
• Batas berubah. Panduan ini memuat nilai Meta saat artikel ini ditulis.

Bagaimana OmniChannels.ai membantu

BroadNet adalah Meta Business Solution Provider resmi, dan OmniChannels.ai mengirim WhatsApp lewat satu API dengan endpoint massal, kolom delay untuk pembatasan laju, penjadwalan, dan status pengiriman dalam satu format webhook yang dinormalisasi. Reseller mendapat webhook dan kredit terpisah per sub-akun. Rencanakan puncak bersama tim kami, dan baca dokumentasi API WhatsApp, error dan batas, serta halaman kampanye.