يحمل ملف الإعداد الإعداد الكامل لتكامل ما في ملف نصي واحد. نزّله نسخةً احتياطية، أو غيّر أشياء كثيرة دفعة واحدة، أو انسخ إعدادًا إلى رقم آخر، أو دع وكيل ذكاء اصطناعي يعدّ كل شيء عبر API أو MCP. يُفحص كل رفع أولًا ويمكن التراجع عنه.
يحمل ملف الإعداد كل ما أعددته في تكامل ما: الإعدادات، وخدمات Book-and-Pay وموظفيه، وفئات Order-and-Pay وخياراته ومنتجاته، وفعاليات Tickets-and-Pay ومواعيدها وأنواع تذاكرها، ونماذج Submit-Info وأتمتاته. وهو ملف نصي واحد، فيمكنك الاحتفاظ به نسخةً احتياطية، وتعديله في أي محرر، ورفعه مرة أخرى، أو نسخه إلى رقم آخر من أرقامك.
يعمل الملف نفسه في ثلاثة أماكن: لوحة التحكم، وAPI، وخادم MCP لوكلاء الذكاء الاصطناعي.
لكل تكامل قسم Setup file:
| التكامل | أين |
|---|---|
| Book-and-Pay | تبويب Overview، في الأسفل |
| Order-and-Pay | تبويب Import & export، في الأسفل |
| Tickets-and-Pay | تبويب Settings، في الأسفل |
| Submit-Info | تبويب Settings، في الأسفل |
لا يراه إلا مالك الرقم ومسؤولوه.
يعطي Download الإعداد في ملف .a2e.jsonl. ويعطي Download with pictures ملف .zip فيه الملف نفسه وكل صورة بداخله: نسخة احتياطية كاملة دون اتصال يمكنك رفعها مرة أخرى كما هي.
افتح الملف في محرر نصوص وغيّر الأسطر أو أضف إليها أو احذف منها. كل سطر هو شيء واحد: خدمة، أو منتج، أو فعالية. ولا حاجة إلى جدول بيانات.
يفحص Upload a file الملف أولًا. ولا يتغير شيء بعد. ترى كل مشكلة مع رقم سطرها وكيف تصلحها، أو ما الذي سيفعله التطبيق: كم شيئًا جديدًا أو متغيرًا أو محذوفًا، وأيها.
يجري Apply بالضبط التغييرات التي أظهرها الفحص. ويبقى الفحص صالحًا ساعة واحدة.
كل تطبيق مدرج تحت Recent changes by setup file. يعيد Undo كل ما غيّره ذلك التطبيق، لمدة 30 يومًا، ما دام لم يغيّر تطبيق لاحق التكامل نفسه. تراجع عن الأحدث أولًا.
قبل الرفع، اختر ما يحدث للأشياء التي لا يسردها الملف:
إذا كنت مالك أكثر من رقم أو مسؤولًا عنه، فإن Copy to another number ينسخ إعداد تكامل من الرقم الذي أنت عليه إلى رقم آخر: فرع ثانٍ، أو رقم اختبار، أو قالب تعطيه لكل متجر جديد.
يُفحص النسخ على الرقم الآخر أولًا ويعرض ما سيغيّره هناك. ويطبّقه Copy now. وتنتقل الصور معه. وللتراجع عن نسخ، افتح التكامل نفسه على الرقم الآخر: يُدرج النسخ هناك تحت Recent changes.
عنوان الويب الخاص بـ Book-and-Pay وOrder-and-Pay وTickets-and-Pay يخص رقمًا واحدًا فقط ولا يُنسخ أبدًا. اضبط عنوان الرقم الآخر في لوحة التحكم الخاصة به.
| التكامل | الأسطر |
|---|---|
| Book-and-Pay | booking.settings (سطر لكل قسم: الساعات، والويب، والعلامة التجارية، والرسائل ...)، وbooking.service، وbooking.provider (الموظفون) |
| Order-and-Pay | shop.settings (سطر لكل قسم، بما فيه شكل صفحة الطلب)، وshop.category، وshop.option_group، وshop.item (مع الأنواع والصور) |
| Tickets-and-Pay | tickets.settings (سطر لكل قسم؛ وwa_templates هي صياغتك الخاصة لرسائل WhatsApp)، وtickets.chart (مخططات المقاعد المحفوظة)، وtickets.event (مع مواعيدها وأنواع تذاكرها والحدود المشتركة وصورها ومخطط مقاعدها)، وtickets.promo |
| Submit-Info | submit.settings وsubmit.list وsubmit.connection وsubmit.form وsubmit.automation |
| الكل | asset: صورة، تُسمّى بالأسطر التي تستخدمها |
لا يوجد أبدًا في ملف
ملف الإعداد هو JSON Lines: كائن JSON واحد في كل سطر. يقول السطر الأول ما هو الملف؛ وكل سطر آخر هو سجل واحد له type وkey. يجد المفتاح السجل نفسه مرة أخرى في المرة القادمة: معرّف خدمة، أو SKU منتج، أو عنوان فعالية.
{"type":"a2e.setup","version":1,"products":["booking"]}
{"type":"booking.service","key":"haircut","name":"Haircut","duration_min":30,"price":"$25","price_amount":25}
{"type":"booking.service","key":"beard","name":"Beard trim","duration_min":15,"price":"$12","price_amount":12}
{"type":"booking.provider","key":"sam","name":"Sam","services":["haircut","beard"]}لا يهم ترتيب الأسطر. أسعار Book-and-Pay مبالغ (25 تعني 25.00، وprice هو التسمية المعروضة بجانبه)؛ وأسعار Order-and-Pay وTickets-and-Pay بأصغر وحدة للعملة (1250 تعني 12.50). والحقول الدقيقة لكل سطر في دليل API (GET /v1/{number}/setup/guide).
يسمّي السجل صورة بمفتاح سطر asset. وتأتي الصورة من أحد هذه:
url: عنوان https://، نجلبه نحن.data: الصورة نفسها، بصيغة base64.file: مسار داخل ملف .zip المرفوع.sha256: صورة يملكها هذا الرقم أصلًا.يكتب التصدير العنوان العام لكل صورة. والصورة التي ليس لها عنوان عام، مثل صورة الأرضية خلف مخطط المقاعد، تحصل على رابط موقّع يعمل 7 أيام، فيحملها ملف نُسخ إلى رقم آخر.
{"type":"asset","key":"classic-photo","url":"https://example.com/classic.jpg"}
{"type":"shop.item","key":"BURGER-CLASSIC","name":"Classic burger","category":"burgers","price":1250,"images":["classic-photo"]}الصور بصيغة PNG أو JPEG أو WEBP، وحجم كل منها 5 MB على الأكثر. وحيث يحتاج تكامل إلى ذلك، تُصغَّر الصورة أو تُحوَّل إلى JPEG: شعار Book-and-Pay ليناسب 300 KB، وصورة Tickets-and-Pay لتناسب 1 MB.
يعدّ الوكيل تكاملًا كاملًا في خطوة واحدة مفحوصة بدل عشرات الاستدعاءات. يحتوي خادم MCP على https://api.app2email.com/mcp/setup الأدوات التالية: get_setup_guide وexport_setup وcheck_setup وapply_setup وupload_setup_asset وlist_setup_jobs وget_setup_job وundo_setup. والاستدعاءات نفسها موجودة في API:
| الاستدعاء | ما يفعله |
|---|---|
GET /v1/{number}/setup/guide | كل نوع سجل وحقوله وحدوده، مع أمثلة. يقرؤه الوكلاء أولًا |
GET /v1/{number}/setup/export | الملف الحالي: format=jsonl أو zip أو json |
POST /v1/{number}/setup/check | يفحص ملفًا ولا يغيّر شيئًا: المشكلات حسب السطر، والخطة، وcheck_id |
POST /v1/{number}/setup/apply | يطبّق فحصًا: {"check_id": 123} |
POST /v1/{number}/setup/assets | يخزّن صورة 7 أيام ويجيب بـ sha256 الخاص بها |
GET /v1/{number}/setup/jobs | أحدث عمليات الفحص والتطبيق والتراجع |
POST /v1/{number}/setup/jobs/{id}/undo | يعيد ما غيّره تطبيق |
يحتاج المفتاح إلى صلاحية التكامل نفسه: bookings:manage أو orders:manage أو tickets:manage أو submissions:manage. ويمكن لمفتاح sandbox أن يصدّر ويفحص، لكن لا يطبّق.
الحلقة المعتادة للوكيل: يقرأ الدليل، ويصدّر الملف الحالي، ويغيّر بضعة أسطر، ويفحص، ويصلح ما أبلغ عنه الفحص، ثم يسأل المستخدم قبل أن يطبّق check_id.
| ماذا | الحد |
|---|---|
| ملف | 20 MB من النص، و50,000 سطر (في لوحة التحكم، رفع بحد أقصى 19 MB) |
| طلب مع صور بداخله | 60 MB عبر API |
| صورة | 5 MB |
| الصور المجلوبة بالعنوان | 100 في الرفع الواحد؛ ويجلب Order-and-Pay صور المنتجات في الخلفية خلال دقائق |
| الملفات الكبيرة | أكثر من 1,000 سجل تُفحص وتُطبَّق في الخلفية؛ وتنتظرها لوحة التحكم من تلقاء نفسها |
| فحص | يمكن تطبيقه خلال ساعة واحدة، مرة واحدة |
| التراجع | 30 يومًا |