ملف الإعداد كيحمل الإعداد الكامل ديال الربط ف ملف نصي وحدو. نزّلو كنسخة احتياطية، بدّل بزاف ديال الحوايج مرة وحدة، انسخ إعداد لرقم آخر، ولا خلّي وكيل AI يسطّب كلشي عبر API أو MCP. كل رفع كيتشاف قبل ما يدخل، وكيتقدر يتلغا.
ملف الإعداد كيحمل كاع اللي سطّبتي فربط: الإعدادات والخدمات والخدامين ديال Book-and-Pay، الفئات والخيارات والمنتجات ديال Order-and-Pay، الأحداث والتواريخ وأنواع التذاكر ديال Tickets-and-Pay، والاستمارات والأتمتة ديال Submit-Info. هو ملف نصي وحدو، فتقدر تحتفظ بيه كنسخة احتياطية، تبدّلو فأي محرر نصوص، ترفعو من جديد، ولا تنسخو لرقم آخر ديالك.
نفس الملف كيخدم فثلاث بلايص: لوحة التحكم، والـ API، وسيرفر MCP ديال وكلاء AI.
كل ربط عندو قسم 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: object JSON فكل سطر. السطر الأول كيقول شنو هو الملف؛ كل سطر آخر هو سجل وحدو فيه type وkey. الـ key كيلقى نفس السجل مرة أخرى فالمرة الجاية: id ديال الخدمة، 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). الحقول بالضبط ديال كل سطر كاينين فالguide ديال API (GET /v1/{number}/setup/guide).
السجل كيسمي الصورة بالـ key ديال سطر 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 | كيرجّع اللي التطبيق بدّل |
الـ key خاصو صلاحية الربط ديالو: bookings:manage، orders:manage، tickets:manage ولا submissions:manage. الـ sandbox key يقدر يصدّر ويتشيك، ولكن ما يطبقش.
الحلقة العادية ديال الوكيل: اقرا الguide، صدّر الملف الحالي، بدّل شي سطور، تشيك، صلّح اللي التشيك بيّن، ومن بعد سول المستخدم قبل ما تطبّق check_id.
| الشي | الحد |
|---|---|
| الملف | 20 MB نص، 50,000 سطر (فلوحة التحكم، الرفع حتى 19 MB) |
| طلب فيه صور | 60 MB عبر API |
| الصورة | 5 MB |
| الصور اللي تجيب بالعنوان | 100 فكل رفع؛ Order-and-Pay كيجيب صور المنتجات فالخلفية فظرف دقايق |
| الملفات الكبار | أكثر من 1,000 سجل كيتشيكو ويتطبقو فالخلفية؛ لوحة التحكم كتسنى وحدها |
| التشيك | كيتطبق فساعة، مرة وحدة |
| الرجوع | 30 يوم |