Pāriet uz saturu

MintOffice

MintOffice ir mintbot.ai Brand Partner portāls. Tas ļauj tev pārdot mintbot tālāk ar savu zīmolu: tavs domēns, tavs bots, tavs klientu saraksts — turklāt mintbot zem pārsega rūpējas par izvietošanu, maksājumu infrastruktūru un katra aģenta serveri.

Aktīvais partneru portāls atrodas vietnē mint.mintbot.ai.

Šis ceļvedis izved tevi no „tikko uzzināju par MintOffice“ līdz „mans pirmais white-label aģents darbojas manā domēnā“. Tehniskās daļas (DNS ieraksti, GitHub repozitorijs, bota tokens) vislabāk uzticēt mintbot aģentam, kas tās paveic tavā vietā — pirms sāc, skati sadaļu Ļauj aģentam tevi iestatīt.

Veido integrāciju pats?

Izstrādātāja pusi — kuri repozitoriji pieder tev, kā izvietošanas plūsma darbojas no sākuma līdz beigām un kā aģenta pielāgojumu repozitorijs un veikals sader kopā — skati lapā MintOffice — tehniskā daļa.

Ko tu iegūsti

  • Pārdod tālāk katru mintbot paketi (Trial, Starter, Pro, Max) savā domēnā — tavi klienti redz agent1.yourbrand.com, nevis *.mintbot.ai.
  • Izmanto savu Telegram botu (@yourbrand_bot) tērzēšanas plūsmai vai aizņemies mintbot botu, kamēr vēl testē.
  • Nosaki paša klientiem redzamās cenas un paturi starpību starp to, ko iekasē no klienta, un to, ko mintbot iekasē no tevis (MintOffice vairumtirdzniecības zemākā robeža).
  • Brand Partner API programmatiskai pasūtījumu izveidei, dzīvescikla statusam un webhookiem atpakaļ uz tavām sistēmām.
  • Vadības panelis, kas rāda aktīvos klientu pasūtījumus, bota savienojuma stāvokli, cenas, izmaksas un webhooku piegādi.

Cenas — Brand Partner iestatīšanas maksa

Reģistrēties bezmaksas izmēģinājuma portāla kontam ir, protams, bez maksas — bet Brand Partner reģistrācija ir vienīgais maksājums, kas to pārvērš par īstu Brand Partner kontu. Vienreizējo iestatīšanas maksu samaksā vietnē reception.mintbot.ai/mintoffice (vai reception.mintbot.dev/mintoffice izstrādes/testa vidē), un viens un tas pats maksājums atver abus portālus:

Līmenis Cena Kas iekļauts
Bezmaksas izmēģinājums (noklusējums katram jaunam partnerim) €0 10 vienreizlietojami DEV izvietojumi tava portāla un veidnes testēšanai
Brand Partner — atklāšanas akcija €49 vienreiz + €10/mēnesī 20 DEV izvietojumi (€1 aģenta kredīts katrā), pirmais konta pārvaldības mēnesis iekļauts, Brand Partner statuss gan mint.mintbot.ai, gan mint.mintbot.dev, izsmeļošs iestatīšanas ceļvedis (aģents var izvest visu vedni tavā vietā)
Brand Partner — standarta €99 vienreiz + €10/mēnesī Tas pats, kas akcijā — tikai bez atlaides

Reģistrācija ir beta versijā

Brand Partner apmaksa pašlaik ir atvērta izstrādes/testa vidē (reception.mintbot.dev/mintoffice). Apmaksa aktīvajā .ai vidē tiks atvērta drīzumā.

Ko sedz iestatīšanas maksa:

  • 20 DEV izvietojumi — katrs ir vienreizlietojams 24 stundu testa VPS ar €1 aģenta kredītu — pietiekami, lai izmēģinātu savu portālu un pielāgojumu veidni no sākuma līdz beigām.
  • Tavs pirmais mēnesis konta pārvaldībā (tālāk aprakstītā €10/mēnesī maksa) — tātad pirmais mēnesis jau ir apmaksāts.
  • Brand Partner statuss gan mint.mintbot.ai, gan mint.mintbot.dev.

€10/mēnesī konta pārvaldības maksa:

Sākot ar otro mēnesi, Brand Partner kontam tiek piemērota €10/mēnesī konta pārvaldības maksa. Ērtāk to maksāt ar Stripe vai PayPal abonementu (ieteicams — tas atjaunojas pats); vienreizējo iestatīšanas maksu var samaksāt arī ar karti vai kriptovalūtu (BTC, XMR un daudzas citas monētas caur CCPayment).

Ja ikmēneša maksa netiek samaksāta, tavs MintOffice konts pāriet stāvoklī paused: jaunus aģentus izvietot nevari, bet esošie klientu aģenti turpina darboties. Pirms kaut kas tiek apturēts, mēs sazināsimies, lai vari darbību atjaunot.

Kas notiek pēc apmaksas:

  1. Reception apstrādā iestatīšanas maksājumu vietnē reception.mintbot.ai/mintoffice (vai .dev, ja esi testa vidē) — karte / Apple Pay / Google Pay vai kriptovalūta.
  2. Reception nekavējoties nosūta parakstītu piešķīrumu gan uz mint.mintbot.ai, gan mint.mintbot.dev, pārslēdzot tavu kontu uz Brand Partner statusu abos portālos.
  3. Tu saņem sveiciena e-pastu no pigeon@mintbot.ai (vai pigeon@mintbot.dev, ja pirki testa vidē) ar abām pieteikšanās saitēm un norādi uz šo ceļvedi.
  4. Piesakies tajā portālā, ar kuru vēlies sākt. Ja starpvides paziņojums kāda iemesla dēļ kādu portālu izlaida, pirmā pieteikšanās tajā portālā pajautā Reception „vai šis e-pasts ir samaksājis?“ un piemēro piešķīrumu uzreiz.

Atklāšanas akcija pēc noklusējuma ir ieslēgta, kamēr MintOffice tiek izvērsts; to kontrolē servera karodziņš MINTOFFICE_SETUP_PROMO, tāpēc cena, ko redzi apmaksas brīdī, ir cena, ko maksāsi.

Atmaksa

14 dienu atmaksas periods bez jautājumiem — ja līmenis tavam lietojumam neatmaksājas, raksti uz support@mintbot.ai, un mēs maksu atgriezīsim.

Vairumtirdzniecības cena par aģentu (likme, ko mintbot iekasē no tevis par katru tevis izveidoto klienta pasūtījumu) nav atkarīga no iestatīšanas maksas un ir aprakstīta tālāk sadaļā 5. solis — Cenas.

Ļauj aģentam tevi iestatīt

Lielākā daļa tehniskā darba — domēna iegāde, DNS konfigurēšana, Telegram bota izveide, veidnes repozitorija forkošana — ir mehāniska. Vari to izdarīt ar roku, bet vienkāršākais ceļš ir uzticēt to mintbot aģentam.

Ieteicamais ceļš

Palaid mintbot aģentu un palūdz tam: „Iestati mani kā MintOffice Brand Partner domēnam yourbrand.com — izved mani cauri ievadīšanas vednim un aizpildi manā vietā visu, ko vari.“

Aģentam ir piekļuve terminālim, pārlūkam, DNS API, GitHub autentifikācijai un šim ceļvedim. Tas precīzi pateiks, kurā solī vajadzīga tava iejaukšanās (piemēram, BotFather apstiprinājums Telegram), un pārējo izdarīs pats.

Tikpat labi der tava paša Hermes, OpenCode / OpenClaw instalācija, Cursor aģenta režīms vai jebkurš cits kodēšanas aģents — iedod tam šo lapu kā kontekstu un pasaki mērķi.

Ja vedni labprātāk izej pats, tālāk aprakstītie soļi ir tieši tie, ko darītu aģents.

0. solis — Izveido kontu

  1. Atver mint.mintbot.ai.
  2. Ievadi e-pasta adresi, ko vēlies izmantot operatora pieteikšanās vajadzībām.
  3. Klikšķini Send me a sign-in link.
  4. Atver e-pastu no pigeon@mintbot.ai un klikšķini uz maģiskās saites (derīga 24 h, vienreizlietojama).

Paroles nav — katra nākamā pieteikšanās ir jauna maģiskā saite. Tas ir apzināti: paroles noplūst, maģiskās saites ne, un aģentam tās vēlāk ir viegli automatizēt, ja iestatīsi tam piekļuvi e-pastam.

1. solis — Domēns

Vedņa pirmais jautājums ir kur tavi aģenti dzīvos. Ir divas iespējas:

Aģenti dzīvo tev piederoša domēna apakšdomēnos — piem., agent1.yourbrand.com, agent2.yourbrand.com, … Tā ir zīmolotā pieredze, ko redz tavi klienti.

Tev būs vajadzīgs:

  • Apex domēns — reģistrēts pamatdomēns (bez https://, bez apakšdomēna): yourbrand.com.
  • DNS nodrošinātājs — pašlaik strādājoša aizmugursistēma ir tikai Zone.ee. Cloudflare un manuālais režīms ir plānoti.
  • Zone.ee API atslēga + lietotājvārds — izsniedz my.zone.eu → Account settings → API keys → Create new key. Aģents to izmanto, lai automātiski izveidotu A ierakstus, kad tu sagatavo jaunu aģentu.

Apakšdomēnu numerācijas stils

  • Teksta priedēklis + numurs (noklusējums) — agent1.yourbrand.com, agent2.yourbrand.com, … Vislabāk lasāms.
  • Tikai skaitlis — 1.yourbrand.com, 2.yourbrand.com, … Īss.
  • Skaitlis ar nullēm priekšā — 001.yourbrand.com, … Nemainīgs platums.

Izvēle ir tīri kosmētiska — izvietošanas procesam der visi trīs.

Aģenti dzīvo *.mintbot.ai — bez iestatīšanas, bez DNS, bet URL nenes tavu zīmolu. Noder izmēģināšanai; pirms palaišanas klientiem pārej uz savu domēnu.

2. solis — Bots

Katram aģentam ir tērzēšanas kanāls. Noklusējumi pieņem Telegram — Discord un Slack ir sagatavoti, bet vēl nav pieslēgti.

Tavi klienti tērzē ar @yourbrand_bot, un zīmols paliek neskarts.

  1. Atver @BotFather Telegram.
  2. Nosūti /newbot. Iedod botam attēlojamo vārdu un lietotājvārdu (jābeidzas ar bot).
  3. BotFather atgriež tokenu formā 123456789:AA… (vismaz 40 rakstzīmes).
  4. Ielīmē šo tokenu vednī.

Ja vēlies garāku versiju, skati Telegram botu pamācību.

Klienti tērzē ar @mintbot_dev_bot. Ātri demonstrācijai, bet bez zīmola. Pirms palaišanas pārslēdzies uz savu botu.

Izlaid Telegram pavisam. Klienti aģentiem piekļūst tikai caur tīmekļa paneli. Botu vari pievienot vēlāk sadaļā Settings.

3. solis — Aģenta pielāgojumu repozitorijs

Katru aģentu uz standarta bāzes bez zīmola izvieto pats mintbot. Lai uzliktu savu zīmolu virsū — personu, paneļa tēmu, tekstus, jebkurus papildu rīkus — tu norādi vednim aģenta pielāgojumu repozitoriju: GitHub repozitoriju, ko aģenta paša VPS klonē un palaiž pēc standarta izvietošanas. Tu nosaki izskatu; kods pieder tev.

Kā darbojas aģenta pielāgojumu repozitorijs

Repozitorija saknē ir divi skripti:

  • install.sh — tiek palaists vienreiz aģenta VPS pēc tam, kad standarta izvietošana ir pabeigta un aģents ir darba kārtībā. Tieši šeit tu piemēro savus pielāgojumus: tēmu, personas izmaiņas, papildu rīkus, jebkuru klientam specifisku iestatījumu.
  • update.sh — neobligāts; tiek palaists pēc katra bāzes paketes atjauninājuma, lai tu varētu no jauna uzlikt savu slāni virs tikko atjauninātās bāzes.

Mintbot tavu repozitoriju nekad nepalaiž — to dara tikai aģenta paša VPS, uz klienta paša servera. Ielīmē vednī sava repozitorija GitHub HTTPS URL; atstāj tukšu — un dabū vienkāršo bāzi bez zīmola.

Izveido repozitoriju, kura saknē ir install.sh (un neobligāts update.sh), kas piemēro tavu CSS / tekstus / personu, un ielīmē repozitorija GitHub HTTPS URL. Aģenta VPS to klonē pēc izvietošanas un palaiž tavus skriptus, lai virs bāzes uzliktu tavu zīmolu.

Bojāts skripts nevar sabojāt tava klienta aģentu

Tavi skripti ir izolēti no kļūdām. Ja install.sh vai update.sh trūkst, beidzas ar kļūdu vai darbojas lēni, izvietošana tik un tā izdodas, bāzes paketes atjauninājums nekad netiek bloķēts vai atcelts, un aģents paliek darba kārtībā. Kļūme tiek reģistrēta VPS un parādīta tev — nekad gala klientam. Bojāta skripta vienīgais mīnuss ir tas, ka aģents paliek uz vienkāršās bāzes, nevis tava zīmola slāņa, tāpēc vispirms pārbaudi repozitoriju DEV izvietojumā.

Vienkāršs noformējums un persona bez zīmola — bez aģenta pielāgojumu repozitorija. Repozitorija URL vari pievienot vēlāk sadaļā Settings.

4. solis — API

Brand Partner API ļauj tev vadīt aģentu izveidi no savas aizmugursistēmas, nevis caur vadības paneli. Vednis pēc noklusējuma API iestatīšanu izlaiž — atstāj to vēlākam, ja vien neesi gatavs integrēt jau tagad.

Kad esi gatavs:

  1. Vadības panelī atver Settings → API access.
  2. Klikšķini Generate key. Atslēga atklātā tekstā tiek parādīta tikai vienreiz — saglabā to savā noslēpumu pārvaldniekā.
  3. (Neobligāti) Norādi webhook URL, lai saņemtu dzīvescikla notikumus.
  4. (Neobligāti) Ģenerē webhooka parakstīšanas noslēpumu, tiklīdz tavs saņēmējs ir gatavs pārbaudīt parakstus.

Pilnu galapunktu sarakstu un webhooku payload struktūras skati Brand Partner API aprakstā.

Webhook URL un parakstīšanas noslēpums ir neobligāti

Neviens no tiem nav vajadzīgs, lai sāktu pārdot — vadības panelis un API lieliski darbojas arī bez tiem. Webhook URL lauks paliek tukšs, līdz tev ir saņēmējs adresē https://<your-host>/...; parakstīšanas noslēpums noder tikai tad, kad šis URL ir iestatīts un vēlies pārbaudīt galveni X-Mintbot-Signature. Abus var pievienot (vai rotēt) jebkurā brīdī sadaļā Settings → API access.

Ļauj integrācijas aģentam pašam noskaidrot iestatījumus

Tiklīdz tev ir API atslēga, aģents var izsaukt GET /api/v1/settings, lai vienā piegājienā nolasītu visu tavu nesekrēto konfigurāciju — domēnu, DNS nodrošinātāju, botu, aģenta pielāgojumu repozitoriju, apakšdomēnu šablonu, cenas, gatavību. Neviens noslēpums netiek atgriezts (tokeni un atslēgas parādās tikai kā *_set būla vērtības), tāpēc atslēgu ir droši dot aģentam, kas instalē tavu white-label iestatījumu uz jauna servera.

Izlaid melnrakstu — forko atsauces portālu

Pilnīgs, palaižams veikala piemērs atrodas repozitorijā mintbot-ai/partner-portal-example. Pilnu pamācību skati tālāk sadaļā Atsauces portāls.

5. solis — Cenas

Vedņa pēdējais solis ir tas, ko tavi klienti maksā par paketi. MintOffice cenām ir divi režīmi — vēlāk tos vari pārslēgt sadaļā Settings → Pricing:

Klienti redz mintbot ieteikto cenu katram līmenim (Trial, Starter, Pro, Max). Tu nopelni partnera maržu starp šo ieteikto cenu un vairumtirdzniecības zemāko robežu — bez jebkādas iestatīšanas. Izvēlies šo, ja vienkārši gribi sākt pārdot.

Tu pats nosaki cenu, ko klients maksā par katru līmeni. Tu paturi katru centu virs vairumtirdzniecības zemākās robežas. Izvēlies šo, kad tev ir apzināta uzcenojuma stratēģija.

Vairumtirdzniecības zemākā robeža ir tas, ko mintbot iekasē no tevis par pasūtījumu — absolūti zemākā cena, ko vari noteikt. Tava partnera daļa par pasūtījumu ir customer_price − wholesale_floor. Pirms iesniegšanas vednis parāda aprēķinātās maržas katram līmenim.

Savas cenas var iestatīt tikai daļēji

Pat savu cenu režīmā nav jāpārraksta katrs līmenis — atstāj līmeni uz noklusējuma, un tas pārmanto mintbot ieteikto cenu. Rediģē tikai tos, kas tev ir svarīgi.

Palaišana

Pēc vedņa vadības panelis rāda baneri ar visu vēl trūkstošo obligāto informāciju. Trīs obligātie lauki ir:

  1. Telegram bota tokens (vai cits bota nodrošinātājs)
  2. DNS API atslēga (piem., Zone.ee atslēga + lietotājvārds)
  3. Apex domēns

Aģenta pielāgojumu repozitorija URL ir neobligāts — atstāj to tukšu, un tavi aģenti tiks izvietoti uz vienkāršās bāzes bez zīmola.

Tiklīdz obligātie lauki ir aizpildīti un DNS nodrošinātāja pārbaude ir izieta, poga Go Live kļūst aktīva. Tās nospiešana pārslēdz tavu partnera statusu no onboarding uz live, un Brand Partner API sāk pieņemt pasūtījumu izveides pieprasījumus.

Aktivizēšana ir neatgriezeniska

Tavs konts paliek stāvoklī onboarding, līdz noklikšķini Go Live. Ievadīšanas laikā API rakstīšanas pieprasījumus noraida ar 403 (lasīšana paliek atvērta, lai vari pārbaudīt stāvokli). Neaktivizē, kamēr tava domēna DNS nav pārbaudīts Zone.ee un (ja to izmanto) neesi pārbaudījis pielāgojumu repozitoriju DEV izvietojumā.

Pēc Go Live domēna un Telegram bota iestatījumi tiek slēgti

Tiklīdz tavs partnera statuss ir live, Settings sadaļas Domain un Telegram bot kļūst tikai lasāmas. Esošie klientu aģenti jau norāda uz tavu apex domēnu un tērzē caur tavu botu — klusa izmaiņa tos pamestu pusceļā. Pārējās sadaļas paliek rediģējamas:

Sadaļa Rediģējama, kamēr live?
Domēns / DNS / apakšdomēnu šablons Nē — sazinies ar atbalstu, ja vajadzīga migrācija
Telegram bots Nē — sazinies ar atbalstu, ja vajadzīga migrācija
Aģenta pielāgojumu repozitorijs Jā — jaunie aģenti klonē jauno repozitorija URL; esošie aģenti to palaiž no jauna caur update.sh nākamajā bāzes atjauninājumā
API atslēga / webhook Jā — rotē jebkurā brīdī
Cenas Jā — attiecas uz turpmākajiem pasūtījumiem

Slēgums tiek nodrošināts gan saskarnē (lauku grupa atspējota, baneris paskaidro, kāpēc), gan serverī (POST uz /settings ar section=domain vai section=bot atgriež 403).

Webhooki + izmaksas

  • Webhooku piegāde — katrs dzīvescikla notikums (pasūtījums izveidots, aktivizēts, beidzies) tiek nosūtīts uz webhook URL, ko iestatīji sadaļā Settings. Vadības paneļa partnera Webhook health indikators rāda piegādes veiksmes rādītāju pēdējās 24 h.
  • Ieņēmumu virsgrāmata — katrs apmaksāts pasūtījums ieraksta rindu ar tavu bruto summu, tavu daļu un mintbot daļu. Vadības panelis rāda kopsummas un neizmaksāto atlikumu.
  • Izmaksas — uzkrājas. Mintbot komanda tās izmaksā manuāli saskaņā ar partnera līgumu; vadības panelis seko līdzi, kas ir izmaksāts un kas vēl nav.

Atsauces portāls

Ja negribi veidot veikalu no nulles, forko oficiālo piemēru: mintbot-ai/partner-portal-example. Tas ir MIT licencēts FastAPI + SQLite + Docker, nāk ar izdomātu zīmolu „AcmeAI“, ko vari nomainīt, un aptver pilnu ciklu no sākuma līdz beigām:

  • sākumlapa ar plānu kartītēm,
  • /buy forma → POST /api/v1/orders → novirzīšana uz Stripe apmaksu,
  • pateicības / atcelšanas atgriešanās lapas,
  • POST /webhooks/mintoffice ar HMAC paraksta pārbaudi,
  • /admin notikumu pārlūks ar HTTP Basic autentifikāciju,
  • /healthz darbspējas pārbaude.

Iestatīšanas pamācība

  1. Forko repozitoriju, lai zīmola izmaiņas glabātos git:

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

  2. Aizpildi .env ar vērtībām no sava MintOffice vadības paneļa:

    Mainīgais Kas šeit jāieraksta
    PARTNER_BRAND Klientam redzamais zīmola nosaukums (tiek izmantots arī kā Stripe rindas etiķete).
    MINTOFFICE_API_URL https://mint.mintbot.ai aktīvajai videi, https://mint.mintbot.dev testēšanai.
    MINTOFFICE_API_KEY API atslēga no Settings → API access (formāts mo_live_…).
    MINTOFFICE_WEBHOOK_SECRET Webhooka parakstīšanas noslēpums, kas izveides brīdī vienreiz parādīts tajā pašā vadības panelī.
    PUBLIC_BASE_URL HTTPS URL, kurā dzīvos tavs portāls (no tā tiek veidoti Stripe success_url / cancel_url).
    ADMIN_USERNAME / ADMIN_PASSWORD Basic autentifikācija sadaļai /admin. Izmanto garu, nejaušu paroli.

  3. Palaid to — Docker ir vieglākais ceļš; darbojas arī bez konteinera:

    docker compose up --build

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

  4. Padari to pieejamu caur HTTPS — MintOffice noraida http:// gan Stripe novirzīšanas URL, gan webhook URL (privātās IP adreses un localhost bloķē SSRF aizsardzība). Lokālai izstrādei izmanto Cloudflare Tunnel, Tailscale Funnel vai ngrok. Produkcijai izvieto uz sava servera.

  5. Norādi sava partnera ierakstu uz portālu — atpakaļ vadības panelī:

    • Iestati Webhook URL uz https://<your-host>/webhooks/mintoffice.
    • Tas arī viss. Veic testa pasūtījumu no /buy un vēro, kā notikumi ienāk /admin.

Zīmola maiņa

Noklusējuma veidnes izliekas par AcmeAI. Trīs vietas, kur to mainīt:

  • PARTNER_BRAND failā .env — nonāk Stripe, galvenēs, kājenēs.
  • app/templates/base.html — CSS mainīgie krāsām / akcentam.
  • app/templates/*.html — teksti un katras lapas izkārtojums. Tulkojumi (igauņu, spāņu, …) dzīvo kā šo failu forki.

Ātra izvietošana tajā pašā VPS, kur tavi aģenti

Piemēra portāls ir pietiekami mazs, lai darbotos līdzās tavam MintOffice izvietošanas aģentam. Ja tev jau ir mintbot aģenta VPS, palūdz tam: „Izvieto partner-portal-example kā webhook saņēmēju adresē https://portal.<my-domain>/, aizpildi MINTOFFICE_API_KEY un MINTOFFICE_WEBHOOK_SECRET no GET /api/v1/settings un iestati webhook URL manā partnera ierakstā.“ Aģentam ir dokumentācija un API atslēgas ceļš, lai to paveiktu no sākuma līdz beigām.

Brand Partner API

Programmatiskai aģentu izveidei, statusa aptaujāšanai un webhooku notikumiem skati Brand Partner API aprakstu. Plašāku arhitektūru (kā tavs veikals, API, izvietošanas process un katra klienta aģenta VPS sader kopā) skati lapā MintOffice — tehniskā daļa.