Perbualan

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
}

• Apabila conversation_id tidak dihantar, sesi perbualan baharu akan dicipta dan dikembalikan dalam respons untuk disertakan dalam mesej seterusnya.
• user dihantar terus oleh pelayan anda kepada kami (pemanggil API Key adalah dipercayai); hanya apabila dihantar, pesanan boleh disemak.
• Bahasa balasan lalai: jika user.language dihantar (seperti de, zh-CN, pt-BR), gunakannya; jika tidak, hantar user.ip, dan kami akan tentukan berdasarkan lokasi; jika kedua-duanya tidak dihantar, gunakan bahasa lalai backend. Selepas pelanggan meminta pertukaran bahasa dalam perbualan, permintaan pelanggan akan diutamakan.
• Apabila stream: false, kembalikan {"conversation_id", "message", "status", "products"}; message bernilai null bermaksud sesi perbualan sedang dilayan oleh ejen manusia dan mesej telah dipindahkan kepada ejen manusia.
• Apabila stream: true, kembalikan SSE; peristiwa lihat jadual di bawah.

Endpoint lain

Status sesi perbualan: ai (jawapan AI), pending_human (menunggu ejen manusia), human (sedang dilayan oleh ejen manusia), closed (tamat).

Sesi perbualan juga mengandungi: closed_by — siapa yang menamatkannya (customer pelanggan, agent ejen, ai AI menamatkan selepas pelanggan menyatakan tiada lagi masalah), rating / rating_comment / rated_at — penilaian pelanggan.

Tamatkan sesi perbualan: Di bahagian atas tetingkap web terdapat butang “Tamatkan sesi perbualan” (pengesahan kedua); dalam WeChat Mini Program, pelanggan menghantar “Tamat” juga akan menamatkan sesi; apabila “AI menamatkan sesi perbualan secara automatik” dihidupkan dalam “Tetapan bot”, AI akan menamatkan sesi selepas mengucapkan selamat tinggal jika pelanggan menyatakan dengan jelas bahawa tiada lagi masalah. Selepas tamat, tetingkap web meminta pelanggan menilai puas hati / tidak puas hati dan boleh meninggalkan mesej; dalam WeChat, pelanggan diminta membalas 1 atau 2; selepas itu, apabila pelanggan menghantar mesej lagi, ia akan menjadi sesi perbualan baharu.

Pengagihan selepas pemindahan kepada ejen manusia: Dalam “Tetapan bot”, pilih kaedah pengagihan — agihkan kepada ejen yang mempunyai sesi perbualan paling sedikit (lalai), agihkan secara bergilir, atau ejen mengambil sendiri. Pengagihan automatik hanya diberikan kepada ejen yang memilih “Dalam talian” dan halaman backend mereka dibuka; setiap ejen mempunyai had pelanggan serentak yang boleh dilayan (ditetapkan dalam halaman “Pasukan”); jika ejen yang ditugaskan tidak membalas melebihi masa yang ditetapkan (lalai 2 minit), tugasan akan dialihkan. Dalam sesi perbualan, assigned_member_id ialah ejen yang ditugaskan, assigned_at ialah masa pengagihan, dan handoff_at ialah masa pemindahan kepada ejen manusia. Apabila semua ejen penuh, pelanggan akan menunggu dalam baris giliran, dan tetingkap web menunjukkan berapa orang lagi di hadapan.

Waktu operasi dan mesej: Selepas waktu operasi dihidupkan dalam “Tetapan bot”, pelanggan yang dipindahkan kepada ejen manusia di luar waktu operasi tidak akan menunggu dalam baris giliran; tetingkap web akan memaparkan borang mesej (nama, e-mel atau nombor telefon, masalah), manakala perbualan dalam WeChat dan Open API akan diminta oleh AI supaya pelanggan meninggalkan mesej; perkara yang sama berlaku jika tiada ejen dalam talian semasa waktu operasi. Mesej yang ditinggalkan akan menjana tiket; apabila ejen membalas, jika sesi perbualan asal belum tamat, balasan akan dihantar ke dalam sesi tersebut, dan jika pelanggan meninggalkan e-mel, e-mel juga akan dihantar atas nama kedai. Apabila hanya push ke sistem anda (pilih “Push ke sistem saya” sebagai kaedah pemindahan kepada ejen manusia), waktu operasi tidak diambil kira.