Percakapan

Berbicara dengan AI di aplikasi atau sistem layanan pelanggan Anda sendiri, mendukung respons streaming, serta pengalihan sesi ke agen manusia, pengakhiran, dan penilaian.

POST /v1/chat

{
  "message": "有没有 400 美元以内的潜水表？",
  "conversation_id": null,
  "user": {"id": "u_123", "name": "李四", "email": "li@example.com", "ip": "85.214.132.117", "language": null},
  "stream": false
}

Jika conversation_id tidak dikirim, sesi baru akan dibuat; ID-nya dikembalikan di respons dan disertakan pada pesan-pesan berikutnya.
user dikirim langsung oleh server Anda kepada kami (pemanggil API Key dianggap tepercaya); data ini hanya bisa dipakai untuk memeriksa pesanan jika disertakan.
Bahasa balasan default: jika Anda mengirim user.language (misalnya de, zh-CN, pt-BR), bahasa tersebut yang dipakai; jika tidak, kirim user.ip dan kami akan menentukannya berdasarkan lokasi; jika keduanya tidak dikirim, bahasa default di backend yang digunakan. Setelah pelanggan meminta ganti bahasa di dalam percakapan, permintaan pelanggan yang diutamakan.
Saat stream: false, responsnya adalah {"conversation_id", "message", "status", "products"}; message bernilai null berarti sesi sedang ditangani agen manusia dan pesan sudah diteruskan ke mereka.
Saat stream: true, respons berupa SSE; event-nya dapat dilihat pada tabel berikut.

Event `type`	Isi
`user_message`	Pesan pengguna yang telah disimpan
`delta`	Sepotong teks jawaban `text`, disambungkan sesuai urutan
`products`	Kartu produk yang ditemukan AI
`language`	Pelanggan meminta ganti bahasa balasan; `language` adalah kode bahasa baru
`status`	Perubahan status sesi (misalnya dialihkan ke agen manusia)
`replace`	Mengganti seluruh jawaban yang sudah diterima dengan `text` (saat error diganti dengan pesan cadangan)
`queued_for_human`	Sesi sedang ditangani agen manusia, tidak ada jawaban AI
`done`	Pesan dan status sesi yang tersimpan final
`error`	Terjadi error

Endpoint lainnya

Metode	Path	Keterangan
GET	`/v1/conversations`	Daftar sesi, `?status=&end_user_id=`
GET	`/v1/conversations/{id}/messages`	Sesi dan seluruh pesannya
POST	`/v1/conversations/{id}/messages`	Sistem layanan pelanggan Anda membalas sebagai agen manusia: `{"content", "agent_name"}`; sesi langsung masuk status ditangani manusia
POST	`/v1/conversations/{id}/status`	Tindakan dari sisi agen: `{"status": "ai"}` mengembalikan sesi ke AI, `{"status": "closed"}` mengakhiri sesi
POST	`/v1/conversations/{id}/close`	Pelanggan mengakhiri sesi di App Anda; sesi yang sudah berakhir tetap mengembalikan sukses
POST	`/v1/conversations/{id}/rating`	Penilaian pelanggan setelah sesi berakhir: `{"rating": "good" \| "bad", "comment": "可选，最多 500 字"}`, dapat diubah

Status sesi: ai (dijawab AI), pending_human (menunggu agen manusia), human (sedang ditangani agen manusia), closed (sudah berakhir).

Di dalam sesi juga ada: closed_by siapa yang mengakhiri (customer pelanggan, agent agen, ai AI mengakhiri setelah pelanggan menyatakan tidak ada pertanyaan lain), rating / rating_comment / rated_at penilaian pelanggan.

Mengakhiri sesi: Di bagian atas jendela web terdapat tombol "Akhiri Sesi" (dengan konfirmasi kedua); di mini program WeChat, pelanggan yang mengirim "结束" juga akan mengakhiri sesi; jika "AI mengakhiri sesi secara otomatis" diaktifkan di "Pengaturan Robot", AI akan berpamitan lalu mengakhiri sesi ketika pelanggan menyatakan dengan jelas tidak ada pertanyaan lain. Setelah sesi berakhir, jendela web meminta pelanggan menilai puas / tidak puas dan dapat meninggalkan pesan, sedangkan di WeChat pelanggan diminta membalas 1 atau 2; pesan pelanggan setelahnya akan menjadi sesi baru.

Penugasan setelah dialihkan ke agen manusia: Di "Pengaturan Robot" pilih cara penugasan—berikan kepada agen dengan sesi aktif paling sedikit (default), bergiliran, atau agen mengambil sendiri. Penugasan otomatis hanya diberikan kepada agen yang memilih "Online" dan halaman backend-nya sedang terbuka, dengan batas jumlah sesi bersamaan per agen (diatur di halaman "Tim"); jika agen yang ditugaskan tidak membalas dalam batas waktu yang ditentukan (default 2 menit), sesi dialihkan ke agen lain. Di dalam sesi, assigned_member_id adalah agen yang ditugaskan, assigned_at adalah waktu penugasan, dan handoff_at adalah waktu pengalihan ke agen manusia. Saat semua agen penuh, pelanggan akan mengantre dan jendela web menampilkan berapa orang yang ada di depan.

Jam operasional dan pesan: Setelah jam operasional diaktifkan di "Pengaturan Robot", di luar jam operasional pelanggan yang dialihkan ke agen manusia tidak akan mengantre; jendela web menampilkan formulir pesan (nama, email atau nomor ponsel, pertanyaan), sedangkan percakapan di WeChat dan Open API akan diminta meninggalkan pesan oleh AI; hal yang sama berlaku saat tidak ada agen yang online di dalam jam operasional. Pesan tersebut menghasilkan tiket; saat agen membalas, jika sesi asli belum berakhir balasan dikirim ke sesi tersebut, dan jika pelanggan meninggalkan email, email juga dikirim atas nama toko. Jika hanya didorong ke sistem Anda (memilih "Kirim ke sistem saya" sebagai cara pengalihan), jam operasional tidak berlaku.

Apakah halaman ini membantu?

Terakhir diperbarui: 31 Oktober 2026