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-Pay | Overview ٹیب، سب سے نیچے |
| Order-and-Pay | Import & export ٹیب، سب سے نیچے |
| Tickets-and-Pay | Settings ٹیب، سب سے نیچے |
| Submit-Info | Settings ٹیب، سب سے نیچے |
اسے صرف نمبر کا owner اور admins دیکھتے ہیں۔
Download سیٹ اپ کو .a2e.jsonl فائل کے طور پر دیتا ہے۔ Download with pictures ایک .zip دیتا ہے جس میں وہی فائل اور ہر تصویر اندر ہوتی ہے: مکمل آف لائن بیک اپ جسے آپ جوں کا توں دوبارہ اپ لوڈ کر سکتے ہیں۔
فائل کو ٹیکسٹ ایڈیٹر میں کھولیں اور لائنیں بدلیں، شامل کریں یا ہٹائیں۔ ہر لائن ایک چیز ہے: ایک سروس، ایک پروڈکٹ، ایک ایونٹ۔ اسپریڈ شیٹ کی ضرورت نہیں۔
Upload a file اسے پہلے جانچتا ہے۔ ابھی کچھ نہیں بدلتا۔ آپ کو ہر مسئلہ اس کے لائن نمبر اور حل کے ساتھ نظر آتا ہے، یا یہ کہ لاگو کرنے سے کیا ہو گا: کتنی چیزیں نئی ہیں، بدلی ہیں یا ہٹائی جائیں گی، اور کون سی۔
Apply بالکل وہی تبدیلیاں کرتا ہے جو جانچ نے دکھائی تھیں۔ جانچ 1 گھنٹے تک درست رہتی ہے۔
ہر apply Recent changes by setup file کے تحت درج ہوتا ہے۔ Undo اس apply کی کی ہوئی ہر تبدیلی واپس کر دیتا ہے، 30 دن تک، جب تک کسی بعد کے apply نے اسی integration کو نہ بدلا ہو۔ پہلے بعد والے کو واپس کریں۔
اپ لوڈ کرنے سے پہلے چنیں کہ جو چیزیں فائل میں درج نہیں ان کا کیا ہو:
اگر آپ ایک سے زیادہ نمبرز کے owner یا admin ہیں تو Copy to another number کسی integration کا سیٹ اپ اس نمبر سے جس پر آپ ہیں کسی دوسرے پر کاپی کرتا ہے: دوسری برانچ، ٹیسٹ نمبر، یا ہر نئی دکان کو دینے کے لیے ٹیمپلیٹ۔
کاپی پہلے دوسرے نمبر پر جانچی جاتی ہے اور دکھاتی ہے کہ وہاں کیا بدلے گا۔ Copy now اسے لاگو کرتا ہے۔ تصاویر ساتھ جاتی ہیں۔ کاپی واپس کرنے کے لیے دوسرے نمبر پر وہی integration کھولیں: کاپی وہاں Recent changes کے تحت درج ہے۔
Book-and-Pay، Order-and-Pay اور Tickets-and-Pay کا ویب ایڈریس صرف ایک نمبر کا ہوتا ہے اور کبھی کاپی نہیں ہوتا۔ دوسرے نمبر کا ایڈریس اس کے اپنے ڈیش بورڈ میں سیٹ کریں۔
| Integration | لائنیں |
|---|---|
| Book-and-Pay | booking.settings (ہر سیکشن کی ایک لائن: اوقات، ویب، برانڈ، میسجز ...)، booking.service، booking.provider (اسٹاف) |
| Order-and-Pay | shop.settings (ہر سیکشن کی ایک لائن، بشمول آرڈر صفحے کی شکل)، shop.category، shop.option_group، shop.item (variants اور تصاویر کے ساتھ) |
| 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: ایک تصویر، جس کا نام اسے استعمال کرنے والی لائنیں دیتی ہیں |
فائل میں کبھی نہیں
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 میں سمانے کے لیے۔
ایجنٹ درجنوں کالز کے بجائے ایک جانچے ہوئے مرحلے میں پورا 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 نہیں۔
ایجنٹ کا معمول کا چکر: گائیڈ پڑھیں، موجودہ فائل ایکسپورٹ کریں، چند لائنیں بدلیں، جانچیں، جو جانچ بتائے اسے ٹھیک کریں، پھر check_id لاگو کرنے سے پہلے صارف سے پوچھیں۔
| کیا | حد |
|---|---|
| ایک فائل | 20 MB ٹیکسٹ، 50,000 لائنیں (ڈیش بورڈ میں، زیادہ سے زیادہ 19 MB کا اپ لوڈ) |
| اندر تصاویر والی درخواست | API کے ذریعے 60 MB |
| ایک تصویر | 5 MB |
| ایڈریس سے حاصل کی جانے والی تصاویر | فی اپ لوڈ 100؛ Order-and-Pay پروڈکٹ کی تصاویر پس منظر میں منٹوں کے اندر حاصل کرتا ہے |
| بڑی فائلیں | 1,000 سے زیادہ ریکارڈز پس منظر میں جانچے اور لاگو کیے جاتے ہیں؛ ڈیش بورڈ خود ان کا انتظار کرتا ہے |
| ایک جانچ | 1 گھنٹے کے اندر، ایک بار لاگو کی جا سکتی ہے |
| Undo | 30 دن |