การสนทนา

สนทนากับ AI ภายในแอปหรือระบบบริการลูกค้าของคุณ รองรับการตอบกลับแบบสตรีมมิ่ง พร้อมทั้งการโอนสายให้พนักงานจริง การสิ้นสุดการสนทนา และการให้คะแนน

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
}
  • หากไม่ได้ส่ง conversation_id ระบบจะสร้างบทสนทนาใหม่ และส่งคืนค่าใน response เพื่อให้ใส่ค่านี้ในข้อความถัดไป
  • user ถูกส่งมาจากเซิร์ฟเวอร์ของคุณโดยตรง (ผู้เรียกที่ใช้ API Key ได้รับความไว้วางใจ) ต้องส่งมาจึงจะตรวจสอบคำสั่งซื้อได้
  • ภาษาเริ่มต้นสำหรับการตอบกลับ: หากส่ง user.language (เช่น de, zh-CN, pt-BR) มา ระบบจะใช้ค่านั้น; มิฉะนั้นหากส่ง user.ip มา ระบบจะพิจารณาจากตำแหน่งที่ตั้ง; หากไม่ส่งทั้งสองอย่าง ระบบจะใช้ภาษาเริ่มต้นจากหลังบ้าน หากลูกค้าขอเปลี่ยนภาษาในบทสนทนา ให้ยึดตามคำขอของลูกค้า
  • เมื่อ stream: false ระบบจะส่งคืน {"conversation_id", "message", "status", "products"}; หาก message เป็น null หมายความว่าบทสนทนาอยู่ระหว่างการดูแลโดยเจ้าหน้าที่ และข้อความถูกส่งต่อให้เจ้าหน้าที่แล้ว
  • เมื่อ stream: true ระบบจะส่งคืน SSE ดูเหตุการณ์ได้ในตารางด้านล่าง
เหตุการณ์ typeเนื้อหา
user_messageข้อความของผู้ใช้ที่บันทึกแล้ว
deltaข้อความส่วนหนึ่งของคำตอบ text ที่นำมาเรียงต่อกันตามลำดับ
productsการ์ดสินค้าที่ AI ค้นพบ
languageลูกค้าขอเปลี่ยนภาษาที่ใช้ตอบกลับ language คือรหัสภาษาใหม่
statusสถานะบทสนทนาเปลี่ยนแปลง (เช่น ส่งต่อให้เจ้าหน้าที่)
replaceแทนที่คำตอบที่ได้รับแล้วทั้งหมดด้วย text (เมื่อเกิดข้อผิดพลาดจะเปลี่ยนเป็นข้อความสำรอง)
queued_for_humanบทสนทนาอยู่ระหว่างการดูแลโดยเจ้าหน้าที่ ไม่มีคำตอบจาก AI
doneข้อความและสถานะบทสนทนาที่บันทึกขั้นสุดท้าย
errorเกิดข้อผิดพลาด

API อื่น ๆ

เมธอดเส้นทางคำอธิบาย
GET/v1/conversationsรายการบทสนทนา, ?status=&end_user_id=
GET/v1/conversations/{id}/messagesบทสนทนาและข้อความทั้งหมด
POST/v1/conversations/{id}/messagesระบบบริการลูกค้าของคุณตอบกลับในฐานะเจ้าหน้าที่: {"content", "agent_name"} จากนั้นบทสนทนาจะเข้าสู่สถานะเจ้าหน้าที่
POST/v1/conversations/{id}/statusการดำเนินการฝั่งเจ้าหน้าที่: {"status": "ai"} ส่งคืนให้ AI, {"status": "closed"} จบบทสนทนา
POST/v1/conversations/{id}/closeลูกค้าจบบทสนทนาใน App ของคุณ; แม้จบไปแล้วก็จะส่งคืนผลสำเร็จ
POST/v1/conversations/{id}/ratingหลังจบบทสนทนา ลูกค้าประเมิน: {"rating": "good" | "bad", "comment": "可选，最多 500 字"} และสามารถแก้ไขได้

สถานะบทสนทนา: ai (AI ตอบ), pending_human (รอเจ้าหน้าที่), human (เจ้าหน้าที่กำลังดูแล), closed (จบแล้ว)

