सेटअप फ़ाइल किसी इंटीग्रेशन का पूरा सेटअप एक टेक्स्ट फ़ाइल में रखती है। उसे बैकअप के रूप में डाउनलोड करें, एक साथ कई बदलाव करें, किसी सेटअप को दूसरे नंबर पर कॉपी करें, या AI एजेंट से API या MCP के ज़रिए सब कुछ सेट करवाएँ। हर अपलोड पहले जाँचा जाता है और पलटा जा सकता है।
सेटअप फ़ाइल में वह सब कुछ होता है जो आपने किसी इंटीग्रेशन में सेट किया है: सेटिंग्स, Book-and-Pay की सेवाएँ और स्टाफ़, Order-and-Pay की श्रेणियाँ, विकल्प और उत्पाद, Tickets-and-Pay के इवेंट, तारीखें और टिकट प्रकार, और Submit-Info के फ़ॉर्म और ऑटोमेशन। यह एक टेक्स्ट फ़ाइल है, इसलिए आप इसे बैकअप के रूप में रख सकते हैं, किसी भी एडिटर में बदल सकते हैं, दोबारा अपलोड कर सकते हैं, या अपने किसी दूसरे नंबर पर कॉपी कर सकते हैं।
यही फ़ाइल तीन जगह काम करती है: डैशबोर्ड, API और AI एजेंट के लिए MCP सर्वर।
हर इंटीग्रेशन में एक 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 ठीक वही बदलाव करता है जो जाँच में दिखे थे। जाँच 1 घंटे तक मान्य रहती है।
हर Apply Recent changes by setup file के नीचे सूचीबद्ध होता है। Undo उस Apply के किए सारे बदलाव 30 दिन तक वापस कर देता है, बशर्ते बाद के किसी Apply ने उसी इंटीग्रेशन को न बदला हो। पहले बाद वाले को पलटें।
अपलोड से पहले चुनें कि फ़ाइल में जो चीज़ें सूचीबद्ध नहीं हैं उनका क्या हो:
अगर आप एक से ज़्यादा नंबरों के मालिक या एडमिन हैं, तो 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 होती है: हर लाइन पर एक 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 के अंदर का पाथ।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 | ताज़ा जाँचें, Apply और Undo |
POST /v1/{number}/setup/jobs/{id}/undo | Apply ने जो बदला था उसे वापस कर देता है |
कुंजी के पास इंटीग्रेशन की अपनी अनुमति होनी चाहिए: bookings:manage, orders:manage, tickets:manage या submissions:manage। सैंडबॉक्स कुंजी एक्सपोर्ट और जाँच कर सकती है, पर Apply नहीं।
एजेंट का सामान्य क्रम: गाइड पढ़ें, मौजूदा फ़ाइल एक्सपोर्ट करें, कुछ लाइनें बदलें, जाँचें, जाँच जो बताए उसे ठीक करें, फिर check_id लागू करने से पहले उपयोगकर्ता से पूछें।
| क्या | सीमा |
|---|---|
| एक फ़ाइल | 20 MB टेक्स्ट, 50,000 लाइनें (डैशबोर्ड में, अधिकतम 19 MB का अपलोड) |
| तस्वीरों समेत एक अनुरोध | API के ज़रिए 60 MB |
| एक तस्वीर | 5 MB |
| पते से लाई गई तस्वीरें | प्रति अपलोड 100; Order-and-Pay उत्पादों की तस्वीरें कुछ मिनटों में बैकग्राउंड में लाता है |
| बड़ी फ़ाइलें | 1,000 से ज़्यादा रिकॉर्ड की जाँच और Apply बैकग्राउंड में होता है; डैशबोर्ड उनका खुद इंतज़ार करता है |
| एक जाँच | 1 घंटे के भीतर, एक बार लागू की जा सकती है |
| Undo | 30 दिन |