تعديل خصائص محادثة

محتويات الصفحة

    سنشرح لك في هذا المقال تعديل خصائص محادثة معينة في مركز المحادثة كتحديث حالة المحادثة، أو عنوانها أو تخصيصها لفريق معين.

    طلب تعديل خصائص محادثة

    يمكن إرسال طلب PUT لنقطة الاتصال {conversations/{id‎‏‏/ من أجل تعديل صندوق البريد الذي تنتمي إلي المحادثة أو حالة المحادثة أو عنوانها أو المستخدم المُسندة إليه، كما يمكن تعطيل ميزة طلب تقييم المحادثة من العميل بعد إغلاقها وفق التالي:

    عنوان URL

    https://{your_subdomain}/api/agent/v1/conversations

    معاملات المسار

    معامل واحد فقط هو الرقم التعريفي id للمحادثة التي نرغب بتعديلها، نوع المعامل عدد صحيح integer، وهو معامل إجباري.

    جسم الطلب Body

    يُكتب بصيغة JSON ويتضمن المعاملات التالية:

    conversation_status_id

    نوعه عدد صحيح integer، يحدد حالة المحادثة

    inbox_id

    نوعه عدد صحيح integer، يُحَدِّد صندوق البريد.

    title

    نوعه سلسلة نصية string، يمثل عنوان المحادثة.

    assign_to

    نوعه عدد صحيح integer، يُشير إلى الرقم التعريفي للمستخدم الذي ستُسنِد له المحادثة.

    disable_rating

    نوعه منطقي boolean، بإعطائه القيمة true لن تظهر رسالة طلب التقييم للعميل بعد إغلاق المحادثة

    ملاحظة: ينبغي أن يتضمن أي طلب تعديل تود تنفيذه بنقطة الاتصال هذه واحد على الأقل من المعاملات التالية:

    • inbox_id.
    • conversation_status_id.
    • title.

    مثال

    لتعديل خصائص المحادثة رقم 509339 في مركز مساعدة له النطاق support.example.com بحيث نغير الرقم التعريفي لحالة المحادثة conversation_status_id إلى 6523، ورقم صندوق الوارد inbox_id إلى 2139، ونسندها للمستخدم رقم 1434، ونعطل ميزة تقييمها سنكتب الطلب على النحو التالي:

    curl -X PUT --header 'Content-Type: application/json' --header 'Authorization: Bearer your_token' --data '{
    "conversation_status_id": 6523,
    "inbox_id": 2139,
    "assign_to": 1434,
    "disable_rating": true
    }' 'https://support.example.com/api/agent/v1/conversations/509339'
    محتويات الصفحة