فئات العملاء

سنشرح في هذا المقال طريقة التعامل مع فئات العملاء كعرضها وإضافتها وتعديلها وحذفها.

عرض فئة

يُمكن عرض أي فئة باستخدام رقمها التعريفي، على سبيل المثال لعرض بيانات فئة التي لها الرقم 1019 في مركز المساعدة نكتب الطلب التالي:

curl "https://example.com/api/agent/v1/segments/1019" \
  -H "Authorization: Bearer $TOKEN"

إضافة فئة للأشخاص

يوفر مركز مساعدة زيتون فئتين للأشخاص معرفتين افتراضياً هما فئة العملاء وفئة العملاء المحتملين. ويمكن إنشاء فئات جديدة، على سبيل المثال لإضافة فئة باسم "عملاء جدد" نرسل الطلب التالي:

curl "https://example.com/api/agent/v1/segments" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "العملاء الجدد",
    "description": "تضم هذه الفئة الأشخاص المتواصلين حديثًا مع مركز المساعدة",
    "status": "active",
    "sort": 2,
    "type": "contact",
    "agent_ids": [1008],
    "team_ids": [109, 1009]
  }'

ولإضافة الشخص رقم 1001 إلى الفئة رقم 800 نكتب الطلب التالي:

curl "https://example.com/api/agent/v1/contacts/1001/segments" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "segment_id": 800
  }'

إضافة فئة للشركات

على سبيل المثال لإضافة فئة "برمجة وتطوير" ونسندها للوكيل رقم 1008 نرسل الطلب التالي:

curl "https://example.com/api/agent/v1/segments" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "برمجة وتطوير",
    "description": "تضم هذه الفئة عملاء الشركة العاملين في مجال البرمجة وتطوير البرمجيات",
    "status": "active",
    "sort": 3,
    "type": "company",
    "agent_ids": [1008],
    "team_ids": [109, 1009]
  }'

ولإضافة الشركة رقم 1002 إلى الفئة رقم 700 نكتب الطلب التالي:

curl "https://example.com/api/agent/v1/companies/1002/segments" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "segment_id": 700
  }'

تعديل فئة

لتعديل ترتيب الفئة رقم 1019 في  مركز المساعدة ومنح الوكيل رقم 1008 صلاحية الوصول إليها يجانب الوكيل 1400 الذي يملك هذه الصلاحية سابقاً نرسل الطلب التالي:

curl "https://example.com/api/agent/v1/segments/1019" \
  -X PUT \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "العملاء الجدد",
    "status": "active",
    "sort": 0,
    "agent_ids": [1008, 1400]
  }'

حذف فئة

على سبيل المثال لحذف الفئة رقم 1019 من مركز المساعدة نرسل الطلب التالي:

curl "https://example.com/api/agent/v1/segments/1019" \
  -X DELETE \
  -H "Authorization: Bearer $TOKEN"

ولاستعادة نفس الفئة المحذوفة سابقاً، نُرسل الطلب التالي:

curl "https://example.com/api/agent/v1/segments/1019/restore" \
  -X POST \
  -H "Authorization: Bearer $TOKEN"

إقرأ أيضاً

• الإتصال بالواجهة البرمجية
• حقول مخصصة للعملاء