API: kunci live vs kunci uji, izin & IP per kunci

Beda kunci produksi & test, izin per kunci, batas IP, masa berlaku, dan batas permintaan dari setelan.

± 4 menit

Satu Profil bisa punya beberapa kunci dengan mode, izin, dan batas IP masing-masing. Buat kunci terpisah per sistem agar mudah dicabut tanpa mengganggu yang lain.

Kunci produksi & test#

`cswa_live_…`	Produksi: benar-benar mengirim pesan dan mengubah data. Hanya untuk Profil All Access berbayar.
`cswa_test_…`	Test: menjalankan semua pemeriksaan tanpa mengirim pesan dan tanpa mengubah data. Satu-satunya pilihan selama masa coba.
Tampil sekali	Kunci utuh hanya tampil saat dibuat/dirotasi. Daftar hanya menampilkan awalan + 4 karakter terakhir.
Masa berlaku	Tanpa batas, 30 hari, 90 hari, atau 1 tahun — dipilih saat membuat; status berubah Kedaluwarsa setelahnya.
Rotasi / Cabut	Rotasi = kunci baru dengan izin sama, kunci lama langsung tidak berlaku. Cabut = semua permintaan dengan kunci itu langsung ditolak.

Izin per kunci#

Centang izin seperlunya. Izin yang tidak termasuk paket Profil tampil abu-abu.

Baca pesan `pesan:baca`	Kanal, percakapan, riwayat pesan, status kiriman & media.
Kirim pesan `pesan:kirim`	Kirim pesan satu per satu dan unggah media.
Baca kontak `kontak:baca`	Cari dan baca kontak beserta tag-nya.
Ubah kontak `kontak:tulis`	Buat atau perbarui kontak, tambah dan lepas tag.
Broadcast `broadcast:kelola`	Buat, pantau, jeda, dan lanjutkan broadcast.
Template `template:baca`	Daftar template resmi Meta beserta statusnya.
Kelola Inbox `inbox:kelola`	Tugaskan percakapan, tandai selesai, dan tulis catatan internal.
AI Agent `ai:kelola`	Hentikan, lanjutkan, atau serahkan AI Agent ke CS per percakapan.
Webhook `webhook:kelola`	Kelola URL webhook, uji kirim, dan kirim ulang.
Follow up `followup:kelola`	Daftar, buat, jeda, dan lanjutkan follow up WhatsApp, serta antrean per kontak.
Baca pesanan `pesanan:baca`	Pesanan Inbox & halaman toko, tagihan, dan status bayar.
Ubah pesanan `pesanan:tulis`	Buat tagihan (Mayar/transfer) dan isi resi.
Tiket & CSAT `tiket:kelola`	Baca dan ubah status tiket, serta daftar survei kepuasan.
Analitik `analitik:baca`	Angka WhatsApp yang sama dengan halaman Analitik.

Batas permintaan#

Angka berikut adalah setelan yang berlaku saat ini dan bisa diubah tim CSWA.AI.

Per kunci	60 permintaan/menit, lonjakan 20 per 10 detik
Per Profil (semua kunci, REST & MCP)	120/menit, lonjakan 40 per 10 detik
Per IP	240/menit, lonjakan 60 per 10 detik
Kunci aktif per Profil	20
Jatah media per hari	1.024 MB (masa coba 100 MB)
Analitik WhatsApp	10 permintaan/menit per Profil
Pengaman otomatis	20 kunci salah per IP dalam 5 menit → IP diblokir 15 menit; 300 penolakan per kunci dalam 5 menit → kunci diblokir 15 menit
Ukuran	Badan JSON maks. 64 KB; maks. 100 item per halaman

Masalah umum#

Galat 429 (batas_permintaan)

Batas per menit/lonjakan terlewati. Tunggu sesuai header coba lagi, lalu kurangi frekuensi atau antrekan permintaan.

Galat 403 ip_tidak_diizinkan

IP server tidak ada di daftar Batasi IP kunci itu. Tambahkan IP/CIDR yang benar.

Galat 403 mode_test_saja

Aksi itu butuh kunci produksi. Masa coba hanya boleh kunci test.

Status “Diblokir sementara”