ในบทสนทนายังมี: closed_by ผู้ที่จบ ( customer ลูกค้า, agent เจ้าหน้าที่, ai AI จบหลังจากลูกค้าระบุว่าไม่มีคำถามอื่น ), rating / rating_comment / rated_at การประเมินของลูกค้า

การจบบทสนทนา: ที่ส่วนหัวของหน้าต่างเว็บมีปุ่ม「จบการสนทนา」 (ยืนยันสองครั้ง); ใน WeChat Mini Program หากลูกค้าส่ง「จบ」 ระบบก็จะจบการสนทนาเช่นกัน; เมื่อเปิด「AI จบการสนทนาอัตโนมัติ」ในการตั้งค่าบอท หากลูกค้าระบุชัดเจนว่าไม่มีคำถามอื่น AI จะกล่าวลาแล้วจบการสนทนา หลังจบ หน้าต่างเว็บจะให้ลูกค้าประเมินว่าพอใจ / ไม่พอใจ และสามารถฝากข้อความได้ ส่วนใน WeChat จะให้ลูกค้าตอบ 1 หรือ 2; หลังจากนั้นหากลูกค้าส่งข้อความอีกครั้ง จะถือเป็นบทสนทนาใหม่

การมอบหมายหลังส่งต่อให้เจ้าหน้าที่: ในการตั้งค่าบอท ให้เลือกวิธีมอบหมาย—มอบหมายให้เจ้าหน้าที่ที่มีบทสนทนาที่ดูแลอยู่น้อยที่สุด (ค่าเริ่มต้น), มอบหมายแบบเวียน, หรือให้เจ้าหน้าที่รับเอง การมอบหมายอัตโนมัติจะมอบหมายให้เฉพาะเจ้าหน้าที่ที่เลือก「ออนไลน์」และเปิดหน้าแผงควบคุมอยู่เท่านั้น แต่ละคนมีขีดจำกัดจำนวนบทสนทนาที่ดูแลพร้อมกัน (ตั้งค่าในหน้า「ทีม」); หากเจ้าหน้าที่ที่ได้รับมอบหมายไม่ตอบกลับเกินเวลาที่กำหนด (ค่าเริ่มต้น 2 นาที) ระบบจะมอบหมายใหม่ ในบทสนทนา assigned_member_id คือเจ้าหน้าที่ที่ได้รับมอบหมาย, assigned_at คือเวลาที่มอบหมาย, handoff_at คือเวลาที่ส่งต่อให้เจ้าหน้าที่ เมื่อเจ้าหน้าที่เต็ม ลูกค้าจะต่อคิว และหน้าต่างเว็บจะแสดงว่ามีคนอยู่ข้างหน้ากี่คน

เวลาทำการและการฝากข้อความ: หลังจากเปิดเวลาทำการในการตั้งค่าบอทแล้ว หากลูกค้าส่งต่อให้เจ้าหน้าที่นอกเวลาทำการ จะไม่มีการต่อคิว หน้าต่างเว็บจะแสดงแบบฟอร์มฝากข้อความ (ชื่อที่ใช้เรียก, อีเมลหรือโทรศัพท์, คำถาม) บทสนทนาบน WeChat และ Open API ให้ AI เชิญลูกค้าฝากข้อความ; เช่นเดียวกันหากภายในเวลาทำการไม่มีเจ้าหน้าที่ออนไลน์ ข้อความที่ฝากจะสร้าง ticket เมื่อเจ้าหน้าที่ตอบกลับ หากบทสนทนาเดิมยังไม่จบ จะส่งเข้าไปในบทสนทนานั้น และหากลูกค้าฝากอีเมลไว้ ระบบจะส่งอีเมลในนามของร้านด้วย หากตั้งค่าให้ส่งต่อไปยังระบบของคุณเท่านั้น (เลือก「ส่งไปยังระบบของฉัน」ในวิธีส่งต่อให้เจ้าหน้าที่) ระบบจะไม่พิจารณาเวลาทำการ

หน้านี้มีประโยชน์ไหม?

อัปเดตล่าสุด: