إدارة وسوم الأشخاص

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

    تساعدك الوسوم على تميز الأشخاص في مركز المساعدة تبعًا لمعايير محددة وتُسَهِّل عليك فرزهم والتعامل معهم، وفي مقال اليوم نشرح طريقة إدارة الوسوم من خلال الواجهة البرمجية لزيتون ونعرض أمثلة على إضافة وسوم جديدة أو حذف وسوم موجودة لتمييز العملاء أو تصنيفهم ضمن مركز مساعدة تجريبي يدعى "المناسب" له النطاق الفرعي al-munasib.zaetoon.com.

    إضافة وسم إلى أحد الأشخاص

    أرسل طلب من نوع POST إلى نقطة الاتصال contacts/{contact_id}/tags/ لإضافة وسم ما إلى أحد الأشخاص في مركز المساعدة، عبر تمرير رقم الشخص التعريفي contact_id كمتغير مسار ضمن عنوان URL للطلب، وتمرير اسم الوسم name في جسم الطلب.

    مثال

    لاحظ المثال التالي لإضافة الوسم "test" إلى الشخص رقم "438092" في مركز مساعدة "المناسب":

    curl -X POST --header 'Authorization: Bearer your_token' --header 'Content-Type: application/json' --data '{
       "name": "test"
    }' 'https://al-munasib.zaetoon.com/api/agent/v1/contacts/438092/tags'

    إزالة وسم من أحد الأشخاص

    إذا رغبت بإزالة أي وسم من إعدادات أي شخص في مركز المساعدة يمكنك إرسال طلب من نوع DELETE إلى نقطة الاتصال {contacts/{contact_id}/tags/{tag_id/ مع تمرير المعاملات التالية ضمن عنوان URL للطلب:

    • contact_id الرقم التعريفي للشخص.
    • tag_id الرقم التعريفي للوسم المُراد حذفه.

    مثال

    يحذف المثال التالي الوسم "918" من إعدادات الشخص "438092" في مركز مساعدة "المناسب":

    curl -X DELETE --header 'Authorization: Bearer your_token' 'https://al-munasib.zaetoon.com/api/agent/v1/contacts/438092/tags/918'

    إضافة عدة وسوم إلى عدة أشخاص بطلب واحد

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

    • contact_ids معامل إجباري، نوعه مصفوفة من الأعداد الصحيحة، تكتب ضمنه الأرقام التعريفية للأشخاص المطلوب إضافة الوسوم إليهم.
    • tags معامل إجباري، نوعه مصفوفة من السلاسل النصية، يُحَدِّد الوسوم المطلوب إضافتها.

    مثال

    ألقِ نظرة على المثال التالي لإضافة الوسوم "مميز" و "محلي" إلى ثلاثة أشخاص في مركز مساعدة "المناسب":


    curl -X POST --header 'Authorization: Bearer your_token' --header 'Content-Type: application/json' --data '{
        "contact_ids": [438092, 438085, 435272],
        "tags": ["مميز", "محلي"]
    }' 'https://al-munasib.zaetoon.com/api/agent/v1/contacts/tags'

    إزالة عدة وسوم من عدة أشخاص بطلب واحد

    تساعدك نقطة الاتصال contacts/tags/ على إزالة مجموعة وسوم من مجموعة أشخاص بطلب DELETE واحد مع تمرير المعاملات التالية في جسم الطلب:

    contact_ids مصفوفة الأرقام التعريفية للأشخاص المطلوب حذف الوسوم منهم.

    tags مصفوفة أسماء الوسوم المطلوب حذفها.

    مثال

    يحذف المثال التالي الوسوم "test" و "new" من الأشخاص ذوي الأرقام "438092" و "435272" في مركز مساعدة "المناسب":

    curl -X DELETE --header 'Authorization: Bearer your_token' --header 'Content-Type: application/json' --data '{
        "contact_ids": [438092, 435272],
        "tags": ["new", "test"]
    }' 'https://al-munasib.zaetoon.com/api/agent/v1/contacts/tags'
    محتويات الصفحة