Menu dokumentasiMinta jawaban AI
Dokumentasi APIEnglish

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.

Kunci
kf_live_ / kf_test_… di header Authorization: Bearer. Dibuat di Pengaturan › API & Webhook › Buat kunci.
Izin kunci
ai:reply
Fitur paket
API kirim WhatsApp, AI Agent (balas otomatis)

Parameter alamat

  • idintegerwajib

    Id agent dari Daftar AI Agent.

Body (JSON)

  • messagestringwajib

    Pesan pelanggan, maksimal 4.000 karakter.

  • session_idstringwajib

    Id sesi dari aplikasi Anda, satu per pengguna aplikasi: 1–128 huruf, angka, atau . _ : @ -. Pesan dengan session_id yang sama dijawab dengan mengingat riwayatnya.

  • customerobject

    Opsional: { "ref", "name", "phone" }. name dipakai untuk menyapa pelanggan. phone (8–15 digit dengan kode negara) membuka status pesanan pelanggan itu bila kunci juga punya izin contacts:read dan saklar status pesanan di AI Agent › Integrasi menyala. ref (id pelanggan di aplikasi Anda) diterima tetapi tidak dipakai untuk menjawab.

  • formatstring: plain | whatsapp | markdown

    Bentuk teks reply: plain tanpa format (bawaan), whatsapp dengan *tebal* dan _miring_, atau markdown.

Error yang mungkin

Coba

Coba sekarang dengan kunci tes
Parameter alamat
/api/v2/ai/agents/{id}/replies

Kirim WhatsApp dari sistem Anda lewat API Klik Flow.

Mulai dengan paket Free. Ajak tim setelah ruang kerja siap.