app2email API प्राइसिंग

दस्तावेज़ीकरण

सेटअप फ़ाइलें

सेटअप फ़ाइल किसी इंटीग्रेशन का पूरा सेटअप एक टेक्स्ट फ़ाइल में रखती है। उसे बैकअप के रूप में डाउनलोड करें, एक साथ कई बदलाव करें, किसी सेटअप को दूसरे नंबर पर कॉपी करें, या AI एजेंट से API या MCP के ज़रिए सब कुछ सेट करवाएँ। हर अपलोड पहले जाँचा जाता है और पलटा जा सकता है।

सेटअप फ़ाइल में वह सब कुछ होता है जो आपने किसी इंटीग्रेशन में सेट किया है: सेटिंग्स, Book-and-Pay की सेवाएँ और स्टाफ़, Order-and-Pay की श्रेणियाँ, विकल्प और उत्पाद, Tickets-and-Pay के इवेंट, तारीखें और टिकट प्रकार, और Submit-Info के फ़ॉर्म और ऑटोमेशन। यह एक टेक्स्ट फ़ाइल है, इसलिए आप इसे बैकअप के रूप में रख सकते हैं, किसी भी एडिटर में बदल सकते हैं, दोबारा अपलोड कर सकते हैं, या अपने किसी दूसरे नंबर पर कॉपी कर सकते हैं।

यही फ़ाइल तीन जगह काम करती है: डैशबोर्ड, API और AI एजेंट के लिए MCP सर्वर।

डैशबोर्ड में

हर इंटीग्रेशन में एक Setup file सेक्शन होता है:

इंटीग्रेशनकहाँ
Book-and-PayOverview टैब, सबसे नीचे
Order-and-PayImport & export टैब, सबसे नीचे
Tickets-and-PaySettings टैब, सबसे नीचे
Submit-InfoSettings टैब, सबसे नीचे

इसे सिर्फ़ नंबर का मालिक और एडमिन देखते हैं।

  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 ने उसी इंटीग्रेशन को न बदला हो। पहले बाद वाले को पलटें।

जोड़ें और बदलें, या इसे ठीक फ़ाइल जैसा बना दें

अपलोड से पहले चुनें कि फ़ाइल में जो चीज़ें सूचीबद्ध नहीं हैं उनका क्या हो:

  • Add and change (डिफ़ॉल्ट): फ़ाइल की लाइनें बनाई या बदली जाती हैं, बाकी सब जैसा है वैसा रहता है। सिर्फ़ पाँच लाइनों वाली फ़ाइल सिर्फ़ उन्हीं पाँच चीज़ों को बदलती है।
  • Make it exactly like the file: उसी प्रकार की जो चीज़ें फ़ाइल में सूचीबद्ध नहीं हैं, वे हटा दी जाती हैं। उत्पाद आर्काइव होता है, कभी डिलीट नहीं। हर हटाई जाने वाली चीज़ Apply से पहले जाँच में सूचीबद्ध होती है।

दूसरे नंबर पर कॉपी करें

अगर आप एक से ज़्यादा नंबरों के मालिक या एडमिन हैं, तो 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: एक तस्वीर, जिसका नाम उसे इस्तेमाल करने वाली लाइनों से तय होता है

फ़ाइल में कभी नहीं

  • गोपनीय जानकारी: भुगतान की कुंजियाँ, कनेक्शन के पासवर्ड और टोकन। सहेजी हुई गोपनीय जानकारी जैसी है वैसी रहती है।
  • किसी इंटीग्रेशन को चालू करना। फ़ाइल कभी ऐसा नहीं करती, और फ़ाइल कभी टिकट वाले इवेंट को प्रकाशित, रद्द या डिलीट नहीं करती।
  • ग्राहकों ने जो किया: बुकिंग, ऑर्डर, बिके हुए टिकट, सबमिशन, ग्राहक, भुगतान।
  • टीम के सदस्य और स्टाफ़ लॉगिन।
  • Order-and-Pay के स्टॉक के आँकड़े, जब तक आप Also set the stock figures from the file पर टिक न करें। इसके बिना, सुबह एक्सपोर्ट की गई फ़ाइल दिन की बिक्री को पलट नहीं सकती।

फ़ॉर्मैट

सेटअप फ़ाइल 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 में फ़िट होने लायक।

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ताज़ा जाँचें, Apply और Undo
POST /v1/{number}/setup/jobs/{id}/undoApply ने जो बदला था उसे वापस कर देता है

कुंजी के पास इंटीग्रेशन की अपनी अनुमति होनी चाहिए: bookings:manage, orders:manage, tickets:manage या submissions:manage। सैंडबॉक्स कुंजी एक्सपोर्ट और जाँच कर सकती है, पर Apply नहीं।

Tip

एजेंट का सामान्य क्रम: गाइड पढ़ें, मौजूदा फ़ाइल एक्सपोर्ट करें, कुछ लाइनें बदलें, जाँचें, जाँच जो बताए उसे ठीक करें, फिर check_id लागू करने से पहले उपयोगकर्ता से पूछें।

सीमाएँ

क्यासीमा
एक फ़ाइल20 MB टेक्स्ट, 50,000 लाइनें (डैशबोर्ड में, अधिकतम 19 MB का अपलोड)
तस्वीरों समेत एक अनुरोधAPI के ज़रिए 60 MB
एक तस्वीर5 MB
पते से लाई गई तस्वीरेंप्रति अपलोड 100; Order-and-Pay उत्पादों की तस्वीरें कुछ मिनटों में बैकग्राउंड में लाता है
बड़ी फ़ाइलें1,000 से ज़्यादा रिकॉर्ड की जाँच और Apply बैकग्राउंड में होता है; डैशबोर्ड उनका खुद इंतज़ार करता है
एक जाँच1 घंटे के भीतर, एक बार लागू की जा सकती है
Undo30 दिन