النماذج | زيتون للمطورين

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

تسمى البيانات الواردة عبر نماذج مركز مساعدة زيتون بالاستلامات submissions وسنشرح في هذا المقال كيفية عرض بيانات الاستلامات الواردة إلى مركز مساعدة. عرض الاستلامات الواردة إلى مركز المساعدة عبر النماذج يمكنك عرض جميع الاستلامات أو البيانات الواردة إلى مركز المساعدة والتي نسميها submissions عبر النماذج بإرسال طلب من نوع GET إلى نقطة الاتصال form-submissions/ مع العديد من خيارات الفرز والتصفية التي...

إضافة استلامات النماذج يدويًّا

نشرح في هذا المقال كيفية إضافة استلامات النماذج يدويًا في مركز المساعدة من خلال الواجهة البرمجية لزيتون ، حيث يمكن للمستخدمين أو موظفي الدعم تسجيل ردود النماذج الخاصة بجهات الاتصال يدويًا. إضافة استلامات النماذج يدويًّا يمكن لمستخدمي مركز المساعدة إضافة استلام form submission عن جهة اتصال معينة بإرسال طلب من نوع POST إلى نقطة الاتصال form-submissions/ وفق التالي: عنوان URL لنقطة الاتصال : https:/...

الحصول على استلام معين من نموذج

سنوضح في هذا المقال كيف يمكنك استرجاع استلام معين في مركز المساعدة من خلال الواجهة البرمجية لزيتون . الحصول على استلام معين من نموذج يمكنك الحصول على استلام معين في مركز المساعدة من خلال إرسال طلب من نوع GET إلى نقطة الاتصال {form-submissions/{id/ مع تمرير الرقم التعريفي للاستلام id كمتغير مسار ضمن عنوان URL للطلب، كما يلي: عنوان URL لنقطة الاتصال : https://{your_subdomain}/api/agent/v1/form-subm...

تعديل استلام

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

إضافة وحذف وسم من استلام

سنتعرف في هذا المقال على كيفية إضافة وسم tag إلى استلام معين في مركز المساعدة باستخدام الواجهة البرمجية لزيتون. تتيح هذه العملية لمستخدمي مركز المساعدة تصنيف استجابات النماذج بطريقة منظمة، مما يسهل فرزها والبحث عنها لاحقًا. إضافة وسم إلى استلام يمكنك إضافة وسم إلى استلام معين في مركز المساعدة بإرسال طلب من نوع POST إلى نقطة الاتصال form-submissions/{form_submission_id}/tags/ مع تمرير الرقم التعري...

الحصول على حالات تسليم بيانات النماذج

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

إنشاء حالة جديدة لاستلامات نموذج

تيح مركز مساعدة زيتون حالتين افتراضيتين لكل نموذج هما الحالة المفتوحة والحالة المؤرشفة ، ويمكنك إنشاء حالات أخرى من خلال الواجهة البرمجية لزيتون كما سنشرح في الفقرات التالية. إنشاء حالة جديدة لاستلامات نموذج يمكنك استخدام نقطة الاتصال form-submission-statuses/ لإنشاء حالة جديدة لاستلام النموذج وذلك كما يلي: عنوان URL لنقطة الاتصال : https://{your_subdomain}/api/agent/v1/form-submission-statuses ....

الحصول على حالات النماذج وحذفها

سنستعرض في هذا المقال كيفية الحصول على حالات النماذج في مركز المساعدة وكيفية حذفها عند الحاجة باستخدام واجهة زيتون البرمجية. مع تقديم أمثلة عملية عليها من خلال مركز مساعدة تجريبي يدعى "المناسب al-munasib" له النطاق الفرعي al-munasib.zaetoon.com . الحصول على إعدادات حالة معينة من حالات النماذج يمكنك عرض إعدادات حالة معينة من حالات أحد نماذج مركز المساعدة بإرسال طلب من نوع GET إلى نقطة الاتصال {for...

تعديل إعدادات حالة من حالات النماذج

نشرح في هذا المقال كيفية تعديل حالة معينة من حالات النماذج Submission Statuses في مركز المساعدة باستخدام واجهة زيتون البرمجية مع أمثلة توضيحية. تعديل إعدادات حالة من حالات نموذج يمكن تعديل اسم حالة معينة من حالات النماذج، أو تعديل لونها المميز، أو ترتيبها sort عبر إرسال طلب من نوع PUT لنقطة الاتصال {form-submission-statuses/{id/ وفق التالي: عنوان URL لنقطة الاتصال : https://{your_subdomain}/api/a...

التعديل المتعدد لحالات النماذج

نوضح في هذا المقال كيفية إجراء التعديل المتعدد على مجموعة من حالات النماذج في مركز المساعدة دفعةً واحدة من خلال الواجهة البرمجية لزيتون . التعديل المتعدد لحالات النماذج في مركز المساعدة تساعدك نقطة الاتصال forms/{form_id}/statuses/bulk-save/ على تعديل مجموعة من حالات النماذج دفعةً واحدة (أي بطلب POST واحد)، وقد يشمل هذا الطلب إنشاء حالات جديدة، وتعديل أو حذف حالات موجودة مسبقًا، وذلك وفق التالي:...

عرض الملاحظات الخاصة باستلام نموذج

سنشرح في هذا المقال كيفية عرض الملاحظات الخاصة باستلام نموذج معين في مركز المساعدة، فقد تحتوي الملاحظات المسجلة عن كل استلام على تفاصيل توضيحية تفيد في مراجعة حالات الاستلام وتحليلها عرض ملاحظات استلامات نموذج تساعدك نقطة الاتصال form-submissions/{form_submission_id}/notes/ على عرض كافة الملاحظات المسجلة عن استلام معين، وفق التالي: عنوان URL لنقطة الاتصال : https://{your_subdomain}/api/agent/v1/f...

إنشاء ملاحظة حول استلام

يمكن لمستخدمي مركز مساعدة زيتون إنشاء ملاحظات توضيحية عن طلبات العملاء المستلمة عبر النماذج لتتبع سير العمل على هذه الطلبات بسهولة، ومعرفة تفاصيل مهمة عنها وهو ما سنعرضه في هذا المقال من خلال الواجهة البرمجية لزيتون . إنشاء ملاحظة حول استلام يمكنك إنشاء ملاحظة عن استلام معين بإرسال طلب من نوع POST إلى نقطة الاتصال form-submissions/{form_submission_id}/notes/ وفق التالي: عنوان URL لنقطة الاتصال :...

تعديل ملاحظة خاصة باستلام

سنشرح في هذا المقال طريقة تعديل المحتوى النصي أو المرفقات الخاصة بأي ملاحظة في استلامات نموذج ما في مركز المساعدة. تعديل ملاحظة خاصة باستلام لتعديل الملاحظة يمكنك استخدام نقطة الاتصال التالية {form-submissions/{form_submission_id}/notes/{note_id/ حيث: عنوان URL لنقطة الاتصال : https://{your_subdomain}/api/agent/v1/form-submissions/{form_submission_id}/notes/{note_id} . نوع الطلب : PUT. معاملات ال...

حذف ملاحظة خاصة باستلام

نشرح في هذا المقال كيفية حذف ملاحظة خاصة باستلام معين باستخدام واجهة برمجة تطبيقات زيتون من خلال مثال عملي لطلب الحذف. حذف ملاحظة خاصة باستلام إذا رغبت بحذف ملاحظة معينة من أحد استلامات النماذج في مركز المساعدة، أرسل طلب DELETE إلى نقطة الاتصال التالية: {form-submissions/{form_submission_id}/notes/{note_id/ يتضمن هذا الطلب كل من الرقم التعريفي للاستلام form_submission_id، والرقم التعريفي للملاحظة...