إضافة وإزالة وسوم من المحادثات

سنشرح في هذا المقال إضافة وسم لمحادثة واحدة أو عدة محادثات، وإزالة الوسوم من هذه المحادثات.

يمكنك إضافة الوسوم إلى محادثات مركزك على مستوى المحادثة الواحدة أو على مستوى مجموعة محادثات معًا وإليك توضيح لكل منهما:

طلب إضافة وسم واحد

أرسل طلب POST لنقطة الاتصال conversations/{conversation_id}/tags/
مع تمرير الرقم التعريفي للمحادثة conversation_id كمتغير مسار في عنوان URL للطلب، وتمرير اسم الوسم بصيغة سلسلة نصية string ضمن المعامل name في جسم الطلب.

مثال

يبين المثال التالي طريقة إضافة الوسم استفسار إلى المحادثة رقم 509643 في مركز مساعدة يملك النطاق support.example.com.

curl -X POST --header 'Content-Type: application/json' --header 'Authorization: Bearer your_token' --data '{"name": "استفسار"}' 'https://support.example.com/api/agent/v1/conversations/509643/tags' 

طلب إضافة عدة وسوم

إذا احتجت لإضافة أكثر من وسم إلى محادثة واحدة أو عدة محادثات دفعة واحد فاستخدم نقطة الاتصال conversations/tags/ إذ يتضمن جسم الطلب POST المرسل إلى نقطة الاتصال المعاملات التالية:

مثال

يضيف الطلب التالي الوسمين شكوى و vip للمحادثات رقم 509643 و 509399 و 508298 في مركز المساعدة الذي يملك النطاق support.example.com:

 curl -X DELETE --header 'Content-Type: application/json' --header 'Authorization: Bearer your_token'  --data '{
"conversation_ids": [509643, 509399, 508298],
"tags": ["شكوى", "vip"]
}' 'https://support.example.com/api/agent/v1/conversations/tags'

طلب حذف وسم

لحدف وسوم من محادثة أو مجموعة محادثات أرسل طلب DELETE لنقطة الاتصال conversations/tags/ مع تمرير المعاملات التالية في جسم الطلب:

مثال

يحذف المثال التالي الوسمين شكوى و vip من المحادثات رقم 509643 و 509399 و 508298 من مركز المساعدة:

curl -X DELETE --header 'Content-Type: application/json' --header 'Authorization: Bearer your_token'  --data '{
"conversation_ids": [509643, 509399, 508298],
"tags": ["شكوى", "vip"]
}' 'https://support.example.com/api/agent/v1/conversations/tags'