# Rate Limit dan Error

Halaman ini membantu integrasi Anda mengatur laju kirim dan menangani galat dengan benar.

## Batas laju

- Umum: 100 permintaan per menit per API key, dengan jendela tetap satu menit.
- Pengiriman pesan punya batas tambahan per channel: WhatsApp 60 pesan per menit, Instagram dan Messenger 180 pesan per jam.

Setiap respons membawa header berikut.

```text
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 42
X-RateLimit-Reset: <waktu-reset>
```

## Kode galat

| Status | Arti | Tindakan |
|---|---|---|
| `401` | Key tidak ada, formatnya salah, tidak valid, dicabut, atau kedaluwarsa. | Periksa key. Lihat [Autentikasi](/developer/autentikasi). |
| `403` | Key tidak punya scope yang dibutuhkan (`insufficient_scope`). | Buat key baru dengan scope itu. Jangan diulang. |
| `429` | Batas laju terlampaui. | Tunggu sesuai header `Retry-After`. |
| `503` | Server sedang melayani permintaan sebanyak batasnya (`ServerBusy`). | Ulangi setelah `Retry-After`. |

### 403 insufficient_scope

Isi galat menyebut scope yang kurang (`need`) dan scope yang dimiliki key (`granted`).

```json
{
  "success": false,
  "error": {
    "code": "insufficient_scope",
    "message": "This API key is missing the scope 'messages:write' ...",
    "need": "messages:write",
    "granted": ["customers:read", "conversations:read"]
  }
}
```

Scope key tidak bisa diubah, jadi solusinya adalah membuat key baru. Lihat [API Key dan Scope](/developer/api-key-dan-scope).

### 429 Rate limit

```json
{
  "error": {
    "code": "RateLimitExceeded",
    "message": "...",
    "retryAfter": 30
  }
}
```

Respons juga membawa header `Retry-After` (detik). Implementasikan jeda dan percobaan ulang bertahap di integrasi Anda.

### 503 ServerBusy

Respons berisi `error.code` bernilai `ServerBusy` dan header `Retry-After: 1`. Ini bukan batas laju: permintaan belum dimulai, sehingga aman diulang setelah jeda.

## Hasil yang diharapkan

Integrasi Anda membaca `Retry-After`, mengulang hanya pada `429` dan `503`, dan tidak mengulang `401` atau `403` tanpa mengubah key.

## Masalah umum

- **Pesan WhatsApp ditolak di luar jendela 24 jam:** kirim template. Lihat [Konsep Dasar](/memulai/konsep-dasar).
- **Sering kena 429:** kurangi laju kirim, atau bagi beban dengan jeda antarpermintaan.