# 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.

<figure><img src="https://1593395352-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtrH5cLt7bV9EeFPiXO3%2Fuploads%2F9iqoE5fQ8ROBy4LJBQf6%2Fimage.png?alt=media&#x26;token=06cd82ce-1b0e-42e6-b898-909e474b5755" alt=""><figcaption></figcaption></figure>

Detail dari kegagalan pengiriman dapat dilihat dengan mengunduh keseluruhan laporan broadcast dengan menglik **Download Report by Filter**.

<figure><img src="https://1593395352-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtrH5cLt7bV9EeFPiXO3%2Fuploads%2FV3lcaOhUGVUAsExufV48%2Fimage.png?alt=media&#x26;token=19149d0e-13c3-4ae2-9944-62348c12a3cb" alt=""><figcaption></figcaption></figure>

## 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.

<table><thead><tr><th width="117.28515625">Error Code</th><th>Reason</th><th>Description</th><th>Recommended Action</th></tr></thead><tbody><tr><td><code>111003</code></td><td>Not part of the provider network</td><td>Layanan yang diminta tidak diizinkan.</td><td>Periksa kembali hak akses atau hubungi tim support.</td></tr><tr><td><code>111004</code></td><td>Operator not allowed</td><td>Operator tidak memiliki otorisasi untuk menjalankan aksi ini.</td><td>Hubungi tim support untuk bantuan lebih lanjut.</td></tr><tr><td><code>111005</code></td><td>Service not allowed</td><td>Layanan yang diminta tidak diizinkan.</td><td>Periksa izin layanan atau hubungi support.</td></tr><tr><td><code>111008</code></td><td>Forbidden user</td><td>Pengguna tidak memiliki akses ke kanal penagihan.</td><td>Hubungi tim support.</td></tr></tbody></table>

***

### **Business Account Errors**

**Description:**\
Errors related to the WhatsApp Business Account’s operational status, active session windows, or Meta-imposed delivery limits.

<table><thead><tr><th width="118.5625">Error Code</th><th>Reason</th><th>Description</th><th>Recommended Action</th></tr></thead><tbody><tr><td><code>131031</code></td><td>Account has been locked</td><td>Akun WhatsApp Business Anda dibatasi dan tidak dapat mengirim pesan.</td><td>Hubungi OCA Helpdesk untuk detail pembatasan akun.</td></tr><tr><td><code>131047</code></td><td>Re-engagement message</td><td>Pesan gagal karena lebih dari 24 jam sejak pelanggan terakhir membalas.</td><td>Kirim ulang pesan menggunakan template.</td></tr><tr><td><code>131049</code></td><td>This message was not delivered to maintain healthy ecosystem engagement</td><td>Pesan tidak dikirim untuk menjaga ekosistem tetap sehat.</td><td>WhatsApp membatasi setiap nomor hingga 2-3 pesan pemasaran setiap 24 jam untuk mencegah spam. Cobalah mengirim siaran lain dalam beberapa jam. Baca <a href="https://docs.ocaindonesia.co.id/oca-blast/panduan-oca-blast/broadcast/broadcast-gagal-terkirim/mengetahui-penyebab-whatsapp-broadcast-gagal-terkirim">artikel ini </a>untuk mempelajari lebih lanjut.</td></tr><tr><td><code>131050</code></td><td>User has stopped receipt of marketing messages</td><td>Penerima telah berhenti menerima pesan marketing.</td><td>Jangan kirim ulang pesan ke pengguna ini.</td></tr><tr><td><code>131057</code></td><td>Business Account in maintenance mode</td><td>Akun bisnis sedang dalam mode maintenance.</td><td>Tunggu hingga proses maintenance selesai.</td></tr><tr><td><code>112001</code></td><td>The business phone number has been deleted.</td><td>Nomor pelanggan sudah tidak terdaftar di WhatsApp.</td><td>Perbarui data nomor pelanggan.</td></tr><tr><td><code>112003</code></td><td>The account is not registered</td><td>Akun yang ingin Anda akses belum terdaftar.</td><td>Silakan periksa detail akun atau hubungi dukungan.</td></tr><tr><td><code>112004</code></td><td>Sent Outside Allowed Window</td><td>Permintaan dikirim di luar jendela waktu yang diizinkan.</td><td>Jadwalkan pengiriman siaran WhatsApp selama jam operasional (07:00 - 22:00). Hubungi helpdesk OCA jika Anda perlu mengirim siaran di luar jam ini.</td></tr></tbody></table>

