إدارة فئات جهات الاتصال

يوفر مركز المساعدة فئتين افتراضيتين لجهات الاتصال هما فئة العملاء وفئة العملاء المحتملين بهدف تنظيمهم وتخصيص الدعم لكل فئة، وسنشرح في هذا المقال طريقة التعامل مع فئات جهات الاتصال كعرض وإضافة وحذف وتعديل فئة. لتطبيق الأمثلة، سنفترض وجود مركز مساعدة على النطاق example.com، ومفتاح الواجهة البرمجية لزيتون مخزن ضمن متغير TOKEN$ لاستخدامه في الطلبات المختلفة.

export TOKEN="YOUR_API_KEY"

عرض الفئات

لعرض فئات جهات الاتصال في مركز المساعدة، نرسل طلب GET لنقطة الوصول List all segments مع إمكانية تصفية الفئات التي نريد عرضها بناءً على أسمائها أو تواريخ إنشائها أو أنواعها أو غيرها من الخيارات.

ولعرض بيانات فئة جهة اتصال محددة في مركز المساعدة نرسل طلب GET إلى نقطة الوصول Show a segment مع تمرير الرقم التعريفي للفئة كمتغير مسار في عنوان الطلب.

كافة الفئات

لعرض كافة فئات جهات الاتصال في مركز المساعدة نكتب الطلب التالي:

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

فئات الأشخاص

لعرض كافة فئات الأشخاص في مركز المساعدة نكتب الطلب التالي:

curl "https://example.com/api/agent/v1/segments?types[]=contact" \
  -H "Authorization: Bearer @TOKEN" \
  --globoff

فئات الشركات

لعرض كافة فئات الشركات في مركز المساعدة نكتب الطلب التالي:

curl "https://example.com/api/agent/v1/segments?types[]=company" \
  -H "Authorization: Bearer @TOKEN" \
  --globoff

فئة واحدة

لعرض بيانات فئة جهة الاتصال التي لها الرقم 1019 في  مركز المساعدة نكتب الطلب التالي:

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

فئة باسم محدد

لعرض بيانات فئة جهة الاتصال المسماة "vip" نكتب:

curl "https://example.com/api/agent/v1/segments?query=vip" \
  -H "Authorization: Bearer @TOKEN"

إضافة فئة

لإنشاء فئة جهة اتصال جديدة بإرسال طلب POST إلى نقطة الوصول Create Segment مع تمرير بيانات الفئة المطلوبة ضمن جسم الطلب.

فئة واحدة

لإضافة فئة تصنيف لجهات الاتصال باسم "عملاء جدد" نكتب الطلب على النحو التالي:

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]
  }'

تعديل فئة

يمكنك إرسال طلب من النوع PUT إلى نقطة الوصول Update a segment من أجل تعديل إعدادات الفئة مثل اسمها او وصفها أو صلاحيات الوصول إليها، مع تمرير الرقم التعريفي للفئة المراد تعديلها في عنوان الطلب وبيانات الفئة الجديدة مع البيانات الإجبارية في جسم الطلب.

فئة واحدة

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

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]
  }'

نلاحظ أننا مررنا هنا الأرقام التعريفية لجميع الوكلاء الذين نرغب بمنحهم صلاحية الوصول للفئة أي الوكلاء الذين يملكون هذه الصلاحية سابقًا والوكلاء الجدد الذين سنمنحهم الصلاحية الآن، وينبطق الأمر نفسه على فرق العمل.

تعديل ترتيب الفئات

يمكن إعادة ترتيب الفئات اعتمادًا على قيمة المعامل sort لكل فئة، بإرسال طلب من النوع POST إلى نقطة الوصول Sort segments.

عدة فئات

لاحظ الطلب التالي لإعادة ترتيب عددة فئات في مركز المساعدة:

curl "https://example.com/api/agent/v1/segments/bulk-sort" \
  -X POST \
  -H "Authorization: Bearer @TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "segments": [
      {
        "id": 2098,
        "sort": 0
      },
      {
        "id": 2464,
        "sort": 1
      },
      {
        "id": 2097,
        "sort": 2
      },
      {
        "id": 2466,
        "sort": 3
      }
    ]
  }'

حذف فئة

من أجل حذف فئة معينة من مركز المساعدة، نرسل طلب من نوع DELETE إلى نقطة الوصول Delete a segment مع تمرير رقم الفئة ضمن عنوان الطلب.

فئة واحدة

لاحظ المثال التالي المتضمن حذف الفئة رقم 1019 من  مركز المساعدة

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