Ambil pesan

Ambil riwayat pesan sebuah percakapan, urut dari yang terlama.

GET/v1/message/{conversation_id}

Ambil semua pesan dalam satu percakapan, termasuk pesan pelanggan, balasan AI, balasan agent, dan catatan internal.

Request

HTTP

GET /v1/message/{conversation_id}?limit=50&last_id=0
Business: BIZ_ID_ANDA
Secret: SECRET_ANDA

Parameter	Lokasi	Keterangan
`conversation_id`	path	ID percakapan
`limit`	query	Jumlah pesan. Kosong atau `0` = semua pesan
`last_id`	query	Ambil pesan dengan `id` lebih besar dari nilai ini. Pakai untuk ambil pesan baru saja

Pesan diurutkan dari yang terlama (id naik).

Contoh

Terminal

curl "https://api.csku.ai/v1/message/CO_01J9Z3K8V2?limit=50" \
  -H "Business: BIZ_ID_ANDA" \
  -H "Secret: SECRET_ANDA"

Respons

JSON

{
  "status": 1,
  "rc": 200,
  "message": "list message",
  "data": {
    "list": [
      {
        "id": 10231,
        "message_id": "MSG_01J9Z3M1AB",
        "conversation_id": "CO_01J9Z3K8V2",
        "sender": "user",
        "sender_name": "Budi Santoso",
        "message": "Kak, pesanan saya kapan dikirim?",
        "caption": "",
        "message_type": "text",
        "mime_type": "text/plain",
        "sent_at": "2026-10-14 09:40:12",
        "delivery_status": "read"
      }
    ],
    "last_id": 10231
  },
  "ts": 1760409612
}

Field	Keterangan
`sender`	`user` (pelanggan), `agent` (AI, agent manusia, atau API), atau `system`
`sender_name`	Nama pengirim. Balasan AI berformat `Nama AI - Label`
`message`	Teks pesan, atau URL file untuk pesan media
`caption`	Keterangan media
`message_type`	`text`, `image`, `video`, `audio`, `document`, dan lainnya
`delivery_status`	`pending`, `sent`, `delivered`, `read`, atau `failed`
`reply_to_message_id`	ID pesan yang dibalas di channel (hanya ada jika pesan berupa balasan)
`sent_at`	Waktu WIB, format `YYYY-MM-DD HH:MM:SS`

Ambil pesan baru saja

Simpan last_id dari respons, lalu kirim lagi sebagai query untuk mendapat pesan setelahnya:

Terminal

curl "https://api.csku.ai/v1/message/CO_01J9Z3K8V2?last_id=10231" \
  -H "Business: BIZ_ID_ANDA" -H "Secret: SECRET_ANDA"

Jika tidak ada pesan baru, list bernilai null dan last_id 0.

Untuk tahu kapan ada pesan baru, pakai webhook daripada memanggil endpoint ini berulang kali.

conversation_id yang tidak dikenal mengembalikan daftar kosong, bukan error. Catatan internal ikut tercantum dan tidak punya penanda khusus.