***

### **Network Errors**

**Description:**\
Errors triggered by network instability or issues in communication between your server and the WhatsApp API.

<table><thead><tr><th width="118.86328125">Error Code</th><th>Reason</th><th>Description</th><th>Recommended Action</th></tr></thead><tbody><tr><td><code>113001</code></td><td>cURL error 28</td><td>Koneksi jaringan habis waktu atau tidak stabil.</td><td>Jaringan tidak stabil. Mulai ulang koneksi dan coba membuat siaran baru.</td></tr><tr><td><code>113003</code></td><td>cURL error 35</td><td>Kesalahan koneksi SSL atau kegagalan komunikasi internal.</td><td>Coba buat siaran lain atau hubungi Helpdesk OCA.</td></tr><tr><td><code>113004</code></td><td>cURL error 7</td><td>Gagal terhubung ke host.</td><td>Cobalah membuat siaran lain atau hubungi OCA Helpdesk.</td></tr></tbody></table>

### **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).

<table><thead><tr><th width="127.0078125">Error Code</th><th>Reason</th><th>Description</th><th>Recommended Action</th></tr></thead><tbody><tr><td><code>131008</code></td><td>Required parameter is missing</td><td>Parameter wajib tidak lengkap.</td><td>Lengkapi parameter yang diperlukan.</td></tr><tr><td><code>114002</code></td><td>An unexpected error has occurred</td><td>Terjadi kesalahan tak terduga.</td><td>Coba ulang atau hubungi support.</td></tr><tr><td><code>114003</code></td><td>An unknown error occurred</td><td>Terjadi error yang tidak diketahui.</td><td>Coba lagi nanti atau hubungi support.</td></tr><tr><td><code>114004</code></td><td>Request for URL failed</td><td>Permintaan ke URL gagal diproses.</td><td>Coba ulang atau hubungi support jika berlanjut.</td></tr><tr><td><code>114005</code></td><td>System Error</td><td>Koneksi direset oleh server.</td><td>Coba ulang broadcast atau hubungi OCA Helpdesk.</td></tr><tr><td><code>114006</code></td><td>Message failed to send because it was pending for too long</td><td>Pesan gagal dikirim karena pending terlalu lama.</td><td>Kirim ulang pesan dan periksa koneksi server.</td></tr><tr><td><code>131053</code></td><td>Media upload error</td><td>Unggahan media gagal karena tipe file tidak didukung atau masalah pengunggahan.</td><td>Hubungi support.</td></tr></tbody></table>

***

### **Quota Errors**

**Description:**\
Triggered when the available WhatsApp message quota for a specific category has been used up or the billing account has expired.

| Error Code      | Reason             | Description                             | Recommended Action                                   |
| --------------- | ------------------ | --------------------------------------- | ---------------------------------------------------- |
| `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.

| Error Code | Reason                                                                 | Description                                                         | Recommended Action                                                                                                                                                                                         |
| ---------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `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.

| Error Code | Reason                                                  | Description                                                                                        | Recommended Action                                                                                                                                                                             |
| ---------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `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.

| Error Code | Reason          | Description                       | Recommended Action                                                               |
| ---------- | --------------- | --------------------------------- | -------------------------------------------------------------------------------- |
| `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.

<table><thead><tr><th width="122.84375">Error Code</th><th>Reason</th><th>Description</th><th>Recommended Action</th></tr></thead><tbody><tr><td><code>118001</code></td><td>System Overload</td><td>WhatsApp system temporarily overloaded.</td><td>Temporary due to downtime or system overload. Please contact support.</td></tr><tr><td><code>118002</code></td><td>System Error</td><td>Provider failed to process broadcast.</td><td>Quota will be refunded within a maximum of 31 days.</td></tr><tr><td><code>118003</code></td><td>System Error</td><td>Internal error occurred.</td><td>Please try again or contact support.</td></tr><tr><td><code>118004</code></td><td>System Error</td><td>Generic internal failure.</td><td>—</td></tr></tbody></table>

***

### T**emplate Errors**

**Description:**\
Errors due to issues with message templates, such as invalid parameters, missing templates, or templates paused by Meta.

| Error Code | Reason                                                               | Description                                                               | Recommended Action                                                                                                                                   |
| ---------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `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.                                                                                |