Keri sisuni

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 template + 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.

Lase agendil enda eest seadistus teha

Suurem osa tehnilisest tööst — domeeni ostmine, DNS-i häälestamine, Telegrami boti loomine, malli forkimine — 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

  1. Ava mint.mintbot.ai.
  2. Sisesta e-posti aadress, mida soovid operaatori sisselogimisaadressiks.
  3. Klõpsa Saada mulle sisselogimislink.
  4. 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:

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.

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

  1. Ava Telegramis @BotFather.
  2. Saada /newbot. Anna botile nimi ja kasutajanimi (peab lõppema bot-iga).
  3. BotFather tagastab tokeni kujul 123456789:AA… (vähemalt 40 märki).
  4. 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 — Mall

Iga agent ehitatakse mallihoidlast, mis sisaldab CSS-i, tekste, vaikeisikupära ja agendi pluginate komplekti. Sina otsustad välimuse.

Forki mintbot-ai/agent-template, muuda CSS / tekstid / isikupära enda kaubamärgile vastavaks ja kleebi oma forgi URL.

Turvavõrk

Iga paigaldamisega tõmmatakse Sinu forgist värske koopia ja käivitatakse lepingulised testid. Kui need ebaõnnestuvad, paigaldus katkestatakse — Sinu klient ei näe iial katkist ehitust.

Tavaline mintboti välimus. Saad hiljem Seadetest enda forgi peale üle minna.

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:

  1. Töölaualt ava Seaded → API juurdepääs.
  2. Klõpsa Loo võti. Võtme tekst kuvatakse ainult üks kord — salvesta see oma saladuste haldusse.
  3. (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. Neli kohustuslikku välja on:

  1. Telegrami boti token (või muu boti pakkuja)
  2. DNS API võti (nt Zone.ee võti + kasutajanimi)
  3. Mallihoidla URL
  4. Peadomeen

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 mallihoidla testid on rohelised.

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.