استلامات النماذج

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

عرض استلام

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

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

تصفية الاستلامات

لعرض الاستلامات التي حالتها مفتوحة، وبافتراض أن الرقم التعريفي لهذه الحالة 400 نكتب الطلب التالي:

curl "https://example.com/api/agent/v1/form-submissions?form_submission_status_ids[]=400" \
  -H "Authorization: Bearer $TOKEN" \
  --globoff

لعرض كافة الاستلامات المسندة للوكيل رقم 1008، نكتب الطلب التالي:

curl "https://example.com/api/agent/v1/form-submissions?assign_to[]=1008" \
  -H "Authorization: Bearer $TOKEN" \
  --globoff

لعرض الاستلامات ذات الوسم "عاجل" نُرسل الطلب التالي:

curl "https://example.com/api/agent/v1/form-submissions?tags[]=عاجل" \
   -H "Authorization: Bearer $TOKEN" \
   --globoff

لعرض الاستلامات من نموذج محدد ولنفترض أن رقمه التعريفي 1200 نُرسل الطلب التالي:

curl "https://example.com/api/agent/v1/form-submissions?form_ids[]=1200" \
   -H "Authorization: Bearer $TOKEN" \
  --globoff

إضافة استلام

لإضافة استلام نموذج تواصل معنا جديد ونُسنده للوكيل رقم 800، نُرسل الطلب التالي:

curl "https://example.com/api/agent/v1/form-submissions" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "form_id": 1200,
    "contact_id": 800,
    "01gzrdsyryw1w3h1jb282822w0": "Mohammed",
    "01gzrdsyryw1w3h1jb2832hjk4": "Ali",
    "01gzrdsyryw1w3h1ju7u9sadd8": "ali@example.com",
    "01gzrdsyryw1w3h1ju1a14hyk9": : "لدي استفسار عاجل بخصوص الخدمة"
  }'

تعديل استلام

على سبيل المثال لتعديل حالة استلام إلى الحالة ذات الرقم 10 للاستلام ذا الرقم التعريفي 5000 نُرسل الطلب التالي:

curl "https://example.com/api/agent/v1/form-submissions/5000" \
  -X PATCH \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "form_submission_status_id": 10
  }'

حذف استلام

على سبيل المثال لحذف الاستلام ذا الرقم التعريفي 500 نُرسل الطلب التالي:

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

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

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

إقرأ أيضاً

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