app2email API الأسعار

التوثيق

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

يحمل ملف الإعداد الإعداد الكامل لتكامل ما في ملف نصي واحد. نزّله نسخةً احتياطية، أو غيّر أشياء كثيرة دفعة واحدة، أو انسخ إعدادًا إلى رقم آخر، أو دع وكيل ذكاء اصطناعي يعدّ كل شيء عبر 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، في الأسفل

لا يراه إلا مالك الرقم ومسؤولوه.

  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 يومًا، ما دام لم يغيّر تطبيق لاحق التكامل نفسه. تراجع عن الأحدث أولًا.

أضف وغيّر، أو اجعله مطابقًا للملف تمامًا

قبل الرفع، اختر ما يحدث للأشياء التي لا يسردها الملف:

  • Add and change (الافتراضي): تُنشأ الأسطر الموجودة في الملف أو تتغير، ويبقى كل شيء آخر كما هو. ملف فيه خمسة أسطر فقط يغيّر هذه الأشياء الخمسة فقط.
  • Make it exactly like the file: يُزال كل شيء من النوع نفسه لا يسرده الملف. يُؤرشف المنتج ولا يُحذف أبدًا. ويسرد الفحص كل إزالة قبل أن تطبّق.

انسخ إلى رقم آخر

إذا كنت مالك أكثر من رقم أو مسؤولًا عنه، فإن 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: كائن 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.

لوكلاء الذكاء الاصطناعي و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يعيد ما غيّره تطبيق

يحتاج المفتاح إلى صلاحية التكامل نفسه: bookings:manage أو orders:manage أو tickets:manage أو submissions:manage. ويمكن لمفتاح sandbox أن يصدّر ويفحص، لكن لا يطبّق.

Tip

الحلقة المعتادة للوكيل: يقرأ الدليل، ويصدّر الملف الحالي، ويغيّر بضعة أسطر، ويفحص، ويصلح ما أبلغ عنه الفحص، ثم يسأل المستخدم قبل أن يطبّق check_id.

الحدود

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