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

MintOffice

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

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

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

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

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

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

  • فروش مجدد هر بسته mintbot (آزمایشی، استارتر، حرفه ای، حداکثر) زیر ** خودتان ** دامنه — مشتریان شما 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 دارای باطن کار حالت‌های 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. روی تولید کلید کلیک کنید. متن ساده یک بار نشان داده می‌شود - آن را در مدیر مخفی خود ذخیره کنید.
  3. (اختیاری) یک webhook URL را برای دریافت رویدادهای چرخه حیات پیکربندی کنید.
  4. (اختیاری) یک راز امضای قلاب وب پس از دریافت کننده خود ایجاد کنید آماده تایید امضاها است.

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

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

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

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

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

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

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

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

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

مشتریان قیمت توصیه شده mintbot را در هر ردیف می بینند (آزمایشی، شروع، حرفه ای، مکس). شما حاشیه شریک را بین توصیه شده ایجاد می کنید قیمت و طبقه عمده فروشی - نصب صفر. اگر فقط این را انتخاب کنید می‌خواهید شروع به فروش کنید

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

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

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

حتی در حالت سفارشی، لازم نیست همه سطوح را نادیده بگیرید - ترک کنید یک ردیف در حالت پیش فرض است و قیمت توصیه شده mintbot را به ارث می برد. فقط مواردی را که برایتان مهم است ویرایش کنید.

پخش فعال

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

  1. Telegram نشانه ربات (یا ارائه‌دهنده ربات دیگر)
  2. **DNS کلید API ** (به عنوان مثال کلید Zone.ee + نام کاربری)
  3. دامنه Apex

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

هنگامی که فیلدهای مورد نیاز پر شد و چک ارائه‌دهنده DNS عبور کرد، دکمه Go Live فعال می‌شود. با کلیک کردن بر روی آن وضعیت شریک شما از صفحه نمایش داده می‌شود onboarding → live، و Brand Partner API شروع به پذیرش می‌کند درخواست های ایجاد سفارش

فعال سازی یک دست دادن یک طرفه است

حساب شما در onboarding باقی می‌ماند تا زمانی که روی Go Live کلیک کنید. در حالی که در هنگام ورود، API رد می‌کند با 403 می‌نویسد (بخواند باز بماند تا شما می تواند حالت را بازرسی کند). تا زمانی که دامنه DNS شما تأیید نشده است، آن را فعال نکنید در Zone.ee و (اگر از یکی استفاده می کنید) سفارشی سازی خود را آزمایش کرده اید مخزن در استقرار DEV.

After Go Live: دامنه + قفل تنظیمات ربات Telegram

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

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

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

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

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

پورتال مرجع

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

  • صفحه فرود با کارت های طرح،
  • /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.

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

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

  • 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 — فنی.