> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Batas Pengiriman

> GOWA tidak membatasi laju permintaan. Pelajari batas yang berlaku, cara WhatsApp membatasi pengirim, dan cara mengatur laju lalu lintas.

> [!WARNING]
>
> **GOWA tidak memiliki pembatas laju.** GOWA tidak menghitung permintaan, mengembalikan `429` karena volume permintaan, atau mengirim header `X-RateLimit-*`. Setiap permintaan Anda langsung diteruskan ke WhatsApp. Pengaturan laju menjadi tanggung jawab Anda.

## Batas yang diterapkan GOWA

| Batas | Nilai | Hasil jika terlampaui |
| - | - | - |
| Timeout permintaan | 45 s | `504 GATEWAY_TIMEOUT` |
| Body permintaan | 100 MB | Permintaan ditolak (`413`) |
| Unggahan gambar / dokumen / video | 20 / 50 / 100 MB | Kesalahan validasi `400` |
| Pengiriman webhook | 10 s per percobaan, 5 percobaan | Event dibuang |

## Batas yang diterapkan WhatsApp

WhatsApp tidak memublikasikan batas untuk perangkat tertaut, dan batas tersebut dapat berubah. Akun yang mengirim terlalu banyak, terlalu cepat, atau kepada orang yang belum pernah menghubunginya akan dibatasi atau diblokir. GOWA tidak dapat mendeteksi atau mencegah hal ini sebelumnya.

Satu sinyal yang ditampilkan GOWA adalah **`WA_REACHOUT_TIMELOCK`** (HTTP `429`):

```json theme={null}
{
  "code": "WA_REACHOUT_TIMELOCK",
  "message": "..."
}
```

WhatsApp mengembalikan ini (kesalahan server 463) ketika akun diblokir sementara untuk memulai chat **baru**. Pembatasan ini tidak dapat dilewati atau diatasi dengan mencoba ulang. Hingga pembatasan dicabut:

* Hanya kirim pesan kepada orang yang sudah menghubungi Anda terlebih dahulu, atau balas chat yang sudah ada.
* Mengirim satu pesan langsung dari ponsel terkadang membuat pembatasan dicabut lebih cepat.
* Hentikan pengiriman massal atau pesan ke kontak baru yang belum memberi persetujuan, dan kurangi laju pengiriman.

## Panduan mengatur laju pengiriman

Berikut titik awal yang konservatif, bukan jaminan:

* Kirim secara berurutan per perangkat; jangan jalankan ratusan permintaan secara bersamaan.
* Tambahkan jeda antar pesan (beberapa detik, dengan variasi acak) dan jeda lebih panjang antar batch.
* Utamakan kontak yang telah menyetujui atau menghubungi lebih dahulu. Pesan yang tidak diinginkan dapat dilaporkan, dan laporan dapat menyebabkan pemblokiran.
* Tingkatkan aktivitas nomor baru secara perlahan selama beberapa hari.
* Personalisasi konten; teks identik ke banyak penerima terlihat seperti spam.
* Hentikan pengiriman saat menerima `WA_REACHOUT_TIMELOCK` dan beri tahu petugas.

```python theme={null}
import random, time, requests

session = requests.Session()
session.auth = ("admin", "changeme")
session.headers["X-Device-Id"] = "my-device"

for phone, text in recipients:
    r = session.post("http://localhost:3000/send/message",
                     json={"phone": phone, "message": text}, timeout=60)
    body = r.json()
    if body.get("code") == "WA_REACHOUT_TIMELOCK":
        print("Reach-out blocked; stopping")
        break
    r.raise_for_status()
    time.sleep(random.uniform(5, 12))
```

Untuk pengiriman yang tersebar dalam rentang waktu, gunakan [pengiriman terjadwal](https://gowa-docs.mintlify.site/id/examples/scheduled-sends.md) alih-alih loop yang berjalan lama.

## Melindungi GOWA

Jika GOWA dapat diakses dari internet, tambahkan pembatasan permintaan di reverse proxy, terutama untuk login Basic Auth yang gagal dan, jika menggunakan MCP OAuth, `/oauth/authorize`. Contoh dengan nginx:

```nginx theme={null}
limit_req_zone $binary_remote_addr zone=gowa:10m rate=10r/s;

server {
    location / {
        limit_req zone=gowa burst=20 nodelay;
        proxy_pass http://127.0.0.1:3000;
    }
}
```


## Related topics

- [Batas Laju Permintaan](https://gowa-docs.mintlify.site/id/api-reference/rate-limits.md)
- [Mengirim Pesan](https://gowa-docs.mintlify.site/id/examples/sending-messages.md)
- [Penanganan Kesalahan](https://gowa-docs.mintlify.site/id/advanced/error-handling.md)
- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/id/index.md)
- [Penanganan Media](https://gowa-docs.mintlify.site/id/examples/media-handling.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.