Pengembang

API Keys

API key menyediakan akses terprogram ke API Qwetty. Kelola di Pengaturan → API Keys.

Membuat API key

Buka Pengaturan → API Keys
Klik Buat API Key
Konfigurasi key:
- Name — Nama deskriptif (misalnya, "Integrasi CRM")
- Description — Kegunaan key
- Permissions — Pilih operasi yang dapat dilakukan key
- IP Whitelist — Secara opsional batasi pada alamat IP tertentu
- Expiration — Secara opsional tetapkan tanggal kedaluwarsa
Klik Create
Salin key segera — key tidak akan ditampilkan lagi

Mengelola key

Dari daftar API Keys, Anda dapat:

Tindakan	Deskripsi
View	Melihat detail key, izin, dan statistik penggunaan
Regenerate	Menghasilkan nilai key baru (membatalkan yang lama)
Revoke	Menonaktifkan key secara langsung
Reactivate	Mengaktifkan kembali key yang sebelumnya dicabut
Delete	Menghapus key secara permanen

Status key

Status	Keterangan
Active	Key valid dan menerima permintaan
Revoked	Key telah dinonaktifkan secara manual
Expired	Key telah melewati tanggal kedaluwarsa
Expiring Soon	Key akan kedaluwarsa dalam 7 hari

Izin

API key menggunakan izin terperinci untuk mengontrol akses. Berikan hanya izin yang dibutuhkan setiap integrasi. Izin yang tersedia adalah:

chats:view — Membaca chat dan pesan
chats:send_message — Mengirim pesan
contacts:view — Membaca kontak
templates:view — Membaca template (juga diperlukan untuk mengirim template pesan)

Key dengan izin wildcard * mendapatkan semua izin di atas. Mengirim template pesan memerlukan templates:view dan chats:send_message sekaligus.

Pelacakan penggunaan

Setiap key melacak:

Request count — Total panggilan API yang dilakukan dengan key ini
Last used — Stempel waktu permintaan terbaru

Lihat statistik penggunaan di Pengaturan → API Keys → [Key Anda].

Batas rate (Rate Limit)

API dibatasi pada 60 permintaan per 60 detik per API key. Ketika Anda melebihinya, API mengembalikan 429 Too Many Requests.

Secara terpisah, setiap organisasi memiliki kuota permintaan bulanan berdasarkan paketnya. Melebihi kuota bulanan mengembalikan 403 Forbidden.

Lihat Batas Rate untuk format header dan body respons.

Langkah selanjutnya

Autentikasi — Cara kerja autentikasi API key
Kirim Pesan Pertama — Menggunakan key untuk mengirim pesan
Referensi API — Dokumentasi endpoint lengkap

Last modified on June 10, 2026

Autentikasi Webhook

Membuat API key

Buka Pengaturan → API Keys

Klik Buat API Key

Konfigurasi key:

Name — Nama deskriptif (misalnya, "Integrasi CRM")
Description — Kegunaan key
Permissions — Pilih operasi yang dapat dilakukan key
IP Whitelist — Secara opsional batasi pada alamat IP tertentu
Expiration — Secara opsional tetapkan tanggal kedaluwarsa

Klik Create

Salin key segera — key tidak akan ditampilkan lagi

Tindakan

Deskripsi

View

Melihat detail key, izin, dan statistik penggunaan

Regenerate

Menghasilkan nilai key baru (membatalkan yang lama)

Revoke

Menonaktifkan key secara langsung

Reactivate

Mengaktifkan kembali key yang sebelumnya dicabut

Delete

Menghapus key secara permanen

Status

Keterangan

Active

Key valid dan menerima permintaan

Revoked

Key telah dinonaktifkan secara manual

Expired

Key telah melewati tanggal kedaluwarsa

Expiring Soon

Key akan kedaluwarsa dalam 7 hari

Izin

API key menggunakan izin terperinci untuk mengontrol akses. Berikan hanya izin yang dibutuhkan setiap integrasi. Izin yang tersedia adalah:

chats:view — Membaca chat dan pesan

chats:send_message — Mengirim pesan

contacts:view — Membaca kontak

templates:view — Membaca template (juga diperlukan untuk mengirim template pesan)

Key dengan izin wildcard * mendapatkan semua izin di atas. Mengirim template pesan memerlukan templates:view dan chats:send_message sekaligus.

Batas rate (Rate Limit)

API dibatasi pada 60 permintaan per 60 detik per API key. Ketika Anda melebihinya, API mengembalikan 429 Too Many Requests.

Secara terpisah, setiap organisasi memiliki kuota permintaan bulanan berdasarkan paketnya. Melebihi kuota bulanan mengembalikan 403 Forbidden.

Lihat Batas Rate untuk format header dan body respons.