Kirim pesan

Kirim teks atau media ke pelanggan di percakapan yang sudah ada.

POST/v1/message

Kirim balasan ke percakapan yang sudah berjalan, di channel apa pun (WhatsApp, Telegram, Instagram, webchat, dan lainnya). CSKU meneruskan pesan ke channel percakapan tersebut.

Butuh conversation_id

Endpoint ini hanya membalas percakapan yang sudah ada. conversation_id didapat dari webhook channel.message_in atau dari URL chat di dashboard.

Request

HTTP

POST /v1/message
Business: BIZ_ID_ANDA
Secret: SECRET_ANDA
Content-Type: application/json

Field	Tipe	Wajib	Keterangan
`conversation_id`	string	ya	ID percakapan, contoh `CO_01J9…`
`text`	string	salah satu	Isi pesan teks
`media`	object	salah satu	Lampiran. Jika `media` diisi, `text` diabaikan
`reply_to_message_id`	string	tidak	`message_id` pesan yang dibalas

Objek media:

Field	Tipe	Keterangan
`url`	string	URL publik file (https)
`type`	string	`image`, `video`, `audio`, atau `document`
`mime_type`	string	`image/jpeg`, `image/png`, `video/mp4`, `audio/mp3`, atau `text/plain`
`name`	string	Nama file (opsional)
`caption`	string	Teks di bawah media (opsional)
`thumbnail`	string	URL thumbnail (opsional)

Contoh: teks

Terminal

curl -X POST https://api.csku.ai/v1/message \
  -H "Business: BIZ_ID_ANDA" \
  -H "Secret: SECRET_ANDA" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_id": "CO_01J9Z3K8V2",
    "text": "Pesanan #INV-2291 sudah dikirim via JNE ya kak."
  }'

Contoh: gambar

JSON

{
  "conversation_id": "CO_01J9Z3K8V2",
  "media": {
    "url": "https://cdn.toko-anda.com/resi/INV-2291.jpg",
    "type": "image",
    "mime_type": "image/jpeg",
    "caption": "Foto resi pengiriman"
  }
}

Respons

JSON

{ "conversation_id": "CO_01J9Z3K8V2", "success": true }

success: true berarti pesan diterima CSKU dan diteruskan ke channel. Status terkirim ke pelanggan bisa dicek lewat Ambil pesan.

Perilaku yang perlu diketahui

Pesan tampil di inbox dashboard sebagai balasan agent dengan nama bisnis Anda.
Mengirim pesan lewat API tidak memicu webhook agent.message_out.
Jika text berisi kalimat sekaligus link, CSKU memeriksa setiap link. Link gambar dikirim sebagai pesan gambar terpisah, dan link yang tidak bisa diakses dihapus dari teks. Teks yang isinya hanya satu link dikirim apa adanya.
Aturan channel tetap berlaku. Misalnya di WhatsApp API, pesan bebas hanya bisa dikirim dalam 24 jam sejak pesan terakhir pelanggan. Di luar itu, kirim template lewat Proxy WhatsApp API.