MintOffice¶

MintOffice on mintbot.ai Brand Partneri portaal. See võimaldab Sul müüa mintbotti edasi oma kaubamärgi all: Sinu domeen, Sinu bot, Sinu kliendid — kogu masinavärgi (paigaldus, makselahendused, iga agendi taristu) korraldab mintbot Sinu eest.

Avalik portaal asub aadressil mint.mintbot.ai.

See juhend viib Sind „kuulsin just MintOffice'ist“ olekust kuni „minu esimene valgemärgistusega (white-label) agent töötab minu domeeni all“ olekuni. Tehnilised sammud (DNS-kirjed, GitHubi hoidla, Telegrami boti token) on kõige mugavam delegeerida mintboti agendile — vaata enne alustamist Lase agendil enda eest seadistus teha.

Ehitad integratsiooni ise?

Arendaja-vaatega kohta — milliseid hoidlaid Sa forgid, kuidas deploy voog otsast lõpuni jookseb ja kuidas Agent customization repo + pood kokku passivad — vaata MintOffice — tehnika.

Mida saad¶

Müü edasi iga mintboti paketti (Trial, Starter, Pro, Max) enda domeeni all — Sinu kliendid näevad agent1.sinubrand.com, mitte *.mintbot.ai.
Kasuta enda Telegrami botti (@sinubrand_bot) vestluseks või laena testimise ajaks meie oma.
Vali kliendile suunatud hinnad ja võta endale vahe selle ja mintboti hulgimüügihinna vahel (MintOffice'i miinimumhind partnerile).
Brand Partner API tellimuste loomiseks, elutsükli olekute pärimiseks ja webhookide saatmiseks Sinu enda süsteemidesse.
Töölaud, kus on näha aktiivsed kliendi tellimused, botiühenduste seisukord, hinnakujundus, väljamaksed ja webhookide kohaletoimetamise olek.

Hind — Brand Partneri liitumismaks¶

Tasuta prooviportaali konto loomine on tasuta — aga Brand Partneri liitumine on see üks makse, mis muudab selle päris brand-partneri kontoks. Maksad ühekordse liitumismaksu aadressil reception.mintbot.ai/mintoffice (või reception.mintbot.dev/mintoffice dev/test-keskkonnas) 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
Brand Partner — stardipakkumine	49 € ühekordne + 10 €/kuus	20 DEV-deploy'd (igaühel 1 € agendikrediiti), esimene kuu konto haldust sees, Brand Partneri staatus nii `mint.mintbot.ai` kui `mint.mintbot.dev` portaalis, põhjalik seadistusjuhend (agent võib kogu vormi Sinu eest läbi teha)
Brand Partner — tavahind	99 € ühekordne + 10 €/kuus	Sama mis stardipakkumine — ilma soodustuseta

Liitumine on beetas

Brand Partneri kassa on praegu avatud dev/test-keskkonnas (reception.mintbot.dev/mintoffice). Avalik .ai kassa avaneb peagi.

Mida liitumismaks katab:

20 DEV-deploy'd, igaüks 24-tunnine ühekordne test-VPS, millel on 1 € agendikrediiti — piisav, et oma portaali ja kohanduste malli otsast lõpuni läbi proovida.
Su esimene kuu konto haldust (allpool olev 10 €/kuus tasu) — nii et esimene kuu on juba makstud.
Brand Partneri staatus nii mint.mintbot.ai kui mint.mintbot.dev portaalis.

10 €/kuus konto haldustasu:

Alates teisest kuust kannab Brand Partneri konto 10 €/kuus konto haldustasu. Kõige mugavam on seda maksta Stripe'i või PayPali püsimaksena (soovitatav — see uueneb ise); ühekordse liitumismaksu saab tasuda ka kaardiga või krüptoga (BTC, XMR ja paljud mündid CCPaymenti kaudu).

Kui kuutasu jääb maksmata, läheb Sinu MintOffice'i konto pausile: uusi agente luua ei saa, aga olemasolevad kliendiagendid jäävad tööle. Võtame enne midagi peatamist ühendust, et saaksid jätkata.

Mis juhtub pärast maksmist:

Reception töötleb liitumismakse aadressil reception.mintbot.ai/mintoffice (või .dev test-keskkonnas) — kaart / Apple Pay / Google Pay või krüpto.
Reception saadab kohe allkirjastatud grandi nii mint.mintbot.ai kui mint.mintbot.dev portaali, lülitades Su konto mõlemas Brand Partneri staatusesse.
Saad tervituskirja aadressilt pigeon@mintbot.ai (või pigeon@mintbot.dev, kui ostsid test-keskkonnas), milles on mõlemad sisselogimislingid ja viide sellele juhendile.
Logi sisse portaali, kummast soovid alustada. Kui ülekeskkonna push peaks mõne portaali millegipärast vahele jätma, küsib esimene sisselogimine sealt receptionilt „kas see e-post maksis?“ ja rakendab grandi kohapeal.

Stardipakkumine on vaikimisi sees, kuni MintOffice'i välja rullime; seda juhib serveri lipp MINTOFFICE_SETUP_PROMO, nii et kassas nähtav hind on see, mida maksad.

Tagasimaksed

14-päevane tagasimakse aken, küsimusteta — kui tase Sinu kasutusjuhu jaoks ei tasu end ära, kirjuta support@mintbot.ai ja maksame tasu tagasi.

Hulgimüügi agendihind (mida mintbot Sinult iga tellitud kliendi tellimuse eest võtab) on liitumismaksust sõltumatu ja asub allpool jaotises Hinnakujundus.

Lase agendil enda eest seadistus teha¶

Suurem osa tehnilisest tööst — domeeni ostmine, DNS-i häälestamine, Telegrami boti loomine, Agent customization repo seadistamine — on mehaaniline. Saad selle käsitsi ära teha, aga sujuvaim viis on see mintboti agendile delegeerida.

Soovitatud tee

Käivita üks mintboti agent ja ütle talle: „Pane mind MintOffice'i brand-partneriks domeenile sinubrand.com — juhi mind läbi liitumisvormi ja täida ära kõik, mille saad minu nimel täita."

Agendil on terminal, brauser, DNS API, GitHubi autentimine ja juurdepääs sellele juhendile. Ta ütleb täpselt, milline samm vajab Sinu sekkumist (nt BotFatheri kinnituse klõpsamine Telegramis) ja ülejäänu teeb ise.

Sinu enda Hermes, OpenCode'i / OpenClaw'i paigaldus, Cursori agent-režiim või suvaline muu koodiagent töötab samuti — anna talle see leht kaasa ja räägi eesmärk lahti.

Kui eelistad vormi ise täita, on järgnevad sammud täpselt need, mis agent samm-sammult teeks.

Samm 0 — Loo konto¶

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

Parooli pole — iga järgmine sisselogimine on uus võlulink. Põhjus on lihtne: paroolid lekivad, võlulingid ei leki ja agent saab need lihtsalt automatiseerida, kui annad talle hiljem e-postile juurdepääsu.

Samm 1 — Domeen¶

Vormi esimene küsimus on kus Sinu agendid hakkavad elama. Sul on kaks valikut:

Kasuta enda domeeni (soovitatud)Kasuta mintbot.ai alamdomeeni

Agendid elavad Sinu enda domeeni alamdomeenidena — nt agent1.sinubrand.com, agent2.sinubrand.com, … See on Sinu kaubamärgiga kliendikogemus.

Vaja on:

Peadomeen — registreeritud paljas domeen (ilma https://, ilma alamdomeenita): sinubrand.com.
DNS-pakkuja — praegu töötab ainult Zone.ee tagataust. Cloudflare ja käsitsirežiim on arendusplaanis.
Zone.ee API võti + kasutajanimi — väljastatakse my.zone.eu → Konto seaded → API võtmed → Loo uus võti. Agent kasutab seda A-kirjete automaatseks loomiseks, kui paigaldad uue agendi.

Alamdomeeni nummerduse stiil

Teksti prefiks + number (vaikimisi) — agent1.sinubrand.com, agent2.sinubrand.com, … Kõige loetavam.
Ainult numbrid — 1.sinubrand.com, 2.sinubrand.com, … Lühike.
Ainult numbrid, nulltäitega — 001.sinubrand.com, … Stabiilse pikkusega.

See valik on puhtalt visuaalne — deploy-worker saab kõigi kolme valikuga hakkama.

Agendid elavad *.mintbot.ai all — midagi pole vaja seadistada, aga URL ei kanna Sinu kaubamärki. Hea proovimiseks; enne klientidele avamist mine oma domeeni peale.

Samm 2 — Bot¶

Igal agendil on vestluskanal. Vaikimisi eeldame Telegrami — Discord ja Slack on kavas, aga pole veel ühendatud.

Kasuta enda Telegrami botti (soovitatud)Laena mintboti bottiPraegu botti ei ole

Kliendid vestlevad @sinubrand_bot-iga, mis hoiab kaubamärgi alles.

Ava Telegramis @BotFather.
Saada /newbot. Anna botile nimi ja kasutajanimi (peab lõppema bot-iga).
BotFather tagastab tokeni kujul 123456789:AA… (vähemalt 40 märki).
Kleebi token vormi.

Vaata pikemat juhendit Telegrami botiõpetuses.

Kliendid vestlevad @mintbot_dev_bot-iga. Kiireks demoks sobib, aga ilma Sinu kaubamärgita. Enne avalikku käivitamist mine oma boti peale üle.

Jäta Telegram täiesti vahele. Kliendid pääsevad agendi juurde ainult veebipaneeli kaudu. Boti saad hiljem Seadetest lisada.

Samm 3 — Agent customization repo¶

Iga agent paigaldatakse mintboti enda poolt standardsele, brändituvabale baasile. Et panna peale Sinu bränd — persona, paneeli teema, tekstid, lisatööriistad — suunad nõustaja Agent customization repo peale: GitHubi hoidla, mille agendi enda VPS kloonib ja jooksutab pärast standardset deploy'd. Sina otsustad välimuse; kood kuulub Sulle.

Kuidas Agent customization repo töötab

Hoidla juurkaustas on kaks skripti:

install.sh — jookseb üks kord agendi VPS-is, pärast seda, kui standardne deploy on lõppenud ja agent on terve. Siin rakendad oma kohanduse: teema, persona muudatused, lisatööriistad.
update.sh — valikuline; jookseb pärast iga baaspaketi uuendust, et saaksid oma kihi värske baasi peale uuesti rakendada.

Mintbot ei jooksuta kunagi Sinu hoidlat — seda teeb ainult agendi enda VPS, kliendi enda masinas. Kleebi vormi oma hoidla GitHubi HTTPS-URL; jäta tühjaks ja saad tavalise brändituvaba baasi.

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

Forki mintbot-ai/agent-template või loo hoidla, mille juures on install.sh (ja valikuline update.sh), mis rakendab Sinu CSS-i / tekstid / persona, ning kleebi hoidla GitHubi HTTPS-URL. Agendi VPS kloonib selle pärast deploy'd ja jooksutab Sinu skriptid, et kihistada Sinu bränd baasi peale.

Katkine skript ei saa kliendi agenti lõhkuda

Sinu skriptid on tõrkeisoleeritud. Kui install.sh või update.sh puudub, annab vea või jookseb aeglaselt, õnnestub deploy ikka, 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. Ainus tagajärg on, et agent jääb tavalise baasi peale Sinu bränditud kihi asemel, seega testi oma hoidlat enne DEV-deploy'l.

Tavaline brändituvaba baasi välimus ja persona — Agent customization repo't pole. Saad hoidla URL-i hiljem Seadetest lisada.

Samm 4 — API¶

Brand Partner API võimaldab Sul agentide loomist juhtida oma serverist, mitte töölaualt. Vorm jätab API seadistamise vaikimisi vahele — jäta see hiljemaks, kui Sul pole vajadust kohe integreerida.

Kui oled valmis:

Töölaualt ava Seaded → API juurdepääs.
Klõpsa Loo võti. Võtme tekst kuvatakse ainult üks kord — salvesta see oma saladuste haldusse.
(Valikuline) Seadista webhooki URL elutsükli sündmuste vastuvõtmiseks.

Täielik lõpp-punktide nimekiri ja webhooki päringukere kujud: Brand Partner API viide.

Live'i minek¶

Pärast vormi täitmist näitab töölaud bännerit, kus on loetelu veel puuduvast kohustuslikust infost. Kolm kohustuslikku välja on:

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

Agent customization repo URL on valikuline — jäta tühjaks ja Sinu agendid paigalduvad tavalisele brändituvabale baasile.

Kui kõik neli on täidetud ja DNS-pakkuja kontroll on roheline, aktiveerub nupp Go Live. Selle klõpsamine viib Sinu partneri oleku onboarding → live ja Brand Partner API hakkab vastu võtma tellimuste loomise päringuid.

Aktiveerimine on ühepoolne käepigistus

Sinu konto püsib onboarding-olekus, kuni klõpsad Go Live. onboarding-olekus tagastab API kõikidele kirjutamistele 403 (lugemine jääb avatuks, et saaksid olekut vaadata). Ära aktiveeri enne, kui domeen on Zone.ee-s verifitseeritud ja (kui kasutad enda Agent customization repo't) oled selle DEV-deploy'l testinud.

Hinnakujundus¶

MintOffice jagab hinnakujunduse kaheks režiimiks — vali oma töövoogu sobiv menüüst Seaded → Hinnakujundus:

Režiim	Mida tähendab
Vaikimisi	Kliendid näevad mintboti soovituslikku hinda paketi kohta. Sina võtad partneri kasumiosa selle soovitusliku hinna ja hulgimüügi alampiiri vahelt. Mingit seadistust pole vaja.
Kohandatud	Sina määrad iga paketi puhul, mida klient maksab. Hulgimüügi alampiiri ületav osa läheb Sinule. Sobib, kui Sul on kindel hinnakujundusstrateegia.

Hulgimüügi alampiir on see, mida mintbot võtab Sinult paketi eest — see on absoluutne miinimum, mida võid küsida. Partneri kasum tellimuse kohta on kliendi_hind − hulgimüügi_alampiir.

Webhookid + väljamaksed¶

Webhookide kohaletoimetamine — iga elutsükli sündmus (tellimus loodud, aktiveeritud, aegunud) saadetakse webhooki URL-ile, mille Seadetes määrad. Töölaua partneri kaardil olev Webhooki seisukord näitab kohaletoimetamise edukust viimase 24 tunni jooksul.
Tulude pearaamat — iga makstud tellimus kirjutab rea bruto-, Sinu osa- ja mintboti osa kohta. Töölaud näitab kogu aja kogusummasid ja maksmata jääki.
Väljamaksed — kogunevad. Mintboti meeskond maksab need välja käsitsi partneri lepingu järgi; töölaud näitab makstud ja maksmata olekut.

Brand Partner API¶

Tellimuste loomiseks koodi kaudu, oleku pärimiseks ja webhookide sündmusteks vaata Brand Partner API viidet. Laiema arhitektuuri kohta (kuidas Sinu pood, API, deploy worker ja iga kliendi agendi VPS kokku passivad) vaata MintOffice — tehnika.