MintOffice¶

MintOffice on mintbot.ai brändipartneri portaal. Selle kaudu saad müüa mintbotti edasi oma brändi all: sinu domeen, sinu bot, sinu kliendid – paigalduse, makselahendused ja iga agendi taristu korraldab mintbot taustal.

Partneriportaal töötab aadressil mint.mintbot.ai.

See juhend viib sind punktist „kuulsin just MintOffice'ist“ punkti „minu esimene white-label-agent töötab minu enda domeenil“. Tehnilised sammud (DNS-kirjed, GitHubi hoidla, boti token) on kõige mugavam jätta mintboti agendi hooleks – loe enne alustamist jaotist Lase agendil end seadistada.

Ehitad integratsiooni ise?

Arendaja vaade – millised hoidlad sulle kuuluvad, kuidas deploy-voog otsast lõpuni jookseb ja kuidas Agent customization repo ja pood kokku sobivad – on lehel MintOffice – tehniline.

Mida sa saad¶

Müü iga mintboti paketti (Trial, Starter, Pro, Max) edasi enda domeeni all – sinu kliendid näevad aadressi agent1.sinubrand.com, mitte *.mintbot.ai.
Kasuta vestluseks enda Telegrami botti (@sinubrand_bot) või laena testimise ajaks mintboti oma.
Määra ise klientidele kuvatavad hinnad ja jäta endale vahe selle ja mintboti hulgihinna (MintOffice'i hulgimüügi alampiiri) vahel.
Brand Partner API tellimuste programmiliseks loomiseks, elutsükli oleku pärimiseks ja webhookideks sinu enda süsteemidesse.
Töölaud, kus näed aktiivseid klienditellimusi, botiühenduse seisukorda, hinnakujundust, väljamakseid ja webhookide kohaletoimetamist.

Hind – brändipartneri liitumistasu¶

Tasuta prooviportaali konto loomine on, nagu nimigi ütleb, tasuta – aga brändipartneriks registreerumine on see üks makse, mis muudab konto päris brändipartneri kontoks. Ühekordse liitumistasu maksad aadressil reception.mintbot.ai/mintoffice (dev/test-keskkonnas reception.mintbot.dev/mintoffice) ja sama makse avab mõlemad portaalid:

Tase	Hind	Mida sisaldab
Tasuta proov (vaikimisi igal uuel partneril)	0 €	10 ühekordset DEV-deploy'd portaali ja malli testimiseks
Brändipartner – stardipakkumine	49 € ühekordselt + 10 €/kuus	20 DEV-deploy'd (igaühel 1 € agendikrediiti), esimene kuu kontohaldust hinna sees, brändipartneri staatus nii portaalis `mint.mintbot.ai` kui ka `mint.mintbot.dev`, põhjalik seadistusjuhend (agent võib kogu nõustaja sinu eest läbi teha)
Brändipartner – tavahind	99 € ühekordselt + 10 €/kuus	Sama mis stardipakkumine, ilma soodustuseta

Liitumine on beetas

Brändipartneri kassa on praegu avatud dev/test-keskkonnas (reception.mintbot.dev/mintoffice). Avalik .ai kassa avaneb peagi.

Mida liitumistasu katab:

20 DEV-deploy'd – igaüks 24 tunniks loodud ühekordne test-VPS, millel on 1 € agendikrediiti – piisab, et oma portaal ja kohandusmall otsast lõpuni läbi proovida.
Esimese kuu kontohaldus (allpool kirjeldatud 10 €/kuus tasu) – esimene kuu on seega juba makstud.
Brändipartneri staatus nii portaalis mint.mintbot.ai kui ka mint.mintbot.dev.

Kontohaldustasu 10 €/kuus:

Alates teisest kuust kehtib brändipartneri kontole 10 €/kuus kontohaldustasu. Kõige mugavam on see vormistada Stripe'i või PayPali püsimaksena (soovitame – see uueneb ise); ühekordse liitumistasu saab tasuda ka kaardiga või krüptoga (BTC, XMR ja paljud teised mündid CCPaymenti kaudu).

Kui kuutasu jääb maksmata, läheb sinu MintOffice'i konto pausile: uusi agente sa paigaldada ei saa, aga olemasolevad kliendiagendid töötavad edasi. Enne kui midagi seiskub, võtame sinuga ühendust, et saaksid jätkata.

Mis juhtub pärast maksmist:

Reception töötleb liitumismakse aadressil reception.mintbot.ai/mintoffice (test-keskkonnas .dev) – kaart / Apple Pay / Google Pay või krüpto.
Reception saadab kohe allkirjastatud loa nii portaali mint.mintbot.ai kui ka mint.mintbot.dev, lülitades sinu konto mõlemas brändipartneri staatusesse.
Saad tervituskirja aadressilt pigeon@mintbot.ai (või pigeon@mintbot.dev, kui ostsid test-keskkonnas), milles on mõlema portaali sisselogimislink ja viide sellele juhendile.
Logi sisse portaali, kummast tahad alustada. Kui keskkondadevaheline teavitus peaks mõnest portaalist millegipärast mööda minema, küsib esimene sisselogimine seal receptionilt „kas see e-post on maksnud?“ ja rakendab loa kohe.

Stardipakkumine on MintOffice'i väljarullimise ajal vaikimisi sees; seda juhib serveri lipp MINTOFFICE_SETUP_PROMO, nii et kassas kuvatav hind ongi see, mida maksad.

Tagasimaksed

14-päevane tagasimakseaken, küsimusi esitamata – kui tase end sinu jaoks ära ei tasu, kirjuta aadressile support@mintbot.ai ja saadame tasu tagasi.

Agendipõhine hulgihind (see, mida mintbot sinult iga klienditellimuse eest võtab) ei sõltu liitumistasust ja on kirjas allpool jaotises Samm 5 – Hinnakujundus.

Lase agendil end seadistada¶

Suurem osa tehnilisest tööst – domeeni ostmine, DNS-i seadistamine, Telegrami boti loomine, mallihoidla forkimine – on mehaaniline. Saad selle käsitsi ära teha, aga kõige sujuvam on see mintboti agendile delegeerida.

Soovitatud tee

Käivita mintboti agent ja ütle talle: „Sea mind MintOffice'i brändipartneriks domeenil sinubrand.com – juhi mind läbi liitumisnõustaja ja täida minu eest ära kõik, mida saad.“

Agendil on terminal, brauser, DNS API, GitHubi autentimine ja teadmised sellest juhendist. Ta ütleb täpselt, milline samm vajab sinu sekkumist (nt BotFatheri kinnituse klõpsamine Telegramis), ja teeb ülejäänu ise.

Sama hästi sobib sinu enda Hermes, OpenCode'i või OpenClaw'i paigaldus, Cursori agendirežiim või mis tahes muu koodiagent – anna talle see leht kontekstiks ja ütle eesmärk.

Kui eelistad nõustaja ise läbi teha, on allolevad sammud täpselt need, mida agent teeks.

Samm 0 – Loo konto¶

Ava mint.mintbot.ai.
Sisesta e-posti aadress, mida tahad operaatori sisselogimiseks kasutada.
Klõpsa Saada mulle sisselogimislink.
Ava kiri aadressilt pigeon@mintbot.ai ja klõpsa võlulinki (kehtib 24 h, ühekordne).

Parooli ei ole – iga järgmine sisselogimine käib jälle võlulingiga. See on taotluslik: paroolid lekivad, võlulingid mitte, ja kui annad agendile hiljem e-postile juurdepääsu, saab ta need lihtsalt automatiseerida.

Samm 1 – Domeen¶

Nõustaja esimene küsimus on, kus sinu agendid elama hakkavad. Valikuid on kaks:

Kasuta enda domeeni (soovitatud)Kasuta mintbot.ai alamdomeeni

Agendid elavad sinu domeeni alamdomeenidel – nt agent1.sinubrand.com, agent2.sinubrand.com, … See on sinu brändiga kogemus, mida kliendid näevad.

Vaja läheb:

Peadomeen – registreeritud paljas domeen (ilma https:// ja alamdomeenita): sinubrand.com.
DNS-pakkuja – praegu töötab ainult Zone.ee tugi. Cloudflare ja käsitsirežiim on arendusplaanis.
Zone.ee API-võti + kasutajanimi – saad need aadressilt my.zone.eu → Konto seaded → API-võtmed → Loo uus võti. Agent loob nendega uue agendi paigaldamisel A-kirjed automaatselt.

Alamdomeenide nummerdusstiil

Tekstiprefiks + number (vaikimisi) – agent1.sinubrand.com, agent2.sinubrand.com, … Kõige loetavam.
Ainult number – 1.sinubrand.com, 2.sinubrand.com, … Lühike.
Number nullidega täidetud – 001.sinubrand.com, … Alati sama pikkusega.

Valik on puhtalt kosmeetiline – deploy worker saab kõigi kolmega hakkama.

Agendid elavad aadressil *.mintbot.ai – ei mingit seadistamist ega DNS-i, aga URL ei kanna sinu brändi. Sobib proovimiseks; enne klientidele avamist mine üle oma domeenile.

Samm 2 – Bot¶

Igal agendil on vestluskanal. Vaikimisi eeldame Telegrami – Discord ja Slack on ette valmistatud, aga pole veel ühendatud.

Kasuta enda Telegrami botti (soovitatud)Laena mintboti bottiBotti veel pole

Kliendid vestlevad botiga @sinubrand_bot, mis hoiab brändi tervikliku.

Ava Telegramis @BotFather.
Saada /newbot. Anna botile kuvanimi ja kasutajanimi (peab lõppema sõnaga bot).
BotFather tagastab tokeni kujul 123456789:AA… (vähemalt 40 märki).
Kleebi see token nõustajasse.

Pikem juhend on Telegrami botiõpetuses.

Kliendid vestlevad botiga @mintbot_dev_bot. Demoks kiire, aga ilma sinu brändita. Enne käivitamist mine üle enda botile.

Jäta Telegram täiesti vahele. Kliendid kasutavad agente ainult veebipaneeli kaudu. Boti saad hiljem Seadetest lisada.

Samm 3 – Agent customization repo¶

Iga agendi paigaldab mintbot ise standardsele brändita baasile. Et lisada sellele oma bränd – persona, paneeli teema, tekstid, lisatööriistad –, suunad nõustaja Agent customization repo peale: GitHubi hoidla, mille agendi enda VPS kloonib ja käivitab pärast standardset paigaldust. Sina otsustad välimuse; kood kuulub sulle.

Kuidas Agent customization repo töötab

Hoidla juurkaustas on kaks skripti:

install.sh – käivitatakse agendi VPS-is üks kord, pärast seda, kui standardpaigaldus on lõppenud ja agent on terve. Siin rakendad oma kohanduse: teema, persona muudatused, lisatööriistad, kliendipõhise seadistuse.
update.sh – valikuline; käivitatakse pärast iga baaspaketi uuendust, et saaksid oma kihi värskele baasile uuesti peale panna.

Mintbot ei käivita sinu hoidlat kunagi – seda teeb ainult agendi enda VPS kliendi enda masinas. Kleebi nõustajasse oma hoidla GitHubi HTTPS-URL; kui jätad välja tühjaks, saad tavalise brändita baasi.

Suuna enda Agent customization repo'le (soovitatud)Jäta tühjaks

Loo hoidla, mille juurkaustas on install.sh (ja valikuline update.sh), mis rakendab sinu CSS-i, tekstid ja persona, ning kleebi hoidla GitHubi HTTPS-URL. Agendi VPS kloonib selle pärast paigaldust ja käivitab sinu skriptid, et lisada sinu bränd baasi peale kihina.

Katkine skript ei saa kliendi agenti lõhkuda

Sinu skriptid on tõrgete eest isoleeritud. Kui install.sh või update.sh puudub, annab vea või jookseb aeglaselt, õnnestub paigaldus ikkagi, baaspaketi uuendust ei blokeerita ega pöörata tagasi ja agent jääb terveks. Tõrge logitakse VPS-is ja tuuakse sinuni – mitte kunagi lõppkliendini. Katkise skripti ainus tagajärg on see, et agent jääb sinu bränditud kihi asemel tavalisele baasile, seega testi oma hoidlat kõigepealt DEV-deploy'ga.

Tavaline brändita baasi välimus ja persona – ilma Agent customization repo'ta. Hoidla URL-i saad hiljem Seadetest lisada.

Samm 4 – API¶

Brand Partner API võimaldab agentide loomist juhtida oma taustsüsteemist, mitte töölaualt. Nõustaja jätab API seadistamise vaikimisi vahele – jäta see hilisemaks, kui sa pole valmis kohe integreerima.

Kui oled valmis:

Ava töölaual Seaded → API juurdepääs.
Klõpsa Loo võti. Võtme avatekst kuvatakse ainult üks kord – salvesta see oma saladustehaldurisse.
(Valikuline) Seadista webhooki URL elutsükli sündmuste vastuvõtmiseks.
(Valikuline) Loo webhooki allkirjastamise saladus, kui sinu vastuvõtja on valmis allkirju kontrollima.

Täielik lõpp-punktide loend ja webhooki päringukehade kujud on Brand Partner API viites.

Webhooki URL ja allkirjastamise saladus on valikulised

Kumbagi pole müügi alustamiseks vaja – töölaud ja API töötavad ka ilma nendeta. Webhooki URL-i väli jääb tühjaks, kuni sul on vastuvõtja aadressil https://<sinu-host>/...; allkirjastamise saladusest on kasu alles siis, kui URL on määratud ja tahad kontrollida päist X-Mintbot-Signature. Mõlemat saab igal ajal lisada (või vahetada) menüüst Seaded → API juurdepääs.

Lase integratsiooniagendil seadistus ise üles leida

Kui API-võti on olemas, saab agent kutsuda GET /api/v1/settings ja lugeda sinu kogu mittesalajase konfiguratsiooni ühe päringuga – domeen, DNS-pakkuja, bot, Agent customization repo, alamdomeenide muster, hinnakujundus, valmidus. Ühtegi saladust ei tagastata (tokenid ja võtmed paistavad ainult *_set-tõeväärtustena), nii et võtit on ohutu jagada agendiga, kes paigaldab sinu white-label-seadistust värskele serverile.

Jäta rutiin vahele – forgi näidisportaal

Täielik, käivitatav näidispood on hoidlas mintbot-ai/partner-portal-example. Täpsem juhend on allpool jaotises Näidisportaal.

Samm 5 – Hinnakujundus¶

Nõustaja viimane samm on see, mida sinu kliendid iga paketi eest maksavad. MintOffice jagab hinnakujunduse kaheks režiimiks – hiljem saad neid vahetada menüüst Seaded → Hinnakujundus:

Kasuta vaikimisi hindu (soovitatud)Määra tasemetele oma hinnad

Kliendid näevad mintboti soovitushinda iga taseme (Trial, Starter, Pro, Max) kohta. Sinu partnerimarginaal on soovitushinna ja hulgimüügi alampiiri vahe – seadistamist pole vaja. Vali see, kui tahad lihtsalt müügiga alustada.

Määrad ise, mida klient iga taseme eest maksab. Kõik, mis jääb üle hulgimüügi alampiiri, on sinu oma. Vali see, kui sul on läbimõeldud juurdehindlusstrateegia.

Hulgimüügi alampiir on see, mida mintbot võtab tellimuse eest sinult – absoluutne miinimum, mida sa küsida saad. Sinu partneriosa tellimuse kohta on kliendi_hind − hulgimüügi_alampiir. Nõustaja näitab enne kinnitamist iga taseme arvutatud marginaali.

Oma hindu võib määrata ka osaliselt

Ka kohandatud režiimis ei pea sa iga taset üle kirjutama – jäta tase vaikimisi olekusse ja see pärib mintboti soovitushinna. Muuda ainult neid, mis sulle korda lähevad.

Live'i minek¶

Pärast nõustajat näitab töölaud bännerit, kus on kirjas veel puuduvad kohustuslikud andmed. Kohustuslikke välju on kolm:

Telegrami boti token (või muu botipakkuja)
DNS API-võti (nt Zone.ee võti + kasutajanimi)
Peadomeen

Agent customization repo URL on valikuline – jäta see tühjaks ja sinu agendid paigaldatakse tavalisele brändita baasile.

Kui kohustuslikud väljad on täidetud ja DNS-pakkuja kontroll läbitud, aktiveerub nupp Go Live. Selle klõpsamine viib sinu partneristaatuse olekust onboarding olekusse live ja Brand Partner API hakkab tellimuste loomise päringuid vastu võtma.

Aktiveerimine on ühesuunaline

Sinu konto püsib olekus onboarding, kuni klõpsad Go Live. Liitumise ajal lükkab API kirjutamised tagasi vastusega 403 (lugemine jääb avatuks, et saaksid olekut vaadata). Ära aktiveeri enne, kui sinu domeeni DNS on Zone.ee-s kinnitatud ja (kui kasutad) sinu Agent customization repo on DEV-deploy'ga testitud.

Pärast Go Live'i lukustuvad domeeni ja Telegrami boti seaded

Kui sinu partneristaatus on live, muutuvad Seadete jaotised Domeen ja Telegrami bot kirjutuskaitstuks. Olemasolevad kliendiagendid osutavad juba sinu peadomeenile ja vestlevad sinu boti kaudu – vaikne muudatus jätaks need poole elu pealt orvuks. Ülejäänud jaotised jäävad muudetavaks:

Jaotis	Muudetav olekus `live`?
Domeen / DNS / alamdomeenide muster	Ei – kolimiseks võta ühendust toega
Telegrami bot	Ei – kolimiseks võta ühendust toega
Agent customization repo	Jah – uued agendid kloonivad uue hoidla URL-i; olemasolevad käivitavad selle järgmise baasiuuenduse ajal `update.sh` kaudu uuesti
API-võti / webhook	Jah – vaheta igal ajal
Hinnakujundus	Jah – kehtib tulevastele tellimustele

Lukk kehtib nii kasutajaliideses (väljad on keelatud, bänner selgitab põhjust) kui ka serveris (POST-päringud aadressile /settings parameetriga section=domain või section=bot tagastavad 403).

Webhookid + väljamaksed¶

Webhookide kohaletoimetamine – iga elutsükli sündmus (tellimus loodud, aktiveeritud, aegunud) saadetakse webhooki URL-ile, mille Seadetes määrad. Töölaua partneripõhine Webhooki seisukord näitab kohaletoimetamise edukust viimase 24 tunni jooksul.
Tuluraamat – iga makstud tellimus lisab rea sinu brutosumma, sinu osa ja mintboti osaga. Töölaud näitab kogu aja summasid ja väljamaksmata jääki.
Väljamaksed – kogunevad. Mintboti meeskond maksab need välja käsitsi partnerilepingu järgi; töölaud näitab, mis on makstud ja mis mitte.

Näidisportaal¶

Kui sa ei taha poodi nullist ehitada, forgi ametlik näidis: mintbot-ai/partner-portal-example. See on MIT-litsentsiga FastAPI + SQLite + Docker, tuleb kaasa väljamõeldud brändiga „AcmeAI“, mille saad välja vahetada, ja katab kogu tsükli otsast lõpuni:

avaleht paketikaartidega,
/buy vorm → POST /api/v1/orders → suunamine Stripe'i kassasse,
tänu- ja katkestamislehed,
POST /webhooks/mintoffice koos HMAC-allkirja kontrolliga,
HTTP Basic -autentimisega sündmuste sirvija /admin,
/healthz elusoleku kontroll.

Seadistuse käik¶

Forgi hoidla, et hoida oma brändimuudatusi gitis:

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

Täida .env väärtustega oma MintOffice'i töölaualt:

Muutuja	Mis siia käib
`PARTNER_BRAND`	Kliendile nähtav brändinimi (kasutatakse ka Stripe'i arverea nimena).
`MINTOFFICE_API_URL`	Live-keskkonnas `https://mint.mintbot.ai`, testimiseks `https://mint.mintbot.dev`.
`MINTOFFICE_API_KEY`	API-võti menüüst Seaded → API juurdepääs (kujul `mo_live_…`).
`MINTOFFICE_WEBHOOK_SECRET`	Webhooki allkirjastamise saladus, mida sama töölaud näitab loomisel ühe korra.
`PUBLIC_BASE_URL`	HTTPS-URL, millel sinu portaal tööle hakkab (sellest ehitatakse Stripe'i `success_url` / `cancel_url`).
`ADMIN_USERNAME` / `ADMIN_PASSWORD`	Basic-autentimise värav lehele `/admin`. Kasuta pikka juhuslikku parooli.

Käivita – Docker on lihtsaim tee, aga töötab ka otse masinas:
DockerKohalik Python
docker compose up --build
pip install -e . uvicorn app.main:app --reload
Ava see HTTPS-i kaudu – MintOffice lükkab http:// tagasi nii Stripe'i suunamis-URL-ide kui ka webhooki URL-i puhul (privaatsed IP-d ja localhost blokeerib SSRF-kaitse). Kohalikuks arenduseks sobivad Cloudflare Tunnel, Tailscale Funnel või ngrok. Toodangus paigalda oma serverisse.
Suuna oma partnerikonto portaalile – tagasi töölaual:
- Määra Webhooki URL väärtuseks https://<sinu-host>/webhooks/mintoffice.
- Ongi kõik. Tee lehelt /buy testtellimus ja vaata, kuidas sündmused lehele /admin saabuvad.

Ümberbrändimine¶

Vaikemallid esinevad AcmeAI nime all. Muuta tuleb kolme kohta:

PARTNER_BRAND failis .env – jõuab Stripe'i, päistesse ja jalustesse.
app/templates/base.html – värvide ja aktsendi CSS-muutujad.
app/templates/*.html – tekstid ja lehtede paigutus. Tõlked (eesti, hispaania, …) on nende failide forkid.

Kiire paigaldus samasse VPS-i, kus sinu agendid

Näidisportaal on piisavalt väike, et töötada sinu MintOffice'i paigaldusagendi kõrval. Kui sul on juba mintboti agendi VPS, ütle talle: „Paigalda partner-portal-example webhooki vastuvõtjana aadressile https://portal.<minu-domeen>/, täida MINTOFFICE_API_KEY ja MINTOFFICE_WEBHOOK_SECRET päringust GET /api/v1/settings ning määra minu partnerikontole webhooki URL.“ Agendil on olemas nii dokumentatsioon kui ka API-võtme asukoht, et see otsast lõpuni ära teha.

Brand Partner API¶

Agentide programmiliseks loomiseks, oleku pärimiseks ja webhooki sündmusteks vaata Brand Partner API viidet. Laiema arhitektuuri (kuidas sinu pood, API, deploy worker ja iga kliendi agendi VPS kokku sobivad) leiad lehelt MintOffice – tehniline.