POST/api/v2/ai/agents/{id}/replies
Minta jawaban AI
Jawaban AI Agent untuk satu pesan pelanggan di aplikasi Anda, dengan Perilaku, pengetahuan, dan Tanya-jawab agent itu.
Klik Flow tidak mengirim apa pun ke pelanggan: aplikasi Anda yang menampilkan reply. Kirim hanya pesan baru; Klik Flow mengingat 16 giliran terakhir sesi selama 24 jam sejak pesan terakhir, dan menjawab satu pesan sekaligus per sesi. Jawaban butuh beberapa detik, jadi beri batas waktu permintaan 60 detik. Kunci live memotong kredit AI dengan tarif "Jawaban AI Agent untuk aplikasi (API)"; kunci tes menjawab dalam kuota Uji AI gratis tanpa kredit. Panggil dari server aplikasi Anda saja, dengan Idempotency-Key. Lihat panduan Tanya AI Agent.
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.
Setelah outcome: "handoff", tampilkan reply lalu arahkan pelanggan ke tim Anda: pesan berikutnya di sesi itu mendapat session_handoff (409) sampai sesi ditutup atau 24 jam berlalu.
Parameter alamat
idintegerwajibId agent dari Daftar AI Agent.
Body (JSON)
messagestringwajibPesan pelanggan, maksimal 4.000 karakter.
session_idstringwajibId sesi dari aplikasi Anda, satu per pengguna aplikasi: 1–128 huruf, angka, atau
. _ : @ -. Pesan dengansession_idyang sama dijawab dengan mengingat riwayatnya.customerobjectOpsional:
{ "ref", "name", "phone" }.namedipakai untuk menyapa pelanggan.phone(8–15 digit dengan kode negara) membuka status pesanan pelanggan itu bila kunci juga punya izincontacts:readdan saklar status pesanan di AI Agent › Integrasi menyala.ref(id pelanggan di aplikasi Anda) diterima tetapi tidak dipakai untuk menjawab.formatstring: plain | whatsapp | markdownBentuk teks
reply:plaintanpa format (bawaan),whatsappdengan *tebal* dan _miring_, ataumarkdown.
Error yang mungkin
- 400
invalid_jsonBody bukan JSON yang sah - 400
idempotency_key_invalidIdempotency-Key tidak sah - 401
missing_keyKunci API belum dikirim - 401
key_invalidKunci API tidak dikenal - 401
key_revokedKunci API sudah dicabut - 401
key_expiredKunci API kedaluwarsa - 401
member_inactivePembuat kunci bukan anggota lagi - 402
ai_credit_emptyKredit AI habis - 403
ip_not_allowedIP server tidak ada di daftar kunci - 403
plan_no_apiPaket belum memuat API untuk kunci live - 403
tenant_blockedAkses bisnis ditangguhkan - 403
scope_missingKunci tidak punya izin ini - 403
permission_missingRole pembuat kunci tidak punya izin ini - 403
agent_not_api_enabledAI Agent belum dibuka untuk API - 403
ai_feature_offFitur AI untuk aplikasi mati - 404
agent_not_foundAI Agent tidak ditemukan - 409
idempotency_conflictIdempotency-Key dipakai untuk isi lain - 409
request_in_progressPermintaan yang sama masih diproses - 409
session_handoffSesi sudah dioper ke admin - 409
session_busyJawaban sebelumnya di sesi ini belum selesai - 422
invalid_requestField tidak sah - 422
invalid_phoneNomor tujuan tidak sah - 422
message_too_longPesan terlalu panjang - 429
rate_limitedTerlalu banyak permintaan per menit - 429
session_limitBatas jawaban AI tercapai - 500
internal_errorGangguan di Klik Flow - 503
ai_unavailableAI sedang gagal menjawab
Coba
Coba sekarang dengan kunci tes
/api/v2/ai/agents/{id}/replies