Kirim pesan

Satu endpoint untuk WhatsApp (scan QR) dan WhatsApp Official: teks, file, template, atau kode OTP.

Pilih saluran dengan channel. Klik Flow memakai nomor pertama yang boleh dipakai kunci, atau nomor di from. WhatsApp Official di luar 24 jam sejak pelanggan terakhir menulis hanya bisa template atau otp. Kirim header Idempotency-Key agar kirim ulang tidak menghasilkan pesan kedua. Kunci tes hanya mengirim ke nomor uji.

Kirim header Idempotency-Key (misalnya UUID baru per permintaan). Ulangan dengan kunci yang sama dalam 24 jam mendapat jawaban pertama lagi, jadi tidak terkirim dua kali.

Kode OTP: {"channel":"whatsapp_official","to":"62812…","type":"otp","otp":{"template":"kode_login","code":"482913"}}.

Kunci: kf_live_ / kf_test_… di header Authorization: Bearer. Dibuat di Pengaturan › API & Webhook › Buat kunci.
Izin kunci: messages:send
Fitur paket: API kirim WhatsApp

Body (JSON)

channelstring: whatsapp_qr | whatsapp_officialwajib
Saluran pengirim.
tostringwajib
Nomor tujuan dengan kode negara; 08… diubah menjadi 628….
typestring: text | image | video | audio | document | template | otpwajib
Jenis pesan. template dan otp hanya untuk whatsapp_official.
fromstring
Nomor pengirim tertentu: id perangkat (whatsapp_qr) atau id nomor (whatsapp_official), dari GET /api/v2/channels.
textobject
{ "body": "…" }, maksimal 4.000 karakter. Untuk type text.
mediaobject
url (https) atau base64 + mime, dengan filename dan caption. Untuk type file.
templateobject
name, language, variables (objek atau array), header_variables, media_url, button_url, coupon_code.
otpobject
template (template Autentikasi) dan code (1–15 huruf, angka, atau -). Kode tidak disimpan.

Error yang mungkin

400 invalid_json Body bukan JSON yang sah
400 idempotency_key_invalid Idempotency-Key tidak sah
401 missing_key Kunci API belum dikirim
401 key_invalid Kunci API tidak dikenal
401 key_revoked Kunci API sudah dicabut
401 key_expired Kunci API kedaluwarsa
401 member_inactive Pembuat kunci bukan anggota lagi
403 ip_not_allowed IP server tidak ada di daftar kunci
403 plan_no_api Paket belum memuat API untuk kunci live
403 tenant_blocked Akses bisnis ditangguhkan
403 scope_missing Kunci tidak punya izin ini
403 permission_missing Role pembuat kunci tidak punya izin ini
403 test_number_required Kunci tes hanya ke nomor uji
403 channel_not_allowed Saluran tidak boleh dipakai kunci ini
403 channel_paused Saluran sedang dijeda
404 not_found Tidak ditemukan
404 template_not_found Template tidak ditemukan atau belum disetujui
409 idempotency_conflict Idempotency-Key dipakai untuk isi lain
409 request_in_progress Permintaan yang sama masih diproses
409 channel_unavailable Tidak ada nomor WhatsApp yang bisa dipakai
409 window_closed Di luar jendela 24 jam
413 media_too_large File terlalu besar
422 invalid_request Field tidak sah
422 invalid_phone Nomor tujuan tidak sah
422 message_too_long Pesan terlalu panjang
422 contact_blocked Kontak diblokir atau berhenti berlangganan
422 template_values Variabel template belum lengkap
422 template_not_supported Jenis template belum didukung
422 otp_code_invalid Kode OTP tidak sah
429 rate_limited Terlalu banyak permintaan per menit
429 daily_limit Batas pesan harian tercapai
429 new_chat_limit Batas chat ke nomor baru tercapai
500 internal_error Gangguan di Klik Flow
502 send_failed Pesan gagal terkirim
502 channel_refused WhatsApp menolak pesan

Coba

Coba sekarang dengan kunci tes

Kunci API tesHanya kunci tes (kf_test_…), disimpan di tab ini saja dan dikirim hanya ke API situs ini. Body (JSON)Idempotency-Key

/api/v2/messages

Contoh permintaan

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_official","to":"6281234567890","type":"template","template":{"name":"konfirmasi_pesanan","language":"id","variables":{"nama":"Rina","orderid":"INV-2207"},"button_url":"INV-2207"}}'

Contoh jawaban 200

{
  "data": {
    "id": 99140,
    "object": "message",
    "conversation_id": 812,
    "channel": "whatsapp_official",
    "to": "6281234567890",
    "type": "template",
    "status": "sent",
    "test": false
  }
}

Body (JSON)

Error yang mungkin

Coba

Kirim WhatsApp dari sistem Anda lewat API Klik Flow.