Failed / Rejected Message Reason
Anda dapat melihat setiap status dari seluruh pesan broadcast yang telah dikirimkan ke masing-masing pelanggan melalui halaman Broadcast Report dari tiap channel, mulai dari pesan dengan status diproses hingga terkirim ataupun gagal dikirim.
Untuk pesan dengan status Failed atau gagal terkirim, arahkan kursor ke ikon informasi di sebelah statu untuk melihat alasan gagal pengiriman pesan.
Detail dari kegagalan pengiriman dapat dilihat dengan mengunduh keseluruhan laporan broadcast dengan menglik Download Report by Filter.
Pesan WhatsApp Gagal / Status Ditolak
Bagian ini memberikan panduan lengkap tentang kode kesalahan yang ditemui selama proses pengiriman pesan WhatsApp melalui webhook. Memahami kode-kode ini penting untuk mendiagnosis masalah dan menerapkan solusi yang efektif guna memastikan pengiriman pesan yang lancar.
Kesalahan Otorisasi
Deskripsi: Kesalahan ini terjadi ketika aplikasi, operator, atau akun tidak memiliki izin yang diperlukan untuk melakukan tindakan atau mengakses sumber daya.
111003
Not part of the provider network
Layanan yang diminta tidak diizinkan.
Periksa kembali hak akses atau hubungi tim support.
111004
Operator not allowed
Operator tidak memiliki otorisasi untuk menjalankan aksi ini.
Hubungi tim support untuk bantuan lebih lanjut.
111005
Service not allowed
Layanan yang diminta tidak diizinkan.
Periksa izin layanan atau hubungi support.
111008
Forbidden user
Pengguna tidak memiliki akses ke kanal penagihan.
Hubungi tim support.
Business Account Errors
Description: Errors related to the WhatsApp Business Account’s operational status, active session windows, or Meta-imposed delivery limits.
131031
Account has been locked
Akun WhatsApp Business Anda dibatasi dan tidak dapat mengirim pesan.
Hubungi OCA Helpdesk untuk detail pembatasan akun.
131047
Re-engagement message
Pesan gagal karena lebih dari 24 jam sejak pelanggan terakhir membalas.
Kirim ulang pesan menggunakan template.
131049
This message was not delivered to maintain healthy ecosystem engagement
Pesan tidak dikirim untuk menjaga ekosistem tetap sehat.
WhatsApp membatasi setiap nomor hingga 2-3 pesan pemasaran setiap 24 jam untuk mencegah spam. Cobalah mengirim siaran lain dalam beberapa jam. Baca artikel ini untuk mempelajari lebih lanjut.
131050
User has stopped receipt of marketing messages
Penerima telah berhenti menerima pesan marketing.
Jangan kirim ulang pesan ke pengguna ini.
131057
Business Account in maintenance mode
Akun bisnis sedang dalam mode maintenance.
Tunggu hingga proses maintenance selesai.
112001
The business phone number has been deleted.
Nomor pelanggan sudah tidak terdaftar di WhatsApp.
Perbarui data nomor pelanggan.
112003
The account is not registered
Akun yang ingin Anda akses belum terdaftar.
Silakan periksa detail akun atau hubungi dukungan.
112004
Sent Outside Allowed Window
Permintaan dikirim di luar jendela waktu yang diizinkan.
Jadwalkan pengiriman siaran WhatsApp selama jam operasional (07:00 - 22:00). Hubungi helpdesk OCA jika Anda perlu mengirim siaran di luar jam ini.
Network Errors
Description: Errors triggered by network instability or issues in communication between your server and the WhatsApp API.
113001
cURL error 28
Koneksi jaringan habis waktu atau tidak stabil.
Jaringan tidak stabil. Mulai ulang koneksi dan coba membuat siaran baru.
113003
cURL error 35
Kesalahan koneksi SSL atau kegagalan komunikasi internal.
Coba buat siaran lain atau hubungi Helpdesk OCA.
113004
cURL error 7
Gagal terhubung ke host.
Cobalah membuat siaran lain atau hubungi OCA Helpdesk.
Other Errors
Description: These errors are general system or message delivery issues that are not specific to a particular category (e.g. internal server errors, unknown errors, or message timeout conditions).
131008
Required parameter is missing
Parameter wajib tidak lengkap.
Lengkapi parameter yang diperlukan.
114002
An unexpected error has occurred
Terjadi kesalahan tak terduga.
Coba ulang atau hubungi support.
114003
An unknown error occurred
Terjadi error yang tidak diketahui.
Coba lagi nanti atau hubungi support.
114004
Request for URL failed
Permintaan ke URL gagal diproses.
Coba ulang atau hubungi support jika berlanjut.
114005
System Error
Koneksi direset oleh server.
Coba ulang broadcast atau hubungi OCA Helpdesk.
114006
Message failed to send because it was pending for too long
Pesan gagal dikirim karena pending terlalu lama.
Kirim ulang pesan dan periksa koneksi server.
131053
Media upload error
Unggahan media gagal karena tipe file tidak didukung atau masalah pengunggahan.
Hubungi support.
Quota Errors
Description: Triggered when the available WhatsApp message quota for a specific category has been used up or the billing account has expired.
115001–115005
Insufficient Quota
Kuota pengiriman pesan tidak mencukupi.
Lakukan top up kuota sesuai kebutuhan broadcast.
115006
Account expired
Akun billing sudah kedaluwarsa.
Perpanjang masa aktif akun billing. Hubungi support.
Rate Limit Errors
Description: These errors occur when message sending or API request limits are exceeded for a specific WhatsApp number, application, or broadcast session.
130429
Rate limit hit
Cloud API message throughput limit has been reached.
Contact OCA Helpdesk for further assistance.
131048
Spam rate limit hit
Sending rate restricted due to previous spam or blocked messages.
Message failed to send because there are restrictions on how many messages can be sent from this phone number. This may be because too many previous messages were blocked or flagged as spam.
131056
Daily rate limit exceeded
Daily broadcast sending limit exceeded.
WhatsApp stopped broadcast sending because your OCA account sent too many broadcasts in a short time. Adjust your broadcast schedule and ensure there are no duplicate numbers within your contact groups.
133016
Account register/deregister rate limit exceeded
Too many registration or deregistration attempts in a short period.
Registration or Deregistration failed because there were too many attempts for this phone number in a short period of time.
116001
Application request limit reached
The app exceeded its request limit.
Try again later.
116002
Too many messages sent in a short time. Try again in a few hours.
Server received too many requests in a short time.
Please try again later or reduce the frequency of your requests.
116003
Too many messages sent. Try again with less broadcast to avoid limits.
Requests were temporarily throttled by the server.
Try again with fewer broadcasts to avoid limits.
Recipient Errors
Description: These errors are caused by invalid recipient phone numbers, unsupported devices or WhatsApp versions, or user participation in marketing-related experiments.
117001
Unsupported country code
The country code is not supported in OCA’s system.
Verify that the recipient’s phone number uses a valid and supported country code.
117002
Unregistered WhatsApp number
The recipient number is not registered on WhatsApp.
Update contact information for this recipient.
117003
Contact doesn’t exist
The specified contact could not be found.
Verify recipient number.
117004
Invalid WhatsApp number.
Invalid phone number format or incorrect MSISDN.
Update contact information for this recipient.
117005
Failed to send within time limit.
The message has expired and can no longer be delivered.
Failed to send within time limit. Contact OCA Helpdesk for assistance.
117006
Unsupported WhatsApp version
The recipient’s WhatsApp version does not support this message type.
Message failed to send because the receiver is on a version of WhatsApp that does not support this message.
117007
Recipient cannot get message due to unsupported device.
The recipient’s device is not supported for this message.
The device is not suitable for this operation. Please ensure the device meets the required specifications or try a different device.
130472
User’s number is part of an experiment
The user is part of WhatsApp’s marketing message experiment and cannot receive marketing messages.
Message will not be sent or billed. Cannot be resent. Contact the user through another channel and ask them to message your business so you can resend within an open customer service window.
Subscription Errors
Description: Errors related to expired or invalid billing accounts that prevent further message delivery.
115006
Account Expired
Your billing account has expired.
Your billing account has expired. Please renew it to continue using the service.
System Errors
Description: Errors caused by internal WhatsApp system issues, overload, or downtime affecting broadcast or message processing.
118001
System Overload
WhatsApp system temporarily overloaded.
Temporary due to downtime or system overload. Please contact support.
118002
System Error
Provider failed to process broadcast.
Quota will be refunded within a maximum of 31 days.
118003
System Error
Internal error occurred.
Please try again or contact support.
118004
System Error
Generic internal failure.
—
Template Errors
Description: Errors due to issues with message templates, such as invalid parameters, missing templates, or templates paused by Meta.
132000
Invalid Template Parameters or Variables
The template includes invalid or incorrectly formatted parameters.
Check the endpoint reference to determine which parameters are required.
132001
Template does not exist
The template does not exist or is not approved for the selected language.
The template does not exist in the specified language or has not been approved. Contact OCA Helpdesk for assistance checking your template category.
132005
Message Exceeds Character Limit
Template body text exceeds the 1024-character limit.
Ensure the number of characters in the Body Message does not exceed 1024, including variables.
132012
Template Parameter Format Mismatch
The template structure or variables do not match expected format.
Check the template and ensure all message elements match the required format.
132015
Template Paused
The template has been paused due to low quality and cannot be used.
Edit the template or create a broadcast with a new one.
119001
Template category invalid. Make sure the category match its content.
The template category does not exist or is invalid.
The category was not found. Contact OCA Helpdesk for assistance verifying your template category.
119002
Body message is invalid. Double-check your template format.
The body of the template is invalid.
The request contains unsupported or misspelled parameters. Double-check your template format.
119003
Template Not Found
The specified template does not exist.
Template not found. Make sure the template has been approved.
119004
Number of parameters does not match the expected number of params
Parameter count mismatch between template and payload.
A parameter value is invalid. Please check your inputs and try again.
Last updated