विषय पर बढ़ें

MintOffice

MintOffice, mintbot.ai का Brand Partner पोर्टल है। यह आपको mintbot को अपने खुद के ब्रांड के तहत रीसेल करने देता है: आपका डोमेन, आपका बॉट, आपकी क्लाइंट सूची — जबकि परदे के पीछे डिप्लॉयमेंट, बिलिंग की व्यवस्था और प्रति-एजेंट इंफ्रास्ट्रक्चर का ज़िम्मा mintbot संभालता है।

लाइव पार्टनर पोर्टल यहाँ उपलब्ध है: mint.mintbot.ai।

यह गाइड आपको "मैंने अभी MintOffice के बारे में सुना है" से लेकर "मेरा पहला व्हाइट-लेबल एजेंट मेरे अपने डोमेन पर लाइव है" तक ले जाती है। तकनीकी हिस्से (DNS रिकॉर्ड, GitHub रिपॉज़िटरी, बॉट टोकन) सबसे बेहतर तब संभलते हैं जब उन्हें आपकी ओर से कोई mintbot एजेंट करे — शुरू करने से पहले किसी एजेंट से अपना सेटअप करवाएँ देखें।

इंटीग्रेशन खुद बनाना चाहते हैं?

डेवलपर-फेसिंग पक्ष के लिए — कौन-सी रिपॉज़िटरीज़ आपकी हैं, डिप्लॉय फ़्लो एंड-टू-एंड कैसे चलता है, और एजेंट कस्टमाइज़ेशन रिपॉज़िटरी + स्टोरफ्रंट कैसे आपस में फ़िट होते हैं — देखें MintOffice — Technical।

आपको क्या मिलता है

  • mintbot के Brand Partner पैकेज (Test 24h, Standard, Performance) को अपने खुद के डोमेन के तहत रीसेल करें — आपके ग्राहक agent1.yourbrand.com देखते हैं, न कि *.mintbot.ai।
  • चैट ट्रैफ़िक के लिए अपना खुद का Telegram बॉट (@yourbrand_bot) इस्तेमाल करें, या जब तक आप टेस्टिंग कर रहे हों तब तक mintbot का बॉट उधार लें।
  • अपने ग्राहकों के सामने आने वाली कीमतें चुनें और जो आप उनसे लेते हैं तथा जो mintbot आपसे लेता है (MintOffice थोक फ़्लोर) — उन दोनों के बीच का अंतर अपनी जेब में रखें।
  • प्रोग्रामेटिक ऑर्डर निर्माण, लाइफ़साइकल स्थिति, और आपके अपने सिस्टम में वापस आने वाले वेबहुक के लिए एक Brand Partner API।
  • एक डैशबोर्ड जो सक्रिय ग्राहक ऑर्डर, बॉट-लिंक की सेहत, कीमत, पेआउट, और वेबहुक डिलीवरी दिखाता है।

कीमत — Brand Partner सेटअप शुल्क

मुफ़्त ट्रायल पोर्टल अकाउंट के लिए साइन अप करना, जाहिर है, मुफ़्त है — लेकिन Brand Partner साइनअप वह एकमात्र भुगतान है जो इसे एक असली ब्रांड-पार्टनर अकाउंट में बदल देता है। आप एक बार का सेटअप शुल्क reception.mintbot.ai/mintoffice पर चुकाते हैं (या dev/test एनवायरनमेंट के लिए reception.mintbot.dev/mintoffice), और वही भुगतान दोनों पोर्टल अनलॉक कर देता है:

टियर कीमत इसमें क्या शामिल है
मुफ़्त ट्रायल (हर नए पार्टनर के लिए डिफ़ॉल्ट) €0 आपके पोर्टल + टेम्पलेट को टेस्ट करने के लिए 10 डिस्पोज़ेबल DEV डिप्लॉय
Brand Partner — लॉन्च प्रोमो €49 एक बार + €10/month 20 DEV डिप्लॉय (प्रत्येक €1 एजेंट क्रेडिट), अकाउंट मैनेजमेंट का पहला महीना शामिल, mint.mintbot.ai + mint.mintbot.dev दोनों पर Brand Partner स्टेटस, विस्तृत सेटअप गाइड (एक एजेंट पूरा विज़ार्ड आपके लिए चला सकता है)
Brand Partner — स्टैंडर्ड €99 एक बार + €10/month लॉन्च जैसा ही — प्रोमो के बिना

साइनअप बीटा में है

Brand Partner चेकआउट फ़िलहाल dev/test एनवायरनमेंट पर खुला है (reception.mintbot.dev/mintoffice)। लाइव .ai चेकआउट जल्द ही खुलेगा।

सेटअप शुल्क में क्या शामिल है:

  • 20 DEV डिप्लॉय, प्रत्येक एक 24-घंटे का डिस्पोज़ेबल टेस्ट VPS जिसमें €1 एजेंट क्रेडिट बीज के रूप में डाला गया हो — आपके पोर्टल और कस्टमाइज़ेशन टेम्पलेट को एंड-टू-एंड परखने के लिए पर्याप्त।
  • आपका अकाउंट मैनेजमेंट का पहला महीना (नीचे दिया गया €10/month शुल्क) — यानी पहला महीना पहले से ही चुकाया जा चुका है।
  • mint.mintbot.ai और mint.mintbot.dev दोनों पर Brand Partner स्टेटस।

€10/month अकाउंट-मैनेजमेंट शुल्क:

दूसरे महीने से आगे, Brand Partner अकाउंट पर €10/month का अकाउंट-मैनेजमेंट शुल्क लगता है। इसे चुकाने का सबसे सहज तरीका एक Stripe या PayPal सब्सक्रिप्शन है (अनुशंसित — यह खुद ही नवीनीकृत हो जाता है); एक बार का सेटअप शुल्क कार्ड या क्रिप्टो से भी चुकाया जा सकता है (CCPayment के ज़रिए BTC, XMR और कई सिक्के)।

अगर मासिक शुल्क छूट जाता है, तो आपका MintOffice अकाउंट paused हो जाता है: आप नए एजेंट डिप्लॉय नहीं कर सकते, लेकिन आपके मौजूदा ग्राहक एजेंट चलते रहते हैं। कुछ भी रुकने से पहले हम आपसे संपर्क करेंगे ताकि आप फिर से शुरू कर सकें।

भुगतान के बाद क्या होता है:

  1. Reception, reception.mintbot.ai/mintoffice (या टेस्ट एनवायरनमेंट पर हों तो .dev) पर सेटअप भुगतान प्रोसेस करता है — कार्ड / Apple Pay / Google Pay, या क्रिप्टो।
  2. Reception तुरंत mint.mintbot.ai और mint.mintbot.dev दोनों को एक हस्ताक्षरित ग्रांट भेजता है, जिससे दोनों पोर्टल पर आपका अकाउंट Brand Partner स्टेटस में बदल जाता है।
  3. आपको pigeon@mintbot.ai से एक स्वागत ईमेल मिलता है (या यदि आपने टेस्ट एन्व पर खरीदा है तो pigeon@mintbot.dev से) जिसमें दोनों साइनइन लिंक और इस गाइड की ओर एक संकेत होता है।
  4. आप जिस भी पोर्टल से शुरू करना चाहें उस पर साइन इन करें। अगर किसी कारण से क्रॉस-एन्व पुश किसी पोर्टल पर पहुँचने से चूक गया, तो उस पोर्टल पर पहला साइनइन reception से पूछता है "क्या इस ईमेल ने भुगतान किया?" और ग्रांट को तुरंत वहीं लागू कर देता है।

जब तक हम MintOffice को रोल आउट कर रहे हैं, लॉन्च प्रोमो डिफ़ॉल्ट रूप से चालू है; यह MINTOFFICE_SETUP_PROMO सर्वर फ़्लैग से नियंत्रित होता है, इसलिए चेकआउट पर आप जो कीमत देखते हैं, वही कीमत आप चुकाते हैं।

रिफ़ंड

14-दिन की रिफ़ंड विंडो, बिना किसी सवाल के — अगर टियर आपके उपयोग के लिए इसके लायक नहीं है, तो support@mintbot.ai पर ईमेल करें और हम शुल्क वापस भेज देंगे।

प्रति-एजेंट थोक कीमत (वह दर जो mintbot आपके द्वारा मिंट किए गए हर ग्राहक ऑर्डर के लिए आपसे लेता है) सेटअप शुल्क से स्वतंत्र है और नीचे स्टेप 5 — कीमत में दी गई है।

किसी एजेंट से अपना सेटअप करवाएँ

ज़्यादातर तकनीकी काम — डोमेन खरीदना, DNS कॉन्फ़िगर करना, Telegram बॉट बनाना, टेम्पलेट रिपॉज़िटरी फ़ोर्क करना — यांत्रिक है। आप इसे हाथ से कर सकते हैं, लेकिन सबसे सहज रास्ता इसे किसी mintbot एजेंट को सौंप देना है।

अनुशंसित रास्ता

एक mintbot एजेंट शुरू करें और उससे कहें: "मुझे डोमेन yourbrand.com के तहत एक MintOffice ब्रांड पार्टनर के रूप में सेट अप करो — मुझे ऑनबोर्डिंग विज़ार्ड के हर चरण से गुज़ारो और जो कुछ भी तुम मेरी ओर से भर सकते हो, भर दो।"

एजेंट के पास एक टर्मिनल, एक ब्राउज़र, एक DNS API, GitHub ऑथ, और इस गाइड का ज्ञान होता है। यह आपको ठीक-ठीक बताएगा कि किस चरण में आपके हस्तक्षेप की ज़रूरत है (जैसे Telegram में BotFather की पुष्टि पर क्लिक करना) और बाकी सब संभाल लेगा।

आपका अपना Hermes, एक OpenCode / OpenClaw इंस्टॉल, Cursor एजेंट मोड, या कोई भी अन्य कोडिंग एजेंट भी उतनी ही अच्छी तरह काम करता है — उसे इस पेज को संदर्भ के रूप में दें और उसे लक्ष्य बताएँ।

अगर आप विज़ार्ड खुद चलाना पसंद करें, तो नीचे दिए गए चरण ठीक वही हैं जो एजेंट करता।

स्टेप 0 — अपना अकाउंट बनाएँ

  1. mint.mintbot.ai खोलें।
  2. वह ईमेल पता टाइप करें जिसे आप अपने ऑपरेटर लॉगिन के रूप में इस्तेमाल करना चाहते हैं।
  3. मुझे login link email करें पर क्लिक करें।
  4. pigeon@mintbot.ai से आया ईमेल खोलें और मैजिक लिंक पर क्लिक करें (24 घंटे के लिए वैध, एक बार उपयोग होने वाला)।

यहाँ कोई पासवर्ड नहीं है — हर अगला लॉगिन एक और मैजिक लिंक होता है। यह जानबूझकर ऐसा है: पासवर्ड लीक होते हैं, मैजिक लिंक नहीं, और अगर आप ईमेल एक्सेस सेट कर लें तो बाद में किसी एजेंट के लिए इन्हें ऑटोमेट करना आसान है।

स्टेप 1 — डोमेन

विज़ार्ड का पहला सवाल यह है कि आपके एजेंट कहाँ रहेंगे। आपके पास दो विकल्प हैं:

एजेंट उस डोमेन के सबडोमेन पर रहते हैं जो आपका है — जैसे agent1.yourbrand.com, agent2.yourbrand.com, … यही ब्रांडेड अनुभव है जो आपके ग्राहक देखते हैं।

आपको चाहिए होगा:

  • एपेक्स डोमेन — एक रजिस्टर्ड, सादा डोमेन (न https://, न सबडोमेन): yourbrand.com।
  • DNS प्रोवाइडर — Zone.ee ही अकेला प्रोवाइडर है जिसमें DNS अपने-आप सेट होता है। मैनुअल मोड में हर एजेंट का A-रिकॉर्ड आप खुद जोड़ते हैं; Cloudflare जल्द आ रहा है।
  • Zone.ee API की + यूज़रनेम — my.zone.eu से जारी → Account settings → API keys → Create new key। जब आप कोई एजेंट प्रोविज़न करते हैं तो एजेंट इसका उपयोग करके अपने आप A-रिकॉर्ड बनाता है।

सबडोमेन नंबरिंग शैली

  • टेक्स्ट प्रीफ़िक्स + नंबर (डिफ़ॉल्ट) — agent1.yourbrand.com, agent2.yourbrand.com, … सबसे पठनीय।
  • केवल नंबर — 1.yourbrand.com, 2.yourbrand.com, … छोटा।
  • नंबर, ज़ीरो-पैडेड — 001.yourbrand.com, … स्थिर चौड़ाई।

यह विकल्प पूरी तरह से दिखावटी है — डिप्लॉय वर्कर तीनों के साथ ठीक रहता है।

एजेंट *.mintbot.ai पर रहते हैं — कोई सेटअप नहीं, कोई DNS नहीं, लेकिन URL में आपका ब्रांड नहीं होता। जाँच-परख के लिए उपयोगी; ग्राहकों के सामने लॉन्च करने से पहले अपने खुद के डोमेन पर स्विच करें।

स्टेप 2 — बॉट

हर एजेंट को एक चैट सतह मिलती है। डिफ़ॉल्ट Telegram मानकर चलते हैं — Discord और Slack का ढाँचा तैयार है लेकिन अभी जोड़ा नहीं गया है।

आपके ग्राहक @yourbrand_bot से चैट करते हैं, जिससे ब्रांड बरकरार रहता है।

  1. Telegram में @BotFather खोलें।
  2. /newbot भेजें। बॉट को एक डिस्प्ले नाम और एक यूज़रनेम दें (जो bot पर ख़त्म होना चाहिए)।
  3. BotFather 123456789:AA… जैसा एक टोकन देता है (कम से कम 40 अक्षर)।
  4. उस टोकन को विज़ार्ड में पेस्ट करें।

अगर आप लंबा संस्करण चाहते हैं तो Telegram का बॉट ट्यूटोरियल देखें।

ग्राहक @mintbot_dev_bot से चैट करते हैं। डेमो के लिए तेज़, लेकिन बिना ब्रांड के। लॉन्च से पहले अपने खुद के बॉट पर पलट जाएँ।

Telegram को पूरी तरह छोड़ दें। ग्राहक एजेंट तक केवल वेब पैनल के ज़रिए पहुँचते हैं। आप बाद में Settings से एक बॉट जोड़ सकते हैं।

स्टेप 3 — एजेंट कस्टमाइज़ेशन रिपॉज़िटरी

हर एजेंट को mintbot खुद एक मानक, बिना-ब्रांड वाले बेस पर डिप्लॉय करता है। उसके ऊपर अपना ब्रांड लगाने के लिए — पर्सोना, पैनल थीम, कॉपी, कोई भी अतिरिक्त टूलिंग — आप विज़ार्ड को एक एजेंट कस्टमाइज़ेशन रिपॉज़िटरी की ओर इंगित करते हैं: एक GitHub रिपॉज़िटरी जिसे एजेंट का अपना VPS मानक डिप्लॉय के बाद क्लोन करके चलाता है। लुक आप तय करते हैं; कोड आपका अपना होता है।

एजेंट कस्टमाइज़ेशन रिपॉज़िटरी कैसे काम करती है

रिपॉज़िटरी के रूट में दो स्क्रिप्ट होती हैं:

  • install.sh — एजेंट के VPS पर एक बार चलती है, मानक डिप्लॉय पूरा होने और एजेंट के स्वस्थ होने के बाद। यहीं आप अपनी कस्टमाइज़ेशन लागू करते हैं: थीम, पर्सोना में बदलाव, अतिरिक्त टूल, कोई भी क्लाइंट-विशिष्ट सेटअप।
  • update.sh — वैकल्पिक; हर बेस-पैकेज अपडेट के बाद चलती है, ताकि आप ताज़ा अपडेट किए गए बेस के ऊपर अपनी परत फिर से लगा सकें।

Mintbot आपकी रिपॉज़िटरी कभी नहीं चलाता — केवल एजेंट का अपना VPS, ग्राहक के अपने बॉक्स पर चलाता है। विज़ार्ड में अपनी रिपॉज़िटरी का GitHub HTTPS URL पेस्ट करें; इसे खाली छोड़ दें और आपको सादा बिना-ब्रांड वाला बेस मिल जाता है।

एक रिपॉज़िटरी बनाएँ जिसके रूट में एक install.sh (और वैकल्पिक update.sh) हो जो आपका CSS / स्ट्रिंग्स / पर्सोना लागू करे, फिर रिपॉज़िटरी का GitHub HTTPS URL पेस्ट करें। एजेंट का VPS इसे डिप्लॉय के बाद क्लोन करता है और बेस के ऊपर आपका ब्रांड लगाने के लिए आपकी स्क्रिप्ट चलाता है।

एक टूटी स्क्रिप्ट आपके ग्राहक के एजेंट को नहीं तोड़ सकती

आपकी स्क्रिप्ट फ़ेल-आइसोलेटेड हैं। अगर install.sh या update.sh गायब है, एरर देती है, या धीमी चलती है, तो भी डिप्लॉय सफल होता है, बेस-पैकेज अपडेट कभी ब्लॉक या रिवर्ट नहीं होता, और एजेंट स्वस्थ रहता है। विफलता एजेंट के अपने VPS पर लॉग होती है — अंतिम ग्राहक को यह कभी नहीं दिखती। टूटी स्क्रिप्ट का एकमात्र नुकसान यह है कि एजेंट आपकी ब्रांडेड परत के बजाय सादे बेस पर ही रह जाता है, इसलिए पहले अपनी रिपॉज़िटरी को किसी DEV डिप्लॉय पर टेस्ट करें।

सादी बिना-ब्रांड वाली बेस स्टाइलिंग और पर्सोना — कोई एजेंट कस्टमाइज़ेशन रिपॉज़िटरी नहीं। आप बाद में Settings से एक रिपॉज़िटरी URL जोड़ सकते हैं।

स्टेप 4 — API

Brand Partner API आपको डैशबोर्ड का उपयोग करने के बजाय अपने खुद के बैकएंड से एजेंट निर्माण ऑर्केस्ट्रेट करने देता है। विज़ार्ड डिफ़ॉल्ट रूप से API सेटअप छोड़ देता है — जब तक आप अभी इंटीग्रेट करने के लिए तैयार न हों, इसे बाद के लिए छोड़ दें।

जब आप तैयार हों:

  1. डैशबोर्ड से, Settings → API access खोलें।
  2. API key generate करें पर क्लिक करें। प्लेनटेक्स्ट केवल एक बार दिखाया जाता है — इसे अपने सीक्रेट मैनेजर में स्टोर करें।
  3. (वैकल्पिक) लाइफ़साइकल इवेंट प्राप्त करने के लिए एक webhook URL कॉन्फ़िगर करें।
  4. (वैकल्पिक) जब आपका रिसीवर हस्ताक्षर सत्यापित करने के लिए तैयार हो, तब एक webhook signing secret जनरेट करें।

पूरी एंडपॉइंट सूची और वेबहुक पेलोड आकृतियों के लिए Brand Partner API रेफ़रेंस देखें।

Webhook URL और signing secret वैकल्पिक हैं

बेचना शुरू करने के लिए इनमें से कोई भी ज़रूरी नहीं है — डैशबोर्ड और API इनके बिना भी ठीक काम करते हैं। वेबहुक तभी भेजे जाते हैं जब दोनों सेट हों: URL हो लेकिन signing secret न हो, तो कोई इवेंट नहीं भेजा जाता। X-Mintbot-Signature हेडर को आप इसी secret से सत्यापित करते हैं। दोनों को किसी भी समय Settings → API access से जोड़ा (या रोटेट किया) जा सकता है।

एक इंटीग्रेशन एजेंट को सेटअप खोजने दें

एक बार आपके पास API की हो जाने पर, एक एजेंट GET /api/v1/settings कॉल करके आपका पूरा गैर-गुप्त कॉन्फ़िगरेशन एक झटके में पढ़ सकता है — डोमेन, DNS प्रोवाइडर, बॉट, एजेंट कस्टमाइज़ेशन रिपॉज़िटरी, सबडोमेन पैटर्न, कीमत, तैयारी। कोई सीक्रेट कभी वापस नहीं आता (टोकन और कीज़ केवल *_set बूलियन के रूप में दिखती हैं), इसलिए की उस एजेंट के साथ साझा करना सुरक्षित है जो किसी ताज़ा सर्वर पर आपका व्हाइट-लेबल सेटअप इंस्टॉल कर रहा है।

बॉयलरप्लेट छोड़ें — रेफ़रेंस पोर्टल फ़ोर्क करें

एक पूर्ण, चलने योग्य उदाहरण स्टोरफ्रंट यहाँ उपलब्ध है: mintbot-ai/partner-portal-example। पूरे वॉकथ्रू के लिए नीचे रेफ़रेंस पोर्टल देखें।

स्टेप 5 — कीमत

विज़ार्ड का अंतिम चरण यह है कि आपके ग्राहक प्रति पैकेज क्या चुकाते हैं। MintOffice कीमत को दो मोड में बाँटता है — आप बाद में Settings → Pricing के तहत स्विच कर सकते हैं:

ग्राहक हर पैकेज के लिए mintbot की अनुशंसित कीमत देखते हैं। आप उस अनुशंसित कीमत और थोक फ़्लोर के बीच का पार्टनर मार्जिन कमाते हैं — शून्य सेटअप। अगर आप बस बेचना शुरू करना चाहते हैं तो इसे चुनें।

हर टियर के लिए हर ग्राहक जो कीमत चुकाता है, वह आप सेट करते हैं। थोक फ़्लोर से ऊपर का हर पैसा आप अपनी जेब में रखते हैं। जब आपके पास एक सुविचारित मार्कअप रणनीति हो तब इसे चुनें।

थोक फ़्लोर वह है जो mintbot प्रति ऑर्डर आपसे लेता है — यह वह न्यूनतम सीमा है जो आप वसूल सकते हैं। आपका पार्टनर हिस्सा प्रति ऑर्डर customer_price − wholesale_floor है। आपके जमा करने से पहले विज़ार्ड प्रति टियर गणना किए गए मार्जिन का पूर्वावलोकन दिखाता है।

कस्टम कीमत आंशिक हो सकती है

कस्टम मोड में भी आपको हर पैकेज की कीमत तय करने की ज़रूरत नहीं है — जिस पैकेज की कीमत आप तय नहीं करते, उस पर mintbot की डिफ़ॉल्ट कीमत लागू होती है, और API ऐसे ऑर्डर पर pricing_fallback: true का निशान लगाता है।

लाइव होना

विज़ार्ड के बाद, डैशबोर्ड एक बैनर दिखाता है जिसमें अभी भी छूटी हुई कोई भी ज़रूरी जानकारी सूचीबद्ध होती है। कौन-से फ़ील्ड ज़रूरी हैं, यह आपके चुने हुए विकल्पों पर निर्भर करता है:

  1. Telegram बॉट टोकन — अगर आप अपना खुद का बॉट इस्तेमाल करते हैं
  2. DNS API की (Zone.ee की + यूज़रनेम) — अगर आप अपना खुद का डोमेन इस्तेमाल करते हैं
  3. एपेक्स डोमेन — अगर आप अपना खुद का डोमेन इस्तेमाल करते हैं
  4. एजेंट कस्टमाइज़ेशन रिपॉज़िटरी URL — केवल तब, जब आपने स्टेप 3 में अपनी रिपॉज़िटरी चुनी हो; सादे बेस के साथ इसकी ज़रूरत नहीं।

एक बार ज़रूरी फ़ील्ड भर जाने और DNS प्रोवाइडर जाँच पास होने पर, डैशबोर्ड mintbot team की activation का इंतज़ार है दिखाता है। खुद दबाने के लिए कोई Go Live बटन नहीं है: mintbot टीम आपका अकाउंट सक्रिय करती है, जिससे आपका पार्टनर स्टेटस onboarding → live में बदल जाता है, और Brand Partner API ऑर्डर-निर्माण अनुरोध स्वीकार करने लगता है।

सक्रियण mintbot टीम करती है

आपका अकाउंट तब तक onboarding में रहता है जब तक mintbot टीम उसे सक्रिय न करे। ऑनबोर्डिंग के दौरान, API राइट्स को 403 partner_not_live के साथ अस्वीकार करता है (रीड्स खुले रहते हैं ताकि आप स्थिति का निरीक्षण कर सकें)। सक्रियण से पहले पक्का कर लें कि आपका डोमेन DNS, Zone.ee में सत्यापित है और (यदि आप किसी का उपयोग कर रहे हैं) आपने अपनी कस्टमाइज़ेशन रिपॉज़िटरी को किसी DEV डिप्लॉय पर टेस्ट कर लिया है।

सक्रियण के बाद: डोमेन + Telegram बॉट सेटिंग्स लॉक हो जाती हैं

एक बार आपका पार्टनर स्टेटस live हो जाने पर, Settings के Domain और Telegram bot सेक्शन रीड-ओनली हो जाते हैं। मौजूदा ग्राहक एजेंट पहले से ही आपके एपेक्स डोमेन की ओर इंगित होते हैं और आपके बॉट के ज़रिए चैट करते हैं — एक चुपचाप किया गया बदलाव उन्हें बीच जीवन में अनाथ कर देगा। बाकी सेक्शन संपादन योग्य रहते हैं:

सेक्शन live होने पर संपादन योग्य?
Domain / DNS / सबडोमेन पैटर्न नहीं — माइग्रेट करना हो तो सपोर्ट से संपर्क करें
Telegram bot नहीं — माइग्रेट करना हो तो सपोर्ट से संपर्क करें
एजेंट कस्टमाइज़ेशन रिपॉज़िटरी हाँ — नए एजेंट नए रिपॉज़िटरी URL को क्लोन करते हैं; मौजूदा एजेंट अपने अगले बेस अपडेट पर इसे update.sh के ज़रिए फिर से चलाते हैं
API की / webhook हाँ — किसी भी समय रोटेट करें
कीमत हाँ — भविष्य के ऑर्डर पर लागू होती है

यह लॉक UI में (फ़ील्डसेट निष्क्रिय, बैनर जो कारण समझाता है) और सर्वर पर दोनों जगह लागू किया जाता है (section=domain या section=bot के साथ /settings पर POST 403 लौटाते हैं)।

वेबहुक + पेआउट

  • वेबहुक डिलीवरी — हर लाइफ़साइकल इवेंट (ऑर्डर बनाया गया, भुगतान हुआ, एजेंट तैयार, विफल, एक्सपायर हुआ) उस webhook URL पर पोस्ट होता है जो आपने Settings में सेट किया है, और आपके webhook signing secret से साइन किया जाता है।
  • राजस्व खाता-बही — हर भुगतान किया गया ऑर्डर एक पंक्ति लिखता है जिसमें आपका सकल, आपका हिस्सा, और mintbot का हिस्सा होता है। डैशबोर्ड आजीवन कुल और अदत्त शेष दिखाता है।
  • पेआउट — जमा होते रहते हैं। mintbot टीम इन्हें पार्टनर समझौते के अनुसार मैन्युअल रूप से भुगतान करती है; डैशबोर्ड भुगतान बनाम अदत्त स्थिति ट्रैक करता है।

रेफ़रेंस पोर्टल

अगर आप शुरू से कोई स्टोरफ्रंट नहीं बनाना चाहते, तो आधिकारिक उदाहरण फ़ोर्क करें: mintbot-ai/partner-portal-example। यह MIT-लाइसेंस वाला FastAPI + SQLite + Docker है, एक काल्पनिक "ExampleAI" ब्रांडिंग के साथ आता है जिसे आप बदल सकते हैं, और पूरे लूप को एंड-टू-एंड कवर करता है:

  • प्लान कार्ड वाला लैंडिंग पेज,
  • /buy फ़ॉर्म → POST /api/v1/orders → Stripe चेकआउट रीडायरेक्ट,
  • थैंक-यू / कैंसल रिटर्न पेज,
  • HMAC हस्ताक्षर सत्यापक के साथ POST /webhooks/mintoffice,
  • HTTP-Basic-ऑथ वाला /admin इवेंट ब्राउज़र,
  • /healthz लाइवनेस प्रोब।

सेटअप वॉकथ्रू

  1. रिपॉज़िटरी फ़ोर्क करें ताकि आप अपने ब्रांडिंग बदलाव git में रख सकें:

    git clone https://github.com/mintbot-ai/partner-portal-example.git
cd partner-portal-example
cp .env.example .env

  2. .env भरें अपने MintOffice डैशबोर्ड के मानों से:

    वेरिएबल यहाँ क्या जाता है
    PARTNER_BRAND ग्राहक को दिखने वाला ब्रांड नाम (Stripe लाइन-आइटम लेबल के रूप में भी उपयोग होता है)।
    MINTOFFICE_API_URL लाइव के लिए https://mint.mintbot.ai, टेस्टिंग के लिए https://mint.mintbot.dev।
    MINTOFFICE_API_KEY Settings → API access से API की (फ़ॉर्मेट mo_live_…)।
    MINTOFFICE_WEBHOOK_SECRET उसी डैशबोर्ड में निर्माण के समय केवल एक बार दिखाया गया webhook signing secret।
    PUBLIC_BASE_URL वह HTTPS URL जिस पर आपका पोर्टल रहेगा (Stripe success_url / cancel_url बनाने के लिए उपयोग होता है)।
    ADMIN_USERNAME / ADMIN_PASSWORD /admin पर Basic-ऑथ गेट। एक लंबा यादृच्छिक पासवर्ड इस्तेमाल करें।

  3. इसे चलाएँ — Docker सबसे आसान रास्ता है; बेयर-मेटल भी काम करता है:

    docker compose up --build

    pip install -e .
uvicorn app.main:app --reload

  4. इसे HTTPS पर एक्सपोज़ करें — MintOffice, Stripe रीडायरेक्ट URL और webhook URL दोनों के लिए http:// को अस्वीकार करता है (प्राइवेट IP और localhost, SSRF गार्ड द्वारा ब्लॉक किए जाते हैं)। लोकल डेवलपमेंट के लिए, Cloudflare Tunnel, Tailscale Funnel, या ngrok इस्तेमाल करें। प्रोडक्शन के लिए, अपने खुद के होस्ट पर डिप्लॉय करें।

  5. अपनी पार्टनर पंक्ति को पोर्टल की ओर इंगित करें — वापस डैशबोर्ड में:

    • Webhook URL को https://<your-host>/webhooks/mintoffice पर सेट करें।
    • बस इतना ही। /buy से एक टेस्ट ऑर्डर दें, और इवेंट्स को /admin में आते हुए देखें।

रीब्रांडिंग

डिफ़ॉल्ट टेम्पलेट ExampleAI होने का दिखावा करते हैं। तीन स्पर्श-बिंदु:

  • .env में PARTNER_BRAND — Stripe, हेडर, फ़ुटर में प्रवाहित होता है।
  • app/templates/base.html — रंगों / एक्सेंट के लिए CSS वेरिएबल।
  • app/templates/*.html — कॉपी और प्रति-पेज लेआउट। अनुवाद (एस्टोनियन, स्पैनिश, …) इन्हीं फ़ाइलों के फ़ोर्क के रूप में रहते हैं।

अपने एजेंट के उसी VPS पर त्वरित डिप्लॉय

उदाहरण पोर्टल इतना छोटा है कि इसे आपके MintOffice डिप्लॉय एजेंट के साथ-साथ चलाया जा सकता है। अगर आपके पास पहले से कोई mintbot एजेंट VPS है, तो उससे कहें: "partner-portal-example को https://portal.<my-domain>/ के तहत एक webhook रिसीवर के रूप में डिप्लॉय करो, GET /api/v1/settings से MINTOFFICE_API_KEY और MINTOFFICE_WEBHOOK_SECRET भरो, और मेरी पार्टनर पंक्ति पर webhook URL सेट करो।" एजेंट के पास इसे एंड-टू-एंड करने के लिए डॉक्स और API की पथ मौजूद है।

Brand Partner API

प्रोग्रामेटिक एजेंट निर्माण, स्थिति पोलिंग, और वेबहुक इवेंट्स के लिए, Brand Partner API रेफ़रेंस देखें। व्यापक आर्किटेक्चर के लिए (आपका स्टोरफ्रंट, API, डिप्लॉय वर्कर, और हर ग्राहक का एजेंट VPS आपस में कैसे फ़िट होते हैं), देखें MintOffice — Technical।