الحقول المخصصة للعملاء

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

عرض مجموعة حقول

يُمكن عرض أي مجموعة حقول باستخدام رقمه التعريفي، على سبيل المثال لعرض مجموعة الحقول ذات الرقم 34424 في مركز المساعدة نرسل الطلب التالي:

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

إضافة مجموعة حقول للأشخاص

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

curl "https://example.com/api/agent/v1/custom-fields" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \ 
  -d '{ 
     "name": "وسائل التواصل الاجتماعي",
     "sort": 0,
     "resource": "contact", 
     "fields": [
 {
     "label": "حساب لينكدإن",
     "placeholder": "https://www.linkedin.com/in/username", 
     "hint": "أدخل رابط حساب لينكدإن الخاص بالعميل",
     "type": "url",
     "sort": 0,
     "grid": "100",
     "required": false,
 },
{
     "label": "حساب فيسبوك",
     "placeholder": "https://www.facebook.com/username"
     "hint": "أدخل رابط حساب فيسبوك الخاص بالعميل",
     "type": "url",
     "sort": 1,
     "grid": "100",
     "required": false,
},
{
     "label": "حساب X",
     "placeholder": "https://x.com/username",
     "hint": "أدخل رابط حساب X (تويتر سابقًا) للعميل",
     "type": "url",
     "sort": 2,
     "grid": "100",
     "required": false,
}
],
     "display": "tab",
     "team_ids": [1009],
     "agent_ids": [1008, 108]
}'

إضافة مجموعة حقول للشركات

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

curl "https://example.com/api/agent/v1/custom-fields" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
     "name": "البيانات القانونية",
     "sort": 0,
     "resource": "company",
     "fields": [
{
     "label": "النوع القانوني للشركة",
     "placeholder": "مثل: شركة ذات مسؤولية محدودة",
     "hint": "أدخل النوع القانوني للشركة",
     "type": "text",
     "sort": 0,
     "grid": "100",
     "required": true,
},
{
     "label": "رقم التسجيل",
     "placeholder": "123456789",
     "hint": "رقم تسجيل الشركة لدى الجهات الرسمية",
     "type": "text",
     "sort": 1,
     "grid": "50",
     "required": true,
},
{
     "label": "رقم ضريبة القيمة المضافة",
     "placeholder": "VAT123456",
     "hint": "أدخل رقم ضريبة القيمة المضافة للشركة إن وجد",
     "type": "text",
     "sort": 2,
     "grid": "50",
     "required": false,
}
],
     "display": "tab",
     "team_ids": [1010],
     "agent_ids": [1008, 1012]
}'

تعديل مجموعة حقول

على سبيل المثال لتغيير اسم مجموعة حقول لتصبح شبكات إجتماعية وإضافة صلاحيات لوكيل 1010 بجانب الوكلاء السابقين نرسل الطلب التالي:

curl "https://example.com/api/agent/v1/custom-fields/1022" \
  -X PATCH \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "شبكات اجتماعية",
    "agent_ids": [1008, 108, 1010]
  }'

حذف مجموعة حقول

على سبيل المثال لحذف مجموعة الحقل ذات الرقم التعريفي 1022 نرسل الطلب التالي:

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

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

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

إقرأ أيضاً

• الإتصال بالواجهة البرمجية
• فئات العملاء