پرش به محتویات

MintOffice

MintOffice پورتال Brand Partner برای mintbot.ai است. به شما امکان فروش مجدد را می‌دهد mintbot تحت نام تجاری خود: دامنه شما، ربات شما، لیست مشتریان شما - با mintbot استقرار مدیریت، ریل های صورت‌حساب، و زیرساخت هر عامل زیر کاپوت

پورتال شریک فعال در mint.mintbot.ai.

این راهنما شما را از «فقط درباره MintOffice شنیدم» به «اولین من» راهنمایی می‌کند عامل برچسب سفید در دامنه شخصی من فعال است." بخش های فنی (DNS رکوردها، GitHub مخزن، توکن ربات) به بهترین وجه توسط یک عامل mintbot از طرف شما مدیریت می‌شود - قبل از شروع به [بگذارید یک عامل شما را تنظیم کند] (#let-an-agent-set-you-up) را ببینید.

خودت یکپارچه سازی می کنی؟

برای طرف توسعه‌دهنده - کدام مخازن را دارید، چگونه استقرار جریان اجرا می‌شود انتها به انتها، و نحوه سفارشی سازی عامل مخزن + فروشگاه متناسب با هم - MintOffice - فنی را ببینید.

آنچه به دست می آورید

  • بسته‌های 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 (یا reception.mintbot.dev/mintoffice برای محیط dev/test) و پرداخت یکسان هر دو درگاه را باز می‌کند:

ردیف قیمت شامل چه چیزی
آزمایشی رایگان (پیش‌فرض برای هر شریک جدید) €0 10 DEV یکبار مصرف برای آزمایش پورتال + قالب
Brand Partner — راه‌اندازی تبلیغاتی €49 یکبار + €10/month 20 DEV استقرار (€1 اعتبار عامل هر کدام)، ماه اول مدیریت حساب شامل، وضعیت Brand Partner در هر دو mint.mintbot.ai + mint.mintbot.dev، راهنمای کامل راه‌اندازی (یک عامل می تواند کل جادوگر را برای شما هدایت کند)
Brand Partner — استاندارد €99 یکبار + €10/month همان راه‌اندازی — بدون تبلیغات

ثبت نام در مرحله بتا است

تسویه حساب Brand Partner در حال حاضر در محیط dev/test باز است (reception.mintbot.dev/mintoffice). تسویه حساب فعال .ai به زودی باز می‌شود.

** هزینه راه‌اندازی چه چیزی را پوشش می‌دهد:**

  • 20 DEV مستقر ، هر کدام یک آزمایش یکبار مصرف 24 ساعته VPS بذر با **€1 اعتبار عامل ** - برای اعمال پورتال و سفارشی سازی شما کافی است انتها به انتها قالب
  • اولین ماه مدیریت حساب شما (کارمزد €10/month در زیر) - بنابراین ماه یک قبلا پرداخت شده است.
  • وضعیت Brand Partner** در هر دو mint.mintbot.ai و mint.mintbot.dev.

هزینه مدیریت حساب €10/month:

از ماه دوم به بعد، حساب Brand Partner دارای یک €10/month است. کارمزد مدیریت حساب روانترین راه برای پرداخت آن یک **Stripe یا است PayPal اشتراک ** (توصیه می‌شود - خود را تجدید می‌کند). راه‌اندازی یکباره هزینه را می توان از طریق کارت یا رمزارز (BTC، XMR و بسیاری از سکه ها) نیز پرداخت کرد پرداخت CCP).

اگر کارمزد ماهانه تمام شود، حساب MintOffice شما به حالت مکث می‌رود: شما نمی‌توانید عوامل جدیدی را مستقر کنید، اما عامل‌ها مشتریان فعلی شما را حفظ می کنند در حال اجرا قبل از اینکه هر چیزی متوقف شود، تماس خواهیم گرفت تا بتوانید از سر بگیرید.

بعد از پرداخت چه اتفاقی می افتد:

  1. پذیرش پرداخت راه‌اندازی را در reception.mintbot.ai/mintoffice پردازش می‌کند (یا .dev اگر در محیط آزمایشی هستید) - کارت / Apple Pay / Google Pay یا رمزارز.
  2. پذیرش بلافاصله یک کمک هزینه امضا شده برای هر دو ارسال می‌کند mint.mintbot.ai و mint.mintbot.dev، ورق زدن حساب خود به وضعیت Brand Partner در هر دو پورتال.
  3. شما یک ایمیل خوش آمدگویی از pigeon@mintbot.ai (یا pigeon@mintbot.dev دریافت می‌کنید اگر در آزمون env خریداری کرده اید) که شامل پیوندهای ورود و الف است اشاره به این راهنما
  4. در هر پورتالی که می‌خواهید شروع کنید وارد شوید. اگر متقابل env فشار هر یک از پورتال ها را به دلایلی از دست داد، اولین ورود به سیستم در آن پورتال از پذیرش می‌پرسد "آیا این ایمیل پرداخت کرد؟" و کمک هزینه را در محل اعمال می‌کند.

تبلیغ راه‌اندازی به‌طور پیش‌فرض روشن است در حالی که ما در حال انتشار MintOffice هستیم. توسط پرچم سرور MINTOFFICE_SETUP_PROMO کنترل می‌شود، بنابراین قیمت در هنگام تسویه حساب می‌بینید که قیمتی است که می پردازید.

بازپرداخت

پنجره بازپرداخت 14 روزه، بدون سوال - اگر ردیف ارزش ندارد آن را برای مورد استفاده شما، ایمیل support@mintbot.ai کنید و ما آن را ارسال خواهیم کرد بازپرداخت

قیمت گذاری عمده فروشی به ازای هر عامل (نرخ mintbot برای هر کدام از شما هزینه دریافت می‌کند سفارش مشتری شما منت می‌کند) مستقل از هزینه راه‌اندازی است و در آن قرار دارد [مرحله 5 - قیمت گذاری] (#step-5-pricing) در زیر.

اجازه دهید یک عامل شما را تنظیم کند

بیشتر کارهای فنی — خرید دامنه، پیکربندی DNS، ایجاد یک Telegram ربات، جدا کردن مخزن قالب - مکانیکی است. شما می‌توانید آن را انجام دهید دست، اما هموارترین مسیر واگذاری آن به یک عامل mintbot است.

مسیر توصیه شده

یک [mintbot عامل] (https://mintbot.ai/) را بچرخانید و از آن بپرسید: "من را به عنوان یک شریک برند MintOffice تحت دامنه yourbrand.com تنظیم کنید - من را از طریق جادوگر سوار شدن راهنمایی کنید و همه چیزهایی را که دارید پر کنید می تواند از طرف من.»

عامل به ترمینال، مرورگر، اعتبار DNS API، GitHub و دانش این راهنما دقیقاً به شما می گوید که به کدام مرحله نیاز دارید مداخله (به عنوان مثال کلیک کردن روی تایید BotFather در Telegram) و بقیه را اداره کند

Hermes، یک OpenCode / نصب OpenClaw، حالت عامل مکان نما یا هر عامل کدنویسی دیگری کار می‌کند به همان اندازه خوب - این صفحه را به عنوان زمینه تغذیه کنید و هدف را به آن بگویید.

اگر ترجیح می‌دهید خودتان جادوگر را برانید، مراحل زیر دقیقاً همان چیزی است عامل انجام خواهد داد.

مرحله 0 - حساب کاربری خود را ایجاد کنید

  1. mint.mintbot.ai را باز کنید.
  2. آدرس ایمیلی را که می‌خواهید به عنوان ورود مدیر خود استفاده کنید تایپ کنید.
  3. روی برای من یک لینک ورود به سیستم ایمیل کنید کلیک کنید.
  4. ایمیل pigeon@mintbot.ai را باز کنید و روی پیوند جادویی کلیک کنید (اعتبار به مدت 24 ساعت، یکبار مصرف).

هیچ رمز عبور وجود ندارد — هر ورود بعدی پیوند جادویی دیگری است. این عمدی است: گذرواژه‌ها درز می‌کنند، پیوندهای جادویی اینطور نیست، و آنها آسان هستند برای اینکه یک عامل بعداً در صورت تنظیم دسترسی به ایمیل، خودکار را انجام دهد.

مرحله 1 - دامنه

اولین سوال جادوگر این است که کارگزاران شما کجا زندگی خواهند کرد. شما دوتا دارید انتخاب ها:

عامل‌ها در زیر دامنه های یک دامنه شما زندگی می کنند - به عنوان مثال. agent1.yourbrand.com، agent2.yourbrand.com، … این است تجربه برندی که مشتریان شما می بینند.

شما نیاز دارید:

  • دامنه Apex - یک دامنه ثبت شده و بدون سکونت (بدون https://، خیر زیر دامنه): yourbrand.com.
  • ارائه‌دهندهٔ DNS — Zone.ee تنها ارائه‌دهنده‌ای است که DNS را خودکار تنظیم می‌کند. در حالت دستی، رکورد A هر عامل را خودتان اضافه می‌کنید؛ پشتیبانی از Cloudflare به‌زودی می‌آید.
  • Zone.ee کلید API + نام کاربری — صادر شده از my.zone.eu → تنظیمات حساب → کلیدهای API → ایجاد کلید جدید . عامل از این برای ایجاد رکوردهای 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. @BotFather را در Telegram باز کنید.
  2. ارسال /newbot. به ربات یک نام نمایشی و یک نام کاربری بدهید (باید به bot ختم شود).
  3. BotFather یک توکن به شکل 123456789:AA… (حداقل 40) برمی گرداند شخصیت ها).
  4. آن توکن را در جادوگر قرار دهید.

[آموزش ربات] Telegram را ببینید (https://core.telegram.org/bots/tutorial) اگر نسخه طولانی تر را می‌خواهید

مشتریان با @mintbot_dev_bot چت می کنند. سریع برای یک نسخه آزمایشی، اما بدون مارک. قبل از راه‌اندازی به ربات خود تلنگر بزنید.

به طور کامل از Telegram بگذرید. مشتریان از طریق پنل وب به عامل‌ها دسترسی دارند فقط بعداً می‌توانید یک ربات را از تنظیمات اضافه کنید.

مرحله 3 - مخزن سفارشی سازی عامل

هر عامل بر روی یک پایه استاندارد و بدون نام تجاری توسط خود mintbot مستقر می‌شود. به برند خود را در راس قرار دهید - پرسونا، تم پنل، کپی، هر ابزار اضافی - شما جادوگر را به سمت مخزن سفارشی سازی عامل می گیرید: یک مخزن GitHub که VPS خود عامل کلون می‌شود و پس از استقرار استاندارد اجرا می‌شود. شما تصمیم بگیرید نگاه؛ شما صاحب کد هستید

چگونه مخزن سفارشی سازی عامل کار می‌کند

ریشه مخزن شامل دو اسکریپت است:

  • install.sh — یک بار روی VPS عامل اجرا می‌شود، بعد از استقرار استاندارد به پایان رسیده است و عامل سالم است. اینجاست که شما سفارشی سازی خود را اعمال می کنید: تم، ترفندهای شخصیت، ابزارهای اضافی، هر کدام راه‌اندازی خاص مشتری
  • update.sh - اختیاری؛ **بعد از هر به‌روزرسانی بسته پایه اجرا می‌شود، بنابراین می‌توانید لایه خود را دوباره در بالای پایه تازه به روز شده اعمال کنید.

Mintbot هرگز مخزن شما را اجرا نمی‌کند - فقط VPS خود عامل این کار را بر روی جعبه خود مشتری GitHub HTTPS URL مخزن خود را در جادوگر قرار دهید. آن را خالی بگذارید و پایه ساده بدون مارک را دریافت می کنید.

یک مخزن با install.sh (و اختیاری update.sh) در آن ایجاد کنید ریشه ای که CSS / رشته ها / پرسونای شما را اعمال می‌کند، سپس مخزن را Paste کنید GitHub HTTPS URL. VPS عامل پس از استقرار آن را شبیه سازی می‌کند و شما را اجرا می‌کند اسکریپت هایی برای لایه گذاری نام تجاری خود در بالای پایه.

یک اسکریپت شکسته نمی تواند عامل مشتری شما را خراب کند

اسکریپت‌های شما از خرابی جدا نگه داشته می‌شوند. اگر install.sh یا update.sh وجود نداشته باشد، خطا بدهد یا کند اجرا شود، استقرار باز هم موفق است، به‌روزرسانی بستهٔ پایه هرگز مسدود یا برگردانده نمی‌شود و عامل سالم می‌ماند. خطا روی VPS خودِ عامل ثبت می‌شود — مشتری نهایی هرگز آن را نمی‌بیند. تنها پیامد یک اسکریپت خراب این است که عامل به‌جای لایهٔ برندشدهٔ شما روی پایهٔ ساده می‌ماند؛ پس مخزن خود را ابتدا روی یک استقرار DEV آزمایش کنید.

استایل و شخصیت پایه بدون مارک ساده - بدون مخزن سفارشی سازی عامل. شما می‌توانید یک مخزن URL بعداً از تنظیمات اضافه کنید.

مرحله 4 - API

Brand Partner API به شما این امکان را می‌دهد که ایجاد عامل را از خودتان هماهنگ کنید. باطن به جای استفاده از داشبورد. جادوگر از تنظیم API میگذرد پیش فرض - آن را برای بعداً بگذارید مگر اینکه اکنون آماده ادغام باشید.

وقتی آماده شدید:

  1. از داشبورد، تنظیمات → دسترسی API را باز کنید.
  2. روی کلید API را ایجاد کنید کلیک کنید. متن ساده یک بار نشان داده می‌شود - آن را در مدیر مخفی خود ذخیره کنید.
  3. (اختیاری) یک webhook URL را برای دریافت رویدادهای چرخه حیات پیکربندی کنید.
  4. (اختیاری) یک راز امضای قلاب وب پس از دریافت کننده خود ایجاد کنید آماده تایید امضاها است.

برای اطلاعات کامل به Brand Partner API مرجع مراجعه کنید لیست endpoint و شکل های بارگذاری وب هوک.

Webhook URL و امضای مخفی اختیاری هستند

هیچ‌کدام برای شروع فروش لازم نیست — داشبورد و API بدون آن‌ها هم به‌خوبی کار می‌کنند. وب‌هوک‌ها فقط وقتی ارسال می‌شوند که هر دو تنظیم شده باشند: اگر URL باشد ولی راز امضا نباشد، هیچ رویدادی فرستاده نمی‌شود. سرآیند X-Mintbot-Signature را با همین راز تأیید می‌کنید. هر دو را می‌توان هر زمان از تنظیمات → دسترسی API اضافه کرد (یا تعویض کرد).

اجازه دهید یک عامل ادغام تنظیمات را کشف کند

هنگامی که یک کلید API داشته باشید، یک عامل می تواند تماس بگیرد GET /api/v1/settings برای خواندن خود پیکربندی کامل غیر مخفی در یک عکس - دامنه، ارائه‌دهنده DNS، ربات، مخزن سفارشی سازی عامل، الگوی زیر دامنه، قیمت گذاری، آمادگی. هیچ رازی هرگز وجود ندارد برگردانده شد (توکن ها و کلیدها فقط به صورت *_set بولی ظاهر می‌شوند)، بنابراین کلید به اشتراک گذاری با عاملی که برچسب سفید شما را نصب می‌کند بی خطر است راه‌اندازی روی سرور تازه

پرش از دیگ بخار - انشعاب پورتال مرجع

یک نمونه کامل و قابل اجرا در ویترین فروشگاه قرار دارد mintbot-ai/partner-portal-example. برای اطلاعات کامل به پورتال مرجع در زیر مراجعه کنید قدم زدن

مرحله 5 - قیمت گذاری

آخرین مرحله جادوگر مبلغی است که مشتریان شما برای هر بسته پرداخت می کنند. MintOffice قیمت‌ها را به دو حالت تقوصل می‌کند - می‌توانید بعداً در زیر تغییر دهید تنظیمات → قیمت گذاری:

مشتریان برای هر بسته قیمت پیشنهادی مینت‌بات را می‌بینند. حاشیهٔ سود شریک شما تفاوت این قیمت پیشنهادی با کف قیمت عمده‌فروشی است — بدون هیچ تنظیمی. اگر فقط می‌خواهید فروش را شروع کنید، این گزینه را انتخاب کنید.

شما قیمتی را که هر مشتری برای هر طبقه می پردازد تعیین می کنید. تو جیب هر سنت بالاتر از طبقه عمده فروشی. این را انتخاب کنید زمانی که شما یک استراتژی نشانه گذاری عمدی

زمینه عمده فروشی چیزی است که mintbot برای هر سفارش از شما* هزینه می‌گیرد — این حداقل مطلقی که می‌توانید شارژ کنید برش شریک شماست customer_price − wholesale_floor در هر سفارش. جادوگر پیش نمایش قبل از ارسال، حاشیه های محاسبه شده در هر ردیف.

قیمت سفارشی می تواند جزئی باشد

حتی در حالت سفارشی لازم نیست برای همهٔ بسته‌ها قیمت بگذارید — بسته‌ای که برایش قیمت نگذارید، قیمت پیش‌فرض مینت‌بات را می‌گیرد و API چنین سفارش‌هایی را با pricing_fallback: true علامت می‌زند.

پخش فعال

پس از راهنمای راه‌اندازی، داشبورد بنری نشان می‌دهد که اطلاعات الزامیِ هنوز واردنشده را فهرست می‌کند. این‌که کدام فیلدها الزامی‌اند به گزینه‌هایی بستگی دارد که انتخاب کرده‌اید:

  1. توکن ربات Telegram — اگر از ربات خودتان استفاده می‌کنید
  2. کلید API برای DNS (کلید Zone.ee + نام کاربری) — اگر از دامنهٔ خودتان استفاده می‌کنید
  3. دامنهٔ اصلی (Apex) — اگر از دامنهٔ خودتان استفاده می‌کنید
  4. URL مخزن سفارشی‌سازی عامل — فقط اگر در مرحلهٔ ۳ مخزن خودتان را انتخاب کرده‌اید؛ با پایهٔ ساده لازم نیست.

وقتی فیلدهای الزامی پر شد و بررسی ارائه‌دهندهٔ DNS موفق بود، داشبورد پیام در انتظار فعال‌سازی توسط تیم mintbot را نشان می‌دهد. دکمهٔ Go Live برای فشار دادن توسط خودتان وجود ندارد: تیم mintbot حساب شما را فعال می‌کند، که وضعیت شریک شما را از onboarding به live تغییر می‌دهد و Brand Partner API پذیرش درخواست‌های ایجاد سفارش را آغاز می‌کند.

فعال‌سازی را تیم mintbot انجام می‌دهد

حساب شما تا زمانی که تیم mintbot آن را فعال کند در وضعیت onboarding می‌ماند. در این مدت API درخواست‌های نوشتن را با خطای 403 partner_not_live رد می‌کند (خواندن باز می‌ماند تا بتوانید وضعیت را بررسی کنید). پیش از فعال‌سازی مطمئن شوید DNS دامنهٔ شما در Zone.ee تأیید شده و (اگر از مخزن سفارشی‌سازی استفاده می‌کنید) آن را روی یک استقرار DEV آزمایش کرده‌اید.

پس از فعال‌سازی: تنظیمات دامنه و ربات Telegram قفل می‌شوند

وقتی وضعیت شریک شما live شد، دامنه و Telegram بخش‌های bot تنظیمات فقط خواندنی می‌شوند. عامل‌ها مشتری موجود در حال حاضر به دامنه apex خود اشاره کرده و از طریق ربات خود چت کنید - a تغییر خاموش آنها را در اواسط عمر یتیم می‌کند. بخش های دیگر باقی می مانند قابل ویرایش:

بخش قابل ویرایش در live؟
دامنه / DNS / الگوی زیر دامنه نه — در صورت نیاز به مهاجرت با پشتیبانی تماس بگیرید
Telegram ربات نه — در صورت نیاز به مهاجرت با پشتیبانی تماس بگیرید
مخزن سفارشی سازی عامل بله - عوامل جدید مخزن جدید URL را شبیه سازی می کنند. عوامل موجود آن را از طریق update.sh در به‌روزرسانی پایه بعدی خود دوباره اجرا می کنند
کلید API / webhook بله — چرخش در هر زمان
قیمت گذاری بله — برای سفارشات آتی اعمال می‌شود

قفل هر دو در رابط کاربری (فیلد مجموعه غیرفعال، بنر) اجرا می‌شود توضیح دادن چرا) و روی سرور (پست هایی برای /settings با section=domain یا section=bot 403 را برگرداند.

وب هوک ها + پرداخت ها

  • ارسال وب‌هوک‌ها — هر رویداد چرخهٔ عمر (ایجاد سفارش، پرداخت، آماده‌شدن عامل، شکست، انقضا) به URL وب‌هوکی که در تنظیمات تعیین کرده‌اید ارسال می‌شود و با راز امضای وب‌هوک شما امضا می‌شود.
  • **دفتر درآمد ** - هر سفارش پرداخت شده یک ردیف با ناخالص شما می نویسد، برش شما، و برش mintbot است. کل طول عمر سطح داشبورد و موجودی پرداخت نشده
  • پرداخت - جمع آوری. تیم mintbot آنها را به صورت دستی پرداخت می‌کند هر قرارداد شریک؛ داشبورد وضعیت پرداخت شده در مقابل عدم پرداخت را ردیابی می‌کند.

پورتال مرجع

اگر نمی‌خواهید از ابتدا یک ویترین بسازید، مقامات رسمی را کنار بگذارید مثال: mintbot-ai/partner-portal-example. FastAPI + SQLite + Docker دارای مجوز MIT است، با یک داستان تخیلی ارسال می‌شود نام تجاری "ExampleAI" را می‌توانید جایگزین کنید و حلقه کامل را از انتها به انتها پوشش می‌دهد:

  • صفحه فرود با کارت های طرح،
  • /buy فرم → POST /api/v1/orders → Stripe تغییر مسیر پرداخت،
  • با تشکر از شما / لغو صفحات بازگشت،
  • POST /webhooks/mintoffice با HMAC تایید کننده امضا،
  • مرورگر رویداد HTTP-Basic-auth /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 کلید API از تنظیمات → دسترسی API (قالب mo_live_…).
    MINTOFFICE_WEBHOOK_SECRET راز امضای Webhook یک بار در هنگام ایجاد در همان داشبورد نشان داده شد.
    PUBLIC_BASE_URL HTTPS URL پورتال شما فعال خواهد بود (برای ساخت Stripe success_url / cancel_url استفاده می‌شود).
    ADMIN_USERNAME / ADMIN_PASSWORD دروازه اعتبار پایه در /admin. از یک رمز عبور تصادفی طولانی استفاده کنید.

  3. اجرا کنید - Docker ساده ترین مسیر است. فلز برهنه نیز کار می‌کند:

    docker compose up --build

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

  4. آن را در HTTPS نمایش دهید — MintOffice http:// را برای هر دو Stripe رد می‌کند تغییر مسیر URLs و وبکهک URL (IP خصوصی و localhost هستند توسط گارد SSRF مسدود شده است). برای توسعه محلی، از Cloudflare استفاده کنید تونل، Tailscale Funnel یا ngrok. برای تولید، به خود مستقر کنید میزبان خود

  5. ** ردیف شریک خود را در پورتال قرار دهید ** - در داشبورد:

    • Webhook URL را روی https://<your-host>/webhooks/mintoffice تنظیم کنید.
    • همین است. از /buy سفارش آزمایشی بدهید و رویدادها را تماشا کنید رسیدن در /admin.

تغییر نام تجاری

الگوهای پیش‌فرض وانمود می‌کنند که ExampleAI هستند. سه نقطه تماس:

  • PARTNER_BRAND در .env — به Stripe، سرصفحه ها، پاورقی ها جریان می یابد.
  • app/templates/base.html - متغیرهای CSS برای رنگ ها / لهجه.
  • app/templates/*.html - کپی و طرح بندی در هر صفحه. ترجمه ها (استونی، اسپانیایی، ...) به عنوان چنگال این فایل‌ها زندگی می کنند.

استقرار سریع در همان VPS با عوامل شما

پورتال نمونه به اندازه کافی کوچک است که در کنار MintOffice شما اجرا شود عامل استقرار اگر قبلاً یک عامل mintbot VPS دارید، از آن بپرسید: "Part-portal-example را به عنوان یک گیرنده وب هوک در زیر مستقر کنید https://portal.<my-domain>/، MINTOFFICE_API_KEY را پر کنید و MINTOFFICE_WEBHOOK_SECRET از GET /api/v1/settings، و تنظیم کنید webhook URL در ردیف شریک من." عامل اسناد و API را دارد مسیر کلیدی برای انجام این کار انتها به انتها.

Brand Partner API

برای ایجاد عامل برنامه‌ای، نظرسنجی وضعیت، و رویدادهای وب هوک، Brand Partner API مرجع را ببینید. برای معماری گسترده تر (چگونه ویترین فروشگاه شما، API، کارگر مستقر، و عامل هر مشتری VPS با هم مناسب است)، ببینید MintOffice — فنی.