Dokumentasi APIEnglish

Kirim WhatsApp pertama dari sistem Anda dalam 5 menit.

Empat langkah dengan API v2: buat kunci tes, daftarkan nomor HP Anda sebagai nomor uji, kirim satu pesan, lalu baca statusnya. Semua contoh memakai alamat https://klikflow.id.

Satu kunci untuk semua nomor WhatsAppKunci tes hanya ke nomor ujiKirim ulang aman dengan Idempotency-KeyContoh cURL, Node.js, PHP, Python

Apa yang saya perlukan untuk memakai API Klik Flow?

Akun Klik Flow dan satu nomor WhatsApp yang sudah tersambung (scan QR atau WhatsApp Official). Kunci tes bisa dibuat di semua paket; kunci live butuh paket dengan fitur API. Kunci dikirim di header setiap permintaan; tidak ada SDK yang wajib dipasang.

1. Buat Kunci API tes

Buka Pengaturan › API & Webhook › Buat kunci. Pilih jenis Tes, beri nama, lalu centang izin Lihat bisnis dan saluran serta Kirim pesan. Kunci kf_test_… hanya tampil sekali: simpan sebagai rahasia di server Anda, jangan di aplikasi HP atau kode halaman web.

Kunci tes hanya mengirim ke nomor uji dan tidak memakai kuota pesan paket.
Setelah integrasi siap, buat kunci Live (kf_live_…) dengan izin yang sama.

2. Daftarkan nomor uji

Kirim satu pesan WhatsApp dari HP Anda ke nomor WhatsApp bisnis. Lalu tambahkan nomor HP itu di Pengaturan › API & Webhook › Nomor uji (maksimal 5 nomor).

3. Kirim pesan

Nomor tujuan memakai kode negara; 08… otomatis menjadi 628….

curl -X POST "https://klikflow.id/api/v2/messages" \
  -H "Authorization: Bearer KUNCI_API" \
  -H "Idempotency-Key: 6f1c2a8e-4b1d-4c3a-9e2f-1a2b3c4d5e6f" \
  -H "Content-Type: application/json" \
  -d '{"channel":"whatsapp_qr","to":"6281234567890","type":"text","text":{"body":"Halo dari API Klik Flow"}}'

Jawaban berhasil:

{
  "data": { "id": 99140, "object": "message", "conversation_id": 812, "channel": "whatsapp_qr", "to": "6281234567890", "type": "text", "status": "sent", "test": true }
}

Kiriman juga tampil di Inbox. Untuk WhatsApp Official, isi channel dengan whatsapp_official.

4. Cek status

curl "https://klikflow.id/api/v2/messages/99140" -H "Authorization: Bearer KUNCI_API"

status berisi pending, sent, delivered, read, atau failed.

Kalau gagal

Setiap error memakai status HTTP yang sesuai dan bentuk yang sama:

{
  "error": {
    "type": "permission_error",
    "code": "test_number_required",
    "message": "Kunci tes hanya mengirim ke nomor uji. …",
    "param": "to",
    "doc_url": "https://klikflow.id/docs/api/error#test_number_required",
    "request_id": "req_8Kx2Qm"
  }
}

doc_url menuju penjelasan kode itu. Saat batas tercapai (429), tunggu sesuai header Retry-After.