app2email API الأثمنة

التوثيق

ملفات الإعداد

ملف الإعداد كيحمل الإعداد الكامل ديال الربط ف ملف نصي وحدو. نزّلو كنسخة احتياطية، بدّل بزاف ديال الحوايج مرة وحدة، انسخ إعداد لرقم آخر، ولا خلّي وكيل 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، تحت

غير المالك والأدمنز ديال الرقم كيشوفوه.

  1. 1. نزّل

    Download كيعطيك الإعداد فملف .a2e.jsonl. Download with pictures كيعطيك ملف .zip فيه نفس الملف وكاع الصور ديالو: نسخة احتياطية كاملة بلا إنترنت، تقدر ترفعها من جديد كيفما هي.

  2. 2. بدّل

    حل الملف فمحرر نصوص وبدّل، زيد، ولا حيد السطور. كل سطر حاجة وحدة: خدمة، منتج، حدث. ماخاصكش جدول بيانات.

  3. 3. رفع

    Upload a file كيتشيك الملف قبل كولشي. والو ما كيتبدلش دابا. كتشوف كل مشكل برقم السطر ديالو وكيفاش تصلحو، ولا شنو غادي يدير التطبيق: شحال من حاجة جديدة، مبدّلة، ولا محيّدة، وشنو هي.

  4. 4. طبّق

    Apply كيدير غير التبديلات اللي بيّن التشيك. التشيك كيبقى صالح لمدة ساعة.

  5. 5. رجّع

    كل تطبيق كيتسجل تحت Recent changes by setup file. Undo كيرجّع كاع اللي التطبيق بدّل، لمدة 30 يوم، ما دام ماكاين تطبيق ساير بدّل نفس الربط. رجّع الأخير الأول.

زيد وبدّل، ولا خليه بحال الملف بالضبط

قبل ما ترفع، اختار شنو غادي يوقع للحوايج اللي الملف ما كيذكرهاش:

  • زيد وبدّل (الافتراضي): السطور اللي فالملف كيتخلقو ولا كيتبدلو، والباقي كيبقى كيفما هو. ملف فيه غير خمس سطور كيبدّل غير هاد الخمسة.
  • خليه بحال الملف بالضبط: أي شي من نفس النوع ما كيذكرهوش الملف كيتحيد. المنتج كيتأرشف، ماكيتمسحش. التشيك كيبيّن كاع الحيدان قبل ما تطبق.

انسخ لرقم آخر

ملي تكون المالك ولا الأدمن ديال أكثر من رقم، Copy to another number كينسخ إعداد ربط من الرقم اللي فيه لرقم آخر: فرع ثاني، رقم تجربة، ولا قالب تعطيه لكل محل جديد.

النسخة كتتشيك فالرقم الآخر أول، وكتبيّن شنو غادي تبدّل هناك. Copy now كيطبّقها. الصور كيمشيو معاها. باش ترجع النسخة، حل نفس الربط فالرقم الآخر: النسخة كتكون مسجلة هناك تحت Recent changes.

Note

عنوان الويب ديال Book-and-Pay وOrder-and-Pay وTickets-and-Pay كيتعلق برقم وحدة غير، وما كيتنسخش أبدا. سطّب عنوان الرقم الآخر فلوحة التحكم ديالو.

شنو كيحمل ملف الإعداد

الربطالسطور
Book-and-Paybooking.settings (سطر لكل قسم: ساعات، ويب، براند، رسائل ...)، booking.service، booking.provider (الخدامين)
Order-and-Payshop.settings (سطر لكل قسم، بما فيه شكل صفحة الطلب)، shop.category، shop.option_group، shop.item (مع المتغيرات والصور)
Tickets-and-Paytickets.settings (سطر لكل قسم؛ wa_templates هو الصياغة ديالك للرسائل ديال WhatsApp)، tickets.chart (خرائط المقاعد المحفوظة)، tickets.event (مع تواريخه، وأنواع تذاكره، والحدود المشتركة، والصور، وخريطة المقاعد)، tickets.promo
Submit-Infosubmit.settings، submit.list، submit.connection، submit.form، submit.automation
الكلasset: صورة، كتتسمى بالسطور اللي كتستعملها

ماكاينش فالملف أبدا

  • الأسرار: مفاتيح الخلاص، كلمات سر الربط، والـ tokens. السر المخزّن كيبقى كيفما هو.
  • تشغيل ربط. الملف ما كيديرها أبدا، والملف ما كينشرش، ولا كيلغي، ولا كيمسح حدث فيه تذاكر.
  • اللي دار الزبناء: الحجوزات، الطلبيات، التذاكر المباعة، الإرساليات، الزبناء، والخلاصات.
  • أعضاء الفريق ودخول الخدامين.
  • أرقام المخزون ديال Order-and-Pay، إلا علّمتي Also set the stock figures from the file. بلاه، ملف صدّرتي الصباح ما يقدرش يرجّع مبيعات النهار.

الصيغة

ملف الإعداد هو 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.

لوكلاء AI وللـ API

الوكيل كيسطّب ربط كامل فخطوة وحدة متشيكة بدل عشرات النداءات. السيرفر ديال 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 يقدر يصدّر ويتشيك، ولكن ما يطبقش.

Tip

الحلقة العادية ديال الوكيل: اقرا الguide، صدّر الملف الحالي، بدّل شي سطور، تشيك، صلّح اللي التشيك بيّن، ومن بعد سول المستخدم قبل ما تطبّق check_id.

الحدود

الشيالحد
الملف20 MB نص، 50,000 سطر (فلوحة التحكم، الرفع حتى 19 MB)
طلب فيه صور60 MB عبر API
الصورة5 MB
الصور اللي تجيب بالعنوان100 فكل رفع؛ Order-and-Pay كيجيب صور المنتجات فالخلفية فظرف دقايق
الملفات الكبارأكثر من 1,000 سجل كيتشيكو ويتطبقو فالخلفية؛ لوحة التحكم كتسنى وحدها
التشيككيتطبق فساعة، مرة وحدة
الرجوع30 يوم