إضافة فريق العمل

توضح هذه المقالة كيفية إدارة فرق العمل عبر API زيتون، بما في ذلك عرض بيانات الفرق إنشاء فرق جديدة وتعديل إعداداتها وصلاحياتها أو حذفها واستعادتها، وذلك باستخدام أمثلة عملية مبسطة.

عرض فريق عمل

لعرض بيانات الفريق رقم 1009 نكتب الطلب على النحو التالي:

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

إضافة فريق عمل

لإنشاء فريق جديد في مركز المساعدة باسم "الفريق التقني" نرسل الطلب على النحو التالي:

curl "https://example.com/api/agent/v1/teams" \
     -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
          "name": "الفريق التقني",
          "description": "فريق الدعم الفني المسؤول عن حل المشكلات التقنية",
          "status": "active",
          "permissions": ["contact", "knowledgebase"],
          "inbox_ids": [1010, 110],
          "form_ids": [1012, 112],
          "segment_ids": [700, 800],
          "agent_ids": [1000, 1001],
          "field_group_ids": [100, 101]
     }'

تعديل فريق عمل

لتعديل توصيف بيانات الفريق الذي يملك الرقم التعريفي 1009 بحيث نعدل اسمه ووصفه ونمنحه صلاحية الوصول للإعدادات، سنكتب الطلب على النحو التالي:

curl "https://example.com/api/agent/v1/teams/1009" \
     -X POST \
     -H "Authorization: Bearer 19369b4681d1fe2" \
     -H "Content-Type: application/json" \
     -d '{
          "name": "الفريق الهندسي",
          "description": "فريق متخصص في الرد على الاستفسارات الهندسية",
          "status": "active",
          "permissions": ["contact","setting","knowledgebase"],
          "inbox_ids": [1010, 110],
          "form_ids": [1012, 112],
          "segment_ids": [700, 800],
          "agent_ids": [1000, 1001],
          "field_group_ids": [100, 101]
     }'

يجب الانتباه إلى أن أي صناديق بريد لا نمرر أرقامها ضمن المصفوفة inbox_ids في الطلب أعلاه، لن يعود للفريق صلاحية عليها، وينطبق الأمر نفسه على مصفوفة النماذج، والحقول المخصصة، وأي مصفوفات أخرى تخص الفريق.

حذف فريق عمل

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

curl "https://example.com/api/agent/v1/teams/1009" \
     -X DELETE \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $TOKEN"

ويُمكن استعادته بسهولة بإرسال الطلب التالي:

curl "https://example.com/api/agent/v1/teams/1009/restore" \
     -X POST \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $TOKEN"

إقرأ أيضاً

• إضافة الوكيل
• الإتصال بالواجهة البرمجية