المحادثة

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، تُنشأ محادثة جديدة ويُعاد معرّفها في الاستجابة، ثم تُرسله مع الرسائل اللاحقة.
• يُرسِل خادمك user إلينا مباشرةً (فمستخدم مفتاح API موثوق)، ولا يمكن الاستعلام عن الطلبات إلا عند إرساله.
• لغة الرد الافتراضية: إذا أرسلت user.language (مثل de أو zh-CN أو pt-BR) استُخدمت هي؛ وإلا فأرسل user.ip لنحدّدها حسب الموقع؛ وإذا لم تُرسل أيًّا منهما استُخدمت اللغة الافتراضية في لوحة التحكم. وإذا طلب العميل تغيير اللغة أثناء المحادثة، فطلبه هو المعتمد.
• عند stream: false تُعاد الاستجابة {"conversation_id", "message", "status", "products"}؛ وتعني message بقيمتها null أن المحادثة يتولاها موظف، وأن الرسالة قد حُوّلت إليه.
• عند stream: true تُعاد استجابة SSE، والأحداث موضّحة في الجدول أدناه.

واجهات أخرى

حالات المحادثة: ai (يرد AI)، pending_human (بانتظار موظف)، human (موظف يتولاها)، closed (منتهية).

تتضمن المحادثة أيضًا: closed_by من أنهى المحادثة (customer العميل، agent الموظف، ai أنهى AI المحادثة بعد أن أكّد العميل عدم وجود أسئلة أخرى)، وrating / rating_comment / rated_at تقييم العميل.

إنهاء المحادثة: في أعلى نافذة الويب زر «إنهاء المحادثة» (مع تأكيد ثانٍ)؛ وفي تطبيق وي تشات المصغّر تنتهي المحادثة أيضًا عندما يرسل العميل «إنهاء»؛ وعند تفعيل «AI ينهي المحادثة تلقائيًا» في «إعدادات الروبوت»، يُنهي AI المحادثة بعد توديعه عندما يؤكّد العميل صراحةً عدم وجود أسئلة أخرى. بعد الإنهاء تطلب نافذة الويب من العميل تقييم رضاه / عدم رضاه ويمكنه ترك تعليق، وفي وي تشات يُطلب منه الرد بـ 1 أو 2؛ وأي رسالة يرسلها العميل بعد ذلك تبدأ محادثة جديدة.

التوزيع بعد التحويل إلى موظف: اختر طريقة التوزيع في «إعدادات الروبوت» — إلى الموظف الأقل محادثات (افتراضيًا)، أو بالتناوب، أو أن يتولى الموظف المحادثة بنفسه. التوزيع التلقائي لا يتم إلا للموظفين الذين اختاروا «متصل» وصفحة لوحة التحكم مفتوحة لديهم، ولكل موظف حدّ أقصى للمحادثات المتزامنة (يُضبط في صفحة «الفريق»)؛ وإذا لم يرد الموظف المُسنَد إليه خلال المدة المحددة (دقيقتان افتراضيًا) تُعاد المحادثة إلى موظف آخر. في المحادثة، assigned_member_id هو الموظف المُسنَد إليها، وassigned_at وقت الإسناد، وhandoff_at وقت التحويل إلى موظف. وعندما يكون الجميع مشغولين ينتظر العملاء في صف، وتعرض نافذة الويب عدد المنتظرين قبلهم.

ساعات العمل والرسائل: بعد تفعيل ساعات العمل في «إعدادات الروبوت»، لا ينتظر العملاء في صف عند التحويل إلى موظف خارج ساعات العمل، بل تظهر في نافذة الويب استمارة رسالة (الاسم، البريد الإلكتروني أو الهاتف، المشكلة)، وفي محادثات وي تشات وواجهة API المفتوحة يطلب AI من العميل ترك رسالة؛ والأمر نفسه داخل ساعات العمل عندما لا يكون أي موظف متصلًا. تُنشئ الرسالة تذكرة دعم، وعند ردّ الموظف تُرسل الإجابة داخل المحادثة الأصلية إن لم تكن قد انتهت، وإذا ترك العميل بريده الإلكتروني يُرسل الرد أيضًا بالبريد باسم المتجر. أما إذا كان التحويل يقتصر على推送 إلى نظامك (باختيار «推送到我的系统» كطريقة التحويل) فلا تُراعى ساعات العمل.