تعديل استلام نموذج

محتويات الصفحة

    نشرح في هذا المقال كيفية تعديل استلام معين في مركز المساعدة. حيث يمكن للوكلاء تحديث بيانات استلامات النماذج submissions المسجلة مسبقًا.

    طلب تعديل الاستلام

    أرسل طلب PUT لنقطة الوصول {form-submissions/{id/ من أجل إسناد الاستلام لوكيل معين في مركز المساعدة، أو تغيير حالة الاستلام من مفتوحة إلى مؤرشفة مثلًا حسب الحالات المُعَرَّفة في مركزك وفق التالي:

    عنوان URL

    https://{your_subdomain}/api/agent/v1/form-submissions/{id}

    معاملات المسار

    معامل واحد هو الرقم التعريفي للاستلام id، نوعه عدد صحيح integer، وهو معامل إجباري.

    جسم الطلب Body

    يكتب بصيغة JSON ويتضمن المعاملات التالية:

    assign_to

    نوعه عدد صحيح integer، يُمثّل الرقم التعريفي للوكيل الذي ترغب بإسناد الاستلام إليه.ويمكنك معرفة الأرقام التعريفية للوكلاء بإرسال طلب GET إلى نقطة الوصول agents/.

    form_submission_status_id

    نوعه عدد صحيح integer، يُمثّل الرقم التعريفي للحالة التي ترغب بتحويل الاستلام إليها. علمًا أنك تستطيع الاستعلام عن الأرقام التعريفية لحالات النماذج بإرسال طلب GET لنقطة الوصول form-submission-statuses/، إذ توفر زيتون حالتين افتراضيتين لكل نموذج: مفتوحة ومؤرشفة وتستطيع إضافة أي حالات أخرى تحتاجها.

    أمثلة

    سنطبق أمثلة عملية على مركز مساعدة تجريبي مركز مساعدة له النطاق الفرعي support.example.com.

    تعديل وكيل الاستلام

    لإسناد الاستلام رقم 291 إلى الوكيل رقم 1434 في مركز المساعدة نكتب الطلب التالي:

    curl -X PUT --header 'Authorization: Bearer your_token' --header 'Content-Type: application/json' --data '{
    "assign_to": "1434"
    }' 'https://support.example.com/api/agent/v1/form-submissions/291'

    تعديل حالة الاستلام

    تعديل حالة الاستلام رقم 291 من مفتوحة إلى مؤرشفة في مركز المساعدة علمًا أن الرقم التعريفي للحالة مؤرشفة"في هذا المركز هو 2103 نكتب الطلب التالي:

    curl -X PUT --header 'Authorization: Bearer your_token' --header 'Content-Type: application/json' --data '{
    "form_submission_status_id": "2103"
    }' 'https://support.example.com/api/agent/v1/form-submissions/291'
    محتويات الصفحة