MintOffice¶

MintOffice হলো mintbot.ai-এর Brand Partner পোর্টাল। এটি আপনাকে নিজের ব্র্যান্ডের অধীনে mintbot পুনরায় বিক্রি করার সুযোগ দেয়: আপনার ডোমেইন, আপনার বট, আপনার ক্লায়েন্ট তালিকা — আর পর্দার আড়ালে ডিপ্লয়মেন্ট, বিলিং রেল এবং প্রতি-এজেন্ট পরিকাঠামো সামলায় mintbot নিজেই।

লাইভ পার্টনার পোর্টালটি এখানে রয়েছে: mint.mintbot.ai।

এই গাইডটি আপনাকে "সবেমাত্র MintOffice-এর কথা শুনলাম" থেকে "আমার প্রথম হোয়াইট-লেবেল এজেন্ট আমার নিজের ডোমেইনে লাইভ হয়েছে" পর্যন্ত নিয়ে যাবে। প্রযুক্তিগত অংশগুলো (DNS রেকর্ড, GitHub রিপো, বট টোকেন) আপনার হয়ে একটি mintbot এজেন্টের মাধ্যমে সামলানোই সবচেয়ে সহজ — শুরু করার আগে একটি এজেন্টকে দিয়ে সেটআপ করিয়ে নিন দেখুন।

ইন্টিগ্রেশনটি নিজেই তৈরি করছেন?

ডেভেলপার-মুখী দিকটি সম্পর্কে জানতে — কোন রিপোজিটরিগুলো আপনার, ডিপ্লয় ফ্লো কীভাবে শুরু থেকে শেষ পর্যন্ত চলে, এবং এজেন্ট কাস্টমাইজেশন রিপো + স্টোরফ্রন্ট কীভাবে একসাথে কাজ করে — দেখুন MintOffice — টেকনিক্যাল।

আপনি যা পাচ্ছেন¶

প্রতিটি mintbot প্যাকেজ (Trial, Starter, Pro, Max) আপনার নিজের ডোমেইনের অধীনে পুনরায় বিক্রি করুন — আপনার গ্রাহকরা *.mintbot.ai নয়, দেখেন agent1.yourbrand.com।
চ্যাট ট্রাফিকের জন্য আপনার নিজের Telegram বট (@yourbrand_bot) ব্যবহার করুন, অথবা পরীক্ষা চলাকালীন mintbot-এর বট ধার নিন।
আপনার গ্রাহক-মুখী মূল্য নিজে বেছে নিন এবং আপনি গ্রাহকদের কাছ থেকে যা নেন আর mintbot আপনার কাছ থেকে যা নেয় (MintOffice হোলসেল ফ্লোর) — এই দুইয়ের ব্যবধানটুকু পকেটে রাখুন।
প্রোগ্রামেটিকভাবে অর্ডার তৈরি, লাইফসাইকেল স্ট্যাটাস এবং আপনার নিজের সিস্টেমে ওয়েবহুক ফেরত পাঠানোর জন্য একটি Brand Partner API।
সক্রিয় গ্রাহক অর্ডার, বট-লিঙ্ক স্বাস্থ্য, মূল্য, পেআউট এবং ওয়েবহুক ডেলিভারি দেখানো একটি ড্যাশবোর্ড।

মূল্য — Brand Partner সেটআপ ফি¶

একটি ফ্রি ট্রায়াল পোর্টাল অ্যাকাউন্টের জন্য সাইন আপ করা — ঠিকই ধরেছেন — বিনামূল্যে। কিন্তু Brand Partner সাইনআপই হলো সেই একটিমাত্র পেমেন্ট যা এটিকে একটি প্রকৃত ব্র্যান্ড-পার্টনার অ্যাকাউন্টে রূপান্তরিত করে। আপনি এককালীন সেটআপ ফি পরিশোধ করেন reception.mintbot.ai/mintoffice-এ (অথবা ডেভ/টেস্ট এনভায়রনমেন্টের জন্য reception.mintbot.dev/mintoffice) এবং একই পেমেন্ট দুটি পোর্টালই আনলক করে দেয়:

টিয়ার	মূল্য	যা অন্তর্ভুক্ত
ফ্রি ট্রায়াল (প্রতিটি নতুন পার্টনারের জন্য ডিফল্ট)	€0	আপনার পোর্টাল + টেমপ্লেট পরীক্ষার জন্য ১০টি ডিসপোজেবল DEV ডিপ্লয়
Brand Partner — লঞ্চ প্রোমো	€49 এককালীন + €10/মাস	২০টি DEV ডিপ্লয় (প্রতিটিতে €1 এজেন্ট ক্রেডিট), অ্যাকাউন্ট ম্যানেজমেন্টের প্রথম মাস অন্তর্ভুক্ত, `mint.mintbot.ai` + `mint.mintbot.dev` উভয়ে Brand Partner স্ট্যাটাস, বিস্তারিত সেটআপ গাইড (একটি এজেন্ট আপনার হয়ে পুরো উইজার্ডটি চালাতে পারে)
Brand Partner — স্ট্যান্ডার্ড	€99 এককালীন + €10/মাস	লঞ্চের মতোই — কেবল প্রোমো ছাড়া

সাইনআপ বিটায় রয়েছে

Brand Partner চেকআউট বর্তমানে ডেভ/টেস্ট এনভায়রনমেন্টে চালু আছে (reception.mintbot.dev/mintoffice)। লাইভ .ai চেকআউট শীঘ্রই খুলবে।

সেটআপ ফি যা কভার করে:

২০টি DEV ডিপ্লয়, প্রতিটি একটি ২৪-ঘণ্টার ডিসপোজেবল টেস্ট VPS যাতে €1 এজেন্ট ক্রেডিট বীজ হিসেবে দেওয়া থাকে — আপনার পোর্টাল ও কাস্টমাইজেশন টেমপ্লেট শুরু থেকে শেষ পর্যন্ত যাচাই করার জন্য যথেষ্ট।
আপনার অ্যাকাউন্ট ম্যানেজমেন্টের প্রথম মাস (নিচের €10/মাস ফি) — অর্থাৎ প্রথম মাসের অর্থ ইতিমধ্যেই পরিশোধিত।
mint.mintbot.ai এবং mint.mintbot.dev উভয়ে Brand Partner স্ট্যাটাস।

€10/মাস অ্যাকাউন্ট-ম্যানেজমেন্ট ফি:

দ্বিতীয় মাস থেকে শুরু করে, Brand Partner অ্যাকাউন্টে একটি €10/মাস অ্যাকাউন্ট-ম্যানেজমেন্ট ফি যুক্ত হয়। এটি পরিশোধের সবচেয়ে মসৃণ উপায় হলো একটি Stripe বা PayPal সাবস্ক্রিপশন (প্রস্তাবিত — এটি নিজে থেকেই নবায়ন হয়); এককালীন সেটআপ ফি কার্ড বা ক্রিপ্টো (CCPayment-এর মাধ্যমে BTC, XMR এবং আরও অনেক কয়েন) দিয়েও পরিশোধ করা যায়।

মাসিক ফি যদি বকেয়া হয়ে যায়, আপনার MintOffice অ্যাকাউন্ট paused অবস্থায় চলে যায়: আপনি নতুন এজেন্ট ডিপ্লয় করতে পারবেন না, তবে আপনার বিদ্যমান গ্রাহক এজেন্টগুলো চলতে থাকে। কিছু বন্ধ হওয়ার আগে আমরা আপনার সাথে যোগাযোগ করব যাতে আপনি পুনরায় চালু করতে পারেন।

পেমেন্টের পর যা ঘটে:

Reception reception.mintbot.ai/mintoffice-এ সেটআপ পেমেন্ট প্রক্রিয়া করে (অথবা টেস্ট এনভায়রনমেন্টে থাকলে .dev) — কার্ড / Apple Pay / Google Pay, অথবা ক্রিপ্টো।
Reception সঙ্গে সঙ্গে mint.mintbot.ai এবং mint.mintbot.dev উভয়ের কাছে একটি সাইনড গ্রান্ট পাঠায়, যা দুটি পোর্টালেই আপনার অ্যাকাউন্টকে Brand Partner স্ট্যাটাসে পরিবর্তন করে।
আপনি pigeon@mintbot.ai থেকে একটি ওয়েলকাম ইমেইল পান (অথবা টেস্ট এনভায়রনমেন্টে কিনে থাকলে pigeon@mintbot.dev থেকে), যাতে দুটি সাইনইন লিঙ্ক এবং এই গাইডের একটি পয়েন্টার থাকে।
আপনি যে পোর্টাল দিয়ে শুরু করতে চান সেখানে সাইন ইন করুন। কোনো কারণে যদি ক্রস-এনভায়রনমেন্ট পুশ কোনো একটি পোর্টালে পৌঁছাতে ব্যর্থ হয়, তবে সেই পোর্টালে প্রথম সাইনইনের সময় reception-কে জিজ্ঞাসা করা হয় "এই ইমেইল কি অর্থ পরিশোধ করেছে?" এবং তখনই গ্রান্টটি প্রয়োগ করা হয়।

আমরা যখন MintOffice চালু করছি ততক্ষণ পর্যন্ত লঞ্চ প্রোমো ডিফল্টভাবে সক্রিয়; এটি MINTOFFICE_SETUP_PROMO সার্ভার ফ্ল্যাগ দ্বারা নিয়ন্ত্রিত, তাই চেকআউটে আপনি যে মূল্য দেখেন সেটিই আপনি পরিশোধ করবেন।

রিফান্ড

১৪-দিনের রিফান্ড উইন্ডো, কোনো প্রশ্ন ছাড়াই — যদি টিয়ারটি আপনার ব্যবহারের ক্ষেত্রে যথাযথ না হয়, support@mintbot.ai-এ ইমেইল করুন আর আমরা ফি ফেরত পাঠিয়ে দেব।

হোলসেল প্রতি-এজেন্ট মূল্য (আপনি যে প্রতিটি গ্রাহক অর্ডার তৈরি করেন তার জন্য mintbot আপনার কাছ থেকে যে হার নেয়) সেটআপ ফি থেকে স্বাধীন এবং নিচের ধাপ ৫ — মূল্য-তে রয়েছে।

একটি এজেন্টকে দিয়ে সেটআপ করিয়ে নিন¶

বেশিরভাগ প্রযুক্তিগত কাজ — একটি ডোমেইন কেনা, DNS কনফিগার করা, একটি Telegram বট তৈরি করা, টেমপ্লেট রিপো ফর্ক করা — যান্ত্রিক। আপনি এগুলো হাতে করতে পারেন, তবে সবচেয়ে মসৃণ পথ হলো একটি mintbot এজেন্টের কাছে এটি অর্পণ করা।

প্রস্তাবিত পথ

একটি mintbot এজেন্ট চালু করুন এবং এটিকে জিজ্ঞাসা করুন: "আমাকে yourbrand.com ডোমেইনের অধীনে একজন MintOffice ব্র্যান্ড পার্টনার হিসেবে সেটআপ করো — অনবোর্ডিং উইজার্ডে আমাকে ধাপে ধাপে নিয়ে চলো এবং আমার হয়ে যা যা পারো পূরণ করে দাও।"

এজেন্টের কাছে একটি টার্মিনাল, একটি ব্রাউজার, একটি DNS API, GitHub auth এবং এই গাইডের জ্ঞান রয়েছে। কোন ধাপে আপনার হস্তক্ষেপ প্রয়োজন (যেমন Telegram-এ BotFather-এর নিশ্চিতকরণে ক্লিক করা) তা এটি আপনাকে সঠিকভাবে জানাবে এবং বাকি কাজ সামলে নেবে।

আপনার নিজের Hermes, একটি OpenCode / OpenClaw ইনস্টল, Cursor এজেন্ট মোড, অথবা অন্য যেকোনো কোডিং এজেন্টও সমানভাবে ভালো কাজ করে — এই পৃষ্ঠাটি কনটেক্সট হিসেবে দিন এবং লক্ষ্যটি জানিয়ে দিন।

আপনি যদি বরং নিজেই উইজার্ডটি চালাতে চান, নিচের ধাপগুলো হুবহু সেটাই যা এজেন্ট করত।

ধাপ ০ — আপনার অ্যাকাউন্ট তৈরি করুন¶

mint.mintbot.ai খুলুন।
আপনার অপারেটর লগইন হিসেবে যে ইমেইল ঠিকানা ব্যবহার করতে চান সেটি টাইপ করুন।
Send me a sign-in link ক্লিক করুন।
pigeon@mintbot.ai থেকে আসা ইমেইলটি খুলুন এবং ম্যাজিক লিঙ্কে ক্লিক করুন (২৪ ঘণ্টার জন্য বৈধ, একবার ব্যবহারযোগ্য)।

এখানে কোনো পাসওয়ার্ড নেই — পরবর্তী প্রতিটি লগইন আরেকটি ম্যাজিক লিঙ্ক। এটি ইচ্ছাকৃত: পাসওয়ার্ড ফাঁস হয়, ম্যাজিক লিঙ্ক হয় না, আর আপনি যদি ইমেইল অ্যাক্সেস সেটআপ করেন তবে পরে এগুলো একটি এজেন্টের পক্ষে স্বয়ংক্রিয় করা সহজ।

ধাপ ১ — ডোমেইন¶

উইজার্ডের প্রথম প্রশ্ন হলো আপনার এজেন্টগুলো কোথায় থাকবে। আপনার দুটি পছন্দ আছে:

আমার নিজের ডোমেইন ব্যবহার করুন (প্রস্তাবিত)mintbot.ai সাবডোমেইন ব্যবহার করুন

এজেন্টরা আপনার মালিকানাধীন একটি ডোমেইনের সাবডোমেইনে থাকে — যেমন agent1.yourbrand.com, agent2.yourbrand.com, … এটি আপনার গ্রাহকরা যে ব্র্যান্ডেড অভিজ্ঞতা দেখেন।

আপনার যা প্রয়োজন হবে:

এপেক্স ডোমেইন — একটি রেজিস্টার্ড, খালি ডোমেইন (https:// নেই, সাবডোমেইন নেই): yourbrand.com।
DNS প্রোভাইডার — বর্তমানে কেবল Zone.ee-এর একটি কার্যকর ব্যাকএন্ড আছে। Cloudflare এবং ম্যানুয়াল মোড রোডম্যাপে রয়েছে।
Zone.ee API key + ইউজারনেম — 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-এ আপনার ব্র্যান্ড থাকে না। যাচাই করে দেখার জন্য কাজে লাগে; গ্রাহক-মুখী লঞ্চের আগে আপনার নিজের ডোমেইনে স্যুইচ করে নিন।

ধাপ ২ — বট¶

প্রতিটি এজেন্ট একটি চ্যাট সারফেস পায়। ডিফল্টগুলো Telegram ধরে নেয় — Discord এবং Slack স্ক্যাফোল্ড করা আছে কিন্তু এখনো সংযুক্ত করা হয়নি।

আমার নিজের Telegram বট আনুন (প্রস্তাবিত)mintbot-এর বট ধার নিনএখনো কোনো বট নেই

আপনার গ্রাহকরা @yourbrand_bot-এর সাথে চ্যাট করেন, যা ব্র্যান্ড অক্ষুণ্ণ রাখে।

Telegram-এ @BotFather খুলুন।
/newbot পাঠান। বটটিকে একটি ডিসপ্লে নাম এবং একটি ইউজারনেম দিন (অবশ্যই bot দিয়ে শেষ হতে হবে)।
BotFather 123456789:AA… আকারের একটি টোকেন ফেরত দেয় (কমপক্ষে ৪০ অক্ষর)।
সেই টোকেনটি উইজার্ডে পেস্ট করুন।

দীর্ঘতর সংস্করণটি চাইলে Telegram-এর বট টিউটোরিয়াল দেখুন।

গ্রাহকরা @mintbot_dev_bot-এর সাথে চ্যাট করেন। একটি ডেমোর জন্য দ্রুত, তবে আনব্র্যান্ডেড। লঞ্চের আগে আপনার নিজের বটে পরিবর্তন করুন।

Telegram সম্পূর্ণরূপে এড়িয়ে যান। গ্রাহকরা কেবল ওয়েব প্যানেলের মাধ্যমে এজেন্ট অ্যাক্সেস করেন। আপনি পরে Settings থেকে একটি বট যোগ করতে পারেন।

ধাপ ৩ — এজেন্ট কাস্টমাইজেশন রিপো¶

প্রতিটি এজেন্ট 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 যোগ করতে পারেন।

ধাপ ৪ — API¶

Brand Partner API আপনাকে ড্যাশবোর্ড ব্যবহার না করে আপনার নিজের ব্যাকএন্ড থেকে এজেন্ট তৈরি অর্কেস্ট্রেট করতে দেয়। উইজার্ড ডিফল্টভাবে API সেটআপ এড়িয়ে যায় — আপনি এখনই ইন্টিগ্রেট করতে প্রস্তুত না হলে এটি পরের জন্য রেখে দিন।

আপনি যখন প্রস্তুত:

ড্যাশবোর্ড থেকে Settings → API access খুলুন।
Generate key ক্লিক করুন। প্লেইনটেক্সটটি একবারই দেখানো হয় — এটি আপনার সিক্রেট ম্যানেজারে সংরক্ষণ করুন।
(ঐচ্ছিক) লাইফসাইকেল ইভেন্ট পেতে একটি webhook URL কনফিগার করুন।
(ঐচ্ছিক) আপনার রিসিভার সিগনেচার যাচাই করতে প্রস্তুত হলে একটি webhook signing secret তৈরি করুন।

সম্পূর্ণ এন্ডপয়েন্ট তালিকা এবং ওয়েবহুক পেলোড আকারের জন্য Brand Partner API রেফারেন্স দেখুন।

Webhook URL এবং signing secret ঐচ্ছিক

বিক্রি শুরু করতে কোনোটিই প্রয়োজন নেই — ড্যাশবোর্ড এবং API এগুলো ছাড়াই ভালোভাবে কাজ করে। যতক্ষণ না আপনার একটি রিসিভার https://<your-host>/...-এর দিকে নির্দেশ করা থাকে ততক্ষণ webhook URL ফিল্ডটি খালি থাকে; signing secret কেবল তখনই কাজে লাগে যখন আপনি সেই URL সেট করেছেন এবং X-Mintbot-Signature হেডার যাচাই করতে চান। দুটিই যেকোনো সময় Settings → API access থেকে যোগ (বা রোটেট) করা যায়।

একটি ইন্টিগ্রেশন এজেন্টকে সেটআপ আবিষ্কার করতে দিন

একবার আপনার কাছে একটি API key থাকলে, একটি এজেন্ট GET /api/v1/settings কল করে আপনার সম্পূর্ণ নন-সিক্রেট কনফিগারেশন এক ধাক্কায় পড়তে পারে — ডোমেইন, DNS প্রোভাইডার, বট, এজেন্ট কাস্টমাইজেশন রিপো, সাবডোমেইন প্যাটার্ন, মূল্য, প্রস্তুতি। কোনো সিক্রেট কখনো ফেরত দেওয়া হয় না (টোকেন এবং কী কেবল *_set বুলিয়ান হিসেবে প্রকাশ পায়), তাই একটি নতুন সার্ভারে আপনার হোয়াইট-লেবেল সেটআপ ইনস্টল করছে এমন এজেন্টের সাথে কী-টি শেয়ার করা নিরাপদ।

বয়লারপ্লেট এড়িয়ে যান — রেফারেন্স পোর্টাল ফর্ক করুন

একটি সম্পূর্ণ, চালানো-যোগ্য উদাহরণ স্টোরফ্রন্ট এখানে রয়েছে: mintbot-ai/partner-portal-example। সম্পূর্ণ ওয়াকথ্রুর জন্য নিচের রেফারেন্স পোর্টাল দেখুন।

ধাপ ৫ — মূল্য¶

শেষ উইজার্ড ধাপটি হলো আপনার গ্রাহকরা প্রতি প্যাকেজে কত পরিশোধ করবেন। MintOffice মূল্যকে দুটি মোডে ভাগ করে — আপনি পরে Settings → Pricing-এ এটি পরিবর্তন করতে পারেন:

ডিফল্ট মূল্য ব্যবহার করুন (প্রস্তাবিত)প্রতি টিয়ারে কাস্টম মূল্য সেট করুন

গ্রাহকরা প্রতি টিয়ারে (Trial, Starter, Pro, Max) mintbot-এর প্রস্তাবিত মূল্য দেখেন। সেই প্রস্তাবিত মূল্য এবং হোলসেল ফ্লোরের মধ্যে আপনি পার্টনার মার্জিন পান — কোনো সেটআপ নেই। আপনি যদি কেবল বিক্রি শুরু করতে চান তবে এটি বেছে নিন।

প্রতিটি গ্রাহক প্রতি টিয়ারে যে মূল্য পরিশোধ করবেন তা আপনি সেট করেন। হোলসেল ফ্লোরের উপরে প্রতিটি পয়সা আপনি পকেটে রাখেন। যখন আপনার একটি ইচ্ছাকৃত মার্কআপ কৌশল থাকে তখন এটি বেছে নিন।

হোলসেল ফ্লোর হলো প্রতি অর্ডারে mintbot আপনার কাছ থেকে যা নেয় — এটি আপনি যত কম নিতে পারেন তার সম্পূর্ণ ন্যূনতম। আপনার পার্টনার কাট প্রতি অর্ডারে customer_price − wholesale_floor। সাবমিট করার আগে উইজার্ড প্রতি টিয়ারে গণনাকৃত মার্জিন প্রিভিউ করে।

কাস্টম মূল্য আংশিক হতে পারে

এমনকি কাস্টম মোডেও আপনাকে প্রতিটি টিয়ার ওভাররাইড করতে হবে না — একটি টিয়ারকে ডিফল্টে রেখে দিন আর এটি mintbot-এর প্রস্তাবিত মূল্য উত্তরাধিকারসূত্রে পায়। আপনি যেগুলো নিয়ে চিন্তিত কেবল সেগুলোই সম্পাদনা করুন।

লাইভে যাওয়া¶

উইজার্ডের পর, ড্যাশবোর্ড এখনো অনুপস্থিত যেকোনো প্রয়োজনীয় তথ্যের তালিকা সহ একটি ব্যানার দেখায়। তিনটি প্রয়োজনীয় ফিল্ড হলো:

Telegram বট টোকেন (অথবা অন্য একটি বট প্রোভাইডার)
DNS API key (যেমন Zone.ee key + ইউজারনেম)
এপেক্স ডোমেইন

এজেন্ট কাস্টমাইজেশন রিপো URL ঐচ্ছিক — এটি খালি রাখলে আপনার এজেন্টরা প্লেইন আনব্র্যান্ডেড বেসে ডিপ্লয় হয়।

প্রয়োজনীয় ফিল্ডগুলো পূরণ হয়ে গেলে এবং DNS প্রোভাইডার চেক পাস হলে, Go Live বোতামটি সক্রিয় হয়। এটি ক্লিক করলে আপনার পার্টনার স্ট্যাটাস onboarding → live-এ পরিবর্তিত হয়, এবং Brand Partner API অর্ডার-তৈরির অনুরোধ গ্রহণ করা শুরু করে।

অ্যাক্টিভেশন একটি একমুখী হ্যান্ডশেক

আপনি Go Live ক্লিক না করা পর্যন্ত আপনার অ্যাকাউন্ট onboarding-এ থাকে। onboarding চলাকালীন, API রাইট অনুরোধগুলো 403 দিয়ে প্রত্যাখ্যান করে (রিড খোলা থাকে যাতে আপনি স্টেট পরিদর্শন করতে পারেন)। Zone.ee-তে আপনার ডোমেইন DNS যাচাই না হওয়া পর্যন্ত এবং (যদি ব্যবহার করেন) একটি DEV ডিপ্লয়ে আপনার কাস্টমাইজেশন রিপো পরীক্ষা না করা পর্যন্ত অ্যাক্টিভেট করবেন না।

Go Live-এর পর: ডোমেইন + Telegram বট সেটিংস লক হয়ে যায়

একবার আপনার পার্টনার স্ট্যাটাস live হলে, Settings-এর Domain এবং Telegram bot বিভাগগুলো রিড-অনলি হয়ে যায়। বিদ্যমান গ্রাহক এজেন্টরা ইতিমধ্যেই আপনার এপেক্স ডোমেইনের দিকে নির্দেশ করছে এবং আপনার বটের মাধ্যমে চ্যাট করছে — একটি নীরব পরিবর্তন তাদের মাঝপথে অনাথ করে ফেলবে। অন্য বিভাগগুলো সম্পাদনাযোগ্য থাকে:

বিভাগ	`live` অবস্থায় সম্পাদনাযোগ্য?
Domain / DNS / সাবডোমেইন প্যাটার্ন	না — মাইগ্রেট করার প্রয়োজন হলে সাপোর্টে যোগাযোগ করুন
Telegram bot	না — মাইগ্রেট করার প্রয়োজন হলে সাপোর্টে যোগাযোগ করুন
এজেন্ট কাস্টমাইজেশন রিপো	হ্যাঁ — নতুন এজেন্টরা নতুন রিপো URL ক্লোন করে; বিদ্যমান এজেন্টরা তাদের পরবর্তী বেস আপডেটে `update.sh`-এর মাধ্যমে এটি পুনরায় চালায়
API key / webhook	হ্যাঁ — যেকোনো সময় রোটেট করুন
মূল্য	হ্যাঁ — ভবিষ্যৎ অর্ডারে প্রযোজ্য

লকটি UI-তে (ফিল্ডসেট নিষ্ক্রিয়, কারণ ব্যাখ্যা করা ব্যানার) এবং সার্ভারে উভয়েই প্রয়োগ করা হয় (section=domain বা section=bot সহ /settings-এ POST 403 ফেরত দেয়)।

ওয়েবহুক + পেআউট¶

Webhook ডেলিভারি — প্রতিটি লাইফসাইকেল ইভেন্ট (অর্ডার তৈরি, অ্যাক্টিভেটেড, মেয়াদোত্তীর্ণ) আপনি Settings-এ সেট করা webhook URL-এ পোস্ট করে। ড্যাশবোর্ডের প্রতি-পার্টনার Webhook health চিপ গত ২৪ ঘণ্টায় ডেলিভারি সফলতার হার দেখায়।
রেভিনিউ লেজার — প্রতিটি পরিশোধিত অর্ডার আপনার গ্রস, আপনার কাট এবং mintbot-এর কাট সহ একটি সারি লেখে। ড্যাশবোর্ড আজীবন মোট এবং অপরিশোধিত ব্যালেন্স প্রকাশ করে।
পেআউট — জমা হয়। mintbot টিম পার্টনার চুক্তি অনুযায়ী এগুলো ম্যানুয়ালি পরিশোধ করে; ড্যাশবোর্ড পরিশোধিত বনাম অপরিশোধিত স্ট্যাটাস ট্র্যাক করে।

রেফারেন্স পোর্টাল¶

আপনি যদি শুরু থেকে একটি স্টোরফ্রন্ট তৈরি করতে না চান, অফিসিয়াল উদাহরণটি ফর্ক করুন: mintbot-ai/partner-portal-example। এটি MIT-লাইসেন্সড FastAPI + SQLite + Docker, একটি কাল্পনিক "AcmeAI" ব্র্যান্ডিং সহ আসে যা আপনি বদলে ফেলতে পারেন, এবং সম্পূর্ণ লুপটি শুরু থেকে শেষ পর্যন্ত কভার করে:

প্ল্যান কার্ড সহ ল্যান্ডিং পেজ,
/buy ফর্ম → POST /api/v1/orders → Stripe চেকআউট রিডাইরেক্ট,
ধন্যবাদ / বাতিল রিটার্ন পেজ,
HMAC সিগনেচার ভেরিফায়ার সহ POST /webhooks/mintoffice,
HTTP-Basic-auth /admin ইভেন্ট ব্রাউজার,
/healthz লাইভনেস প্রোব।

সেটআপ ওয়াকথ্রু¶

রিপোটি ফর্ক করুন যাতে আপনি আপনার ব্র্যান্ডিং পরিবর্তনগুলো git-এ রাখতে পারেন:
```
git clone https://github.com/mintbot-ai/partner-portal-example.git
cd partner-portal-example
cp .env.example .env
```

আপনার MintOffice ড্যাশবোর্ডের মান দিয়ে .env পূরণ করুন:

ভেরিয়েবল	এখানে যা যায়
`PARTNER_BRAND`	গ্রাহক-দৃশ্যমান ব্র্যান্ড নাম (Stripe লাইন-আইটেম লেবেল হিসেবেও ব্যবহৃত)।
`MINTOFFICE_API_URL`	লাইভের জন্য `https://mint.mintbot.ai`, পরীক্ষার জন্য `https://mint.mintbot.dev`।
`MINTOFFICE_API_KEY`	Settings → API access থেকে API key (ফরম্যাট `mo_live_…`)।
`MINTOFFICE_WEBHOOK_SECRET`	একই ড্যাশবোর্ডে তৈরির সময় একবার দেখানো webhook signing secret।
`PUBLIC_BASE_URL`	আপনার পোর্টাল যে HTTPS URL-এ থাকবে (Stripe `success_url` / `cancel_url` তৈরি করতে ব্যবহৃত)।
`ADMIN_USERNAME` / `ADMIN_PASSWORD`	`/admin`-এ Basic-auth গেট। একটি দীর্ঘ র‍্যান্ডম পাসওয়ার্ড ব্যবহার করুন।

এটি চালান — Docker সবচেয়ে সহজ পথ; বেয়ার-মেটালও কাজ করে:
Dockerলোকাল Python
docker compose up --build
pip install -e . uvicorn app.main:app --reload
এটি HTTPS-এ এক্সপোজ করুন — MintOffice Stripe রিডাইরেক্ট URL এবং webhook URL উভয়ের জন্যই http:// প্রত্যাখ্যান করে (প্রাইভেট IP এবং localhost SSRF গার্ড দ্বারা ব্লক করা হয়)। লোকাল ডেভেলপমেন্টের জন্য, Cloudflare Tunnel, Tailscale Funnel, বা ngrok ব্যবহার করুন। প্রোডাকশনের জন্য, আপনার নিজের হোস্টে ডিপ্লয় করুন।
আপনার পার্টনার সারিটি পোর্টালের দিকে নির্দেশ করুন — ড্যাশবোর্ডে ফিরে গিয়ে:
- Webhook URL সেট করুন https://<your-host>/webhooks/mintoffice-এ।
- ব্যাস। /buy থেকে একটি টেস্ট অর্ডার দিন, এবং /admin-এ ইভেন্টগুলো আসতে দেখুন।

রিব্র্যান্ডিং¶

ডিফল্ট টেমপ্লেটগুলো AcmeAI হওয়ার ভান করে। তিনটি টাচ-পয়েন্ট:

.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 key পাথ রয়েছে।

Brand Partner API¶

প্রোগ্রামেটিক এজেন্ট তৈরি, স্ট্যাটাস পোলিং এবং ওয়েবহুক ইভেন্টের জন্য, Brand Partner API রেফারেন্স দেখুন। বৃহত্তর আর্কিটেকচারের জন্য (আপনার স্টোরফ্রন্ট, API, ডিপ্লয় ওয়ার্কার এবং প্রতিটি গ্রাহকের এজেন্ট VPS কীভাবে একসাথে কাজ করে), দেখুন MintOffice — টেকনিক্যাল।