Balas percakapan

Balas teks atau file di percakapan yang bisa dilihat pembuat kunci, di saluran mana pun yang dibalas Inbox.

WhatsApp Official butuh jendela 24 jam; di luarnya kirim template lewat Kirim pesan. Kunci tes hanya membalas percakapan dengan nomor uji. Pakai Idempotency-Key.

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.

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

Parameter alamat

idintegerwajib
Id percakapan.

Body (JSON)

typestring: text | image | video | audio | document
Bawaan text.
textobject
{ "body": "…" }.
mediaobject
Sama dengan Kirim pesan.

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
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
429 rate_limited Terlalu banyak permintaan per menit
429 daily_limit Batas pesan harian tercapai
500 internal_error Gangguan di Klik Flow
502 send_failed Pesan gagal terkirim

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.

Parameter alamatid

Body (JSON)Idempotency-Key

/api/v2/conversations/{id}/messages

Contoh permintaan

curl -X POST "https://klikflow.id/api/v2/conversations/812/messages" \
  -H "Authorization: Bearer KUNCI_API" \
  -H "Idempotency-Key: 6f1c2a8e-4b1d-4c3a-9e2f-1a2b3c4d5e6f" \
  -H "Content-Type: application/json" \
  -d '{"type":"text","text":{"body":"Ongkir ke Bandung Rp18.000, Kak."}}'

Contoh jawaban 200

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

Parameter alamat

Body (JSON)

Error yang mungkin

Coba

Kirim WhatsApp dari sistem Anda lewat API Klik Flow.