Daftar percakapan

Percakapan dalam cakupan pembuat kunci, terbaru dulu.

Halaman berikutnya dengan cursor = next_cursor dari jawaban sebelumnya. Nomor dan nama mengikuti masking role pembuat kunci. Kunci yang dibatasi ke nomor tertentu hanya melihat percakapan nomor itu.

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

Parameter query

statusstring: open | pending | resolved
Saring status.
channelstring
Saring saluran, misalnya whatsapp_qr atau whatsapp_official.
searchstring
Cari nama atau isi pesan terakhir.
limitinteger
1–50, bawaan 25.
cursorstring
next_cursor dari halaman sebelumnya.

Error yang mungkin

400 cursor_invalid Cursor 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
422 invalid_request Field tidak sah
429 rate_limited Terlalu banyak permintaan per menit
500 internal_error Gangguan di Klik Flow

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 querystatuschannelsearchlimitcursor

/api/v2/conversations

Contoh permintaan

curl -X GET "https://klikflow.id/api/v2/conversations?limit=25" \
  -H "Authorization: Bearer KUNCI_API"

Contoh jawaban 200

{
  "data": [
    {
      "id": 812,
      "object": "conversation",
      "channel": "whatsapp_official",
      "contact_id": 301,
      "name": "Rina",
      "status": "open",
      "unread_count": 1,
      "handled_by": null,
      "last_message_at": "2026-11-01T02:10:00.000Z",
      "last_customer_at": "2026-11-01T02:10:00.000Z"
    }
  ],
  "next_cursor": "eyJhIjo4MTJ9"
}

Parameter query

Error yang mungkin

Coba

Kirim WhatsApp dari sistem Anda lewat API Klik Flow.