app2email API قیمتیں

دستاویزات

Setup فائلیں

setup فائل کسی integration کا پورا سیٹ اپ ایک ٹیکسٹ فائل میں رکھتی ہے۔ اسے بیک اپ کے طور پر ڈاؤن لوڈ کریں، بہت سی چیزیں ایک ساتھ بدلیں، سیٹ اپ کسی دوسرے نمبر پر کاپی کریں، یا AI ایجنٹ سے API یا MCP کے ذریعے سب کچھ سیٹ کروائیں۔ ہر اپ لوڈ پہلے جانچا جاتا ہے اور واپس کیا جا سکتا ہے۔

setup فائل میں وہ سب کچھ ہوتا ہے جو آپ نے کسی integration میں سیٹ کیا ہے: سیٹنگز، Book-and-Pay کی سروسز اور اسٹاف، Order-and-Pay کی کیٹگریز، آپشنز اور پروڈکٹس، Tickets-and-Pay کے ایونٹس، تاریخیں اور ٹکٹ کی اقسام، اور Submit-Info کے فارمز اور آٹومیشنز۔ یہ ایک ٹیکسٹ فائل ہے، اس لیے آپ اسے بیک اپ کے طور پر رکھ سکتے ہیں، کسی بھی ایڈیٹر میں بدل سکتے ہیں، دوبارہ اپ لوڈ کر سکتے ہیں، یا اپنے کسی دوسرے نمبر پر کاپی کر سکتے ہیں۔

وہی فائل تین جگہ کام کرتی ہے: ڈیش بورڈ، API اور AI ایجنٹس کے لیے MCP سرور۔

ڈیش بورڈ میں

ہر integration میں ایک Setup file سیکشن ہے:

Integrationکہاں
Book-and-PayOverview ٹیب، سب سے نیچے
Order-and-PayImport & export ٹیب، سب سے نیچے
Tickets-and-PaySettings ٹیب، سب سے نیچے
Submit-InfoSettings ٹیب، سب سے نیچے

اسے صرف نمبر کا owner اور admins دیکھتے ہیں۔

  1. 1. ڈاؤن لوڈ

    Download سیٹ اپ کو .a2e.jsonl فائل کے طور پر دیتا ہے۔ Download with pictures ایک .zip دیتا ہے جس میں وہی فائل اور ہر تصویر اندر ہوتی ہے: مکمل آف لائن بیک اپ جسے آپ جوں کا توں دوبارہ اپ لوڈ کر سکتے ہیں۔

  2. 2. تبدیل کریں

    فائل کو ٹیکسٹ ایڈیٹر میں کھولیں اور لائنیں بدلیں، شامل کریں یا ہٹائیں۔ ہر لائن ایک چیز ہے: ایک سروس، ایک پروڈکٹ، ایک ایونٹ۔ اسپریڈ شیٹ کی ضرورت نہیں۔

  3. 3. اپ لوڈ

    Upload a file اسے پہلے جانچتا ہے۔ ابھی کچھ نہیں بدلتا۔ آپ کو ہر مسئلہ اس کے لائن نمبر اور حل کے ساتھ نظر آتا ہے، یا یہ کہ لاگو کرنے سے کیا ہو گا: کتنی چیزیں نئی ہیں، بدلی ہیں یا ہٹائی جائیں گی، اور کون سی۔

  4. 4. لاگو کریں

    Apply بالکل وہی تبدیلیاں کرتا ہے جو جانچ نے دکھائی تھیں۔ جانچ 1 گھنٹے تک درست رہتی ہے۔

  5. 5. واپس کریں

    ہر apply Recent changes by setup file کے تحت درج ہوتا ہے۔ Undo اس apply کی کی ہوئی ہر تبدیلی واپس کر دیتا ہے، 30 دن تک، جب تک کسی بعد کے apply نے اسی integration کو نہ بدلا ہو۔ پہلے بعد والے کو واپس کریں۔

شامل کریں اور بدلیں، یا بالکل فائل جیسا بنائیں

اپ لوڈ کرنے سے پہلے چنیں کہ جو چیزیں فائل میں درج نہیں ان کا کیا ہو:

  • Add and change (ڈیفالٹ): فائل کی لائنیں بنتی یا بدلتی ہیں، باقی سب جیسا ہے ویسا رہتا ہے۔ صرف پانچ لائنوں کی فائل صرف وہی پانچ چیزیں بدلتی ہے۔
  • Make it exactly like the file: اسی قسم کی جو چیز فائل میں درج نہ ہو وہ ہٹا دی جاتی ہے۔ پروڈکٹ آرکائیو ہوتی ہے، کبھی حذف نہیں ہوتی۔ جانچ لاگو کرنے سے پہلے ہر ہٹائی جانے والی چیز درج کرتی ہے۔

کسی دوسرے نمبر پر کاپی کریں

اگر آپ ایک سے زیادہ نمبرز کے owner یا admin ہیں تو Copy to another number کسی integration کا سیٹ اپ اس نمبر سے جس پر آپ ہیں کسی دوسرے پر کاپی کرتا ہے: دوسری برانچ، ٹیسٹ نمبر، یا ہر نئی دکان کو دینے کے لیے ٹیمپلیٹ۔

کاپی پہلے دوسرے نمبر پر جانچی جاتی ہے اور دکھاتی ہے کہ وہاں کیا بدلے گا۔ Copy now اسے لاگو کرتا ہے۔ تصاویر ساتھ جاتی ہیں۔ کاپی واپس کرنے کے لیے دوسرے نمبر پر وہی integration کھولیں: کاپی وہاں Recent changes کے تحت درج ہے۔

Note

Book-and-Pay، Order-and-Pay اور Tickets-and-Pay کا ویب ایڈریس صرف ایک نمبر کا ہوتا ہے اور کبھی کاپی نہیں ہوتا۔ دوسرے نمبر کا ایڈریس اس کے اپنے ڈیش بورڈ میں سیٹ کریں۔

setup فائل میں کیا ہوتا ہے

Integrationلائنیں
Book-and-Paybooking.settings (ہر سیکشن کی ایک لائن: اوقات، ویب، برانڈ، میسجز ...)، booking.service، booking.provider (اسٹاف)
Order-and-Payshop.settings (ہر سیکشن کی ایک لائن، بشمول آرڈر صفحے کی شکل)، shop.category، shop.option_group، shop.item (variants اور تصاویر کے ساتھ)
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: ایک تصویر، جس کا نام اسے استعمال کرنے والی لائنیں دیتی ہیں

فائل میں کبھی نہیں

  • Secrets: ادائیگی کی کلیدیں، کنکشن کے پاس ورڈز اور ٹوکنز۔ محفوظ شدہ secret جیسا ہے ویسا رہتا ہے۔
  • کسی integration کو آن کرنا۔ فائل کبھی ایسا نہیں کرتی، اور فائل کبھی ٹکٹ والے ایونٹ کو پبلش، منسوخ یا حذف نہیں کرتی۔
  • کسٹمرز نے کیا کیا: بکنگز، آرڈرز، فروخت شدہ ٹکٹس، submissions، کسٹمرز، ادائیگیاں۔
  • ٹیم ارکان اور اسٹاف کے لاگ ان۔
  • Order-and-Pay کے اسٹاک کے اعداد، جب تک آپ Also set the stock figures from the file پر نشان نہ لگائیں۔ اس کے بغیر، صبح ایکسپورٹ کی گئی فائل دن کی فروخت کو واپس نہیں کر سکتی۔

فارمیٹ

setup فائل JSON Lines ہے: ہر لائن میں ایک 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)۔ ہر لائن کے درست فیلڈز API کی گائیڈ (GET /v1/{number}/setup/guide) میں ہیں۔

تصاویر

ریکارڈ کسی asset لائن کی key سے تصویر کا نام لیتا ہے۔ تصویر ان میں سے کسی ایک سے آتی ہے:

  • url: ایک https:// ایڈریس، جسے ہم حاصل کرتے ہیں۔
  • data: خود تصویر، base64۔
  • file: اپ لوڈ کی گئی .zip کے اندر کا path۔
  • 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۔ جہاں integration کو ضرورت ہو، تصویر چھوٹی کی جاتی ہے یا JPEG میں بدلی جاتی ہے: Book-and-Pay کا لوگو 300 KB میں سمانے کے لیے، Tickets-and-Pay کی تصویر 1 MB میں سمانے کے لیے۔

AI ایجنٹس اور API کے لیے

ایجنٹ درجنوں کالز کے بجائے ایک جانچے ہوئے مرحلے میں پورا integration سیٹ کرتا ہے۔ 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تازہ ترین جانچیں، apply اور undo
POST /v1/{number}/setup/jobs/{id}/undoوہ واپس کرتی ہے جو کسی apply نے بدلا

کلید کو integration کی اپنی اجازت چاہیے: bookings:manage، orders:manage، tickets:manage یا submissions:manage۔ sandbox کلید ایکسپورٹ اور جانچ کر سکتی ہے، لیکن apply نہیں۔

Tip

ایجنٹ کا معمول کا چکر: گائیڈ پڑھیں، موجودہ فائل ایکسپورٹ کریں، چند لائنیں بدلیں، جانچیں، جو جانچ بتائے اسے ٹھیک کریں، پھر check_id لاگو کرنے سے پہلے صارف سے پوچھیں۔

حدود

کیاحد
ایک فائل20 MB ٹیکسٹ، 50,000 لائنیں (ڈیش بورڈ میں، زیادہ سے زیادہ 19 MB کا اپ لوڈ)
اندر تصاویر والی درخواستAPI کے ذریعے 60 MB
ایک تصویر5 MB
ایڈریس سے حاصل کی جانے والی تصاویرفی اپ لوڈ 100؛ Order-and-Pay پروڈکٹ کی تصاویر پس منظر میں منٹوں کے اندر حاصل کرتا ہے
بڑی فائلیں1,000 سے زیادہ ریکارڈز پس منظر میں جانچے اور لاگو کیے جاتے ہیں؛ ڈیش بورڈ خود ان کا انتظار کرتا ہے
ایک جانچ1 گھنٹے کے اندر، ایک بار لاگو کی جا سکتی ہے
Undo30 دن