Batas permintaan, kirim ulang yang aman, dan fitur paket.

Batas API v2

• Permintaan per menit, per kunci live: sesuai paket (bawaan 300).
• Pesan per hari, per bisnis untuk semua kunci live: sesuai paket (bawaan 5.000). Dihitung ulang tengah malam waktu bisnis Anda (zona waktu di Pengaturan › Profil bisnis).
• Chat WhatsApp (scan QR) ke nomor baru: 50 per kunci per hari.
• Kunci tes: 60 permintaan per menit dan 100 pesan per hari, terpisah dari kuota paket.
• Batas paket Anda tampil di Pengaturan › API & Webhook.

Header batas

Setiap jawaban API v2 membawa RateLimit-Limit, RateLimit-Remaining, dan RateLimit-Reset (detik sampai batas per menit dibuka lagi). Jawaban 429 menambah Retry-After: untuk batas harian, nilainya detik sampai tengah malam waktu bisnis.

Kirim ulang yang aman (Idempotency-Key)

Kirim header Idempotency-Key (misalnya UUID baru per pesan) di setiap POST dan PATCH API v2. Kunci disimpan 24 jam per Kunci API.

• Ulangan dengan kunci dan isi yang sama mendapat jawaban pertama lagi dengan header Idempotency-Replayed: true; pesan tidak terkirim dua kali.
• Kunci yang sama dengan isi berbeda ditolak idempotency_conflict (409).
• Selama permintaan pertama masih diproses, ulangan mendapat request_in_progress (409) dengan Retry-After: 2.
• Jawaban 5xx, 429, dan request_in_progress tidak disimpan, jadi ulangan dengan kunci yang sama diproses lagi.

Kapan mengirim ulang

• Kirim ulang hanya setelah 429 (tunggu Retry-After), 5xx, atau koneksi terputus, dengan Idempotency-Key yang sama.
• Jangan kirim ulang setelah 4xx selain 429: perbaiki permintaannya dulu.
• Sebutkan request_id (juga di header Request-Id) saat menghubungi dukungan Klik Flow. Cari permintaannya di Pengaturan › API & Webhook › Log permintaan.

Fitur paket

Kunci live API v2 butuh paket dengan fitur API; kunci tes bisa dipakai di semua paket. Nomor WhatsApp yang melebihi kuota paket dijeda dan kirimannya ditolak channel_paused.