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

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

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

يمكنك استخدام نقطة الاتصال form-submission-statuses/ لإنشاء حالة جديدة لاستلام النموذج وذلك كما يلي:

• عنوان URL لنقطة الاتصال:
  https://{your_subdomain}/api/agent/v1/form-submission-statuses.
• نوع الطلب: POST.
• جسم الطلب Body: يكتب بصيغة JSON ويتضمن المعاملات التالية:
• • name: معامل إجباري، نوعه سلسلة نصية string، يُحَدَّد اسم الحالة الجديدة.
  • color: معامل إجباري، نوعه سلسلة نصية string، يُكتب ضمنه الترميز السداسي عشر HEX للون المميز للحالة الجديدة.
  • sort:معامل إجباري، نوعه عدد صحيح integer، يُحَدَّد ترتيب الحالة الجديدة ضمن حالات النموذج.
  • form_id:معامل إجباري، نوعه عدد صحيح integer، يُكتب ضمنه الرقم التعريفي id للنموذج الذي ترغب بإضافة الحالة الجديدة إليه.

مثال

يضيف المثال التالي حالة جديدة اسم الحالة مثلًا "قيد المعالجة"إلى حالات نموذج "تواصل معنا" ذو الرقم التعريفي "1048" في مركز المساعدة التجريبي باسم "المناسب" ذي النطاق الفرعي al-munasib.zaetoon.com:

curl -X POST --header 'Authorization: Bearer your_token' --header 'Content-Type: application/json' --data '{
"name": "قيد المعالجة",
"color": "#f44336",
"sort": 3,
"form_id": "1048"
}' 'https://al-munasib.zaetoon.com/api/agent/v1/form-submission-statuses'