Gå til indholdet

MintOffice

MintOffice er Brand Partner-portalen til mintbot.ai. Den lader dig videresælge mintbot under dit eget brand: dit domæne, din bot, din kundeliste — mens mintbot håndterer udrulning, betalingsinfrastruktur og per-agent-infrastrukturen under motorhjelmen.

Den live partnerportal findes på mint.mintbot.ai.

Denne guide fører dig fra "jeg har lige hørt om MintOffice" til "min første white-label-agent kører live på mit eget domæne". De tekniske dele (DNS-records, GitHub-repo, bot-token) håndteres bedst af en mintbot-agent på dine vegne — se Lad en agent sætte dig op, inden du går i gang.

Bygger du selv integrationen?

For udviklersiden — hvilke repositories du ejer, hvordan deploy-flowet kører fra ende til anden, og hvordan agent-tilpasningsrepoet + storefronten passer sammen — se MintOffice — Teknisk.

Hvad du får

  • Videresælg hver mintbot-pakke (Trial, Starter, Pro, Max) under dit eget domæne — dine kunder ser agent1.yourbrand.com, ikke *.mintbot.ai.
  • Brug din egen Telegram-bot (@yourbrand_bot) til chat-trafik, eller lån mintbots bot, mens du stadig tester.
  • Vælg dine kundevendte priser, og behold forskellen mellem det, du fakturerer dem, og det, mintbot fakturerer dig (MintOffice- engrosgulvet).
  • Et Brand Partner-API til programmatisk ordreoprettelse, livscyklus- status og webhooks tilbage til dine egne systemer.
  • Et dashboard, der viser aktive kundeordrer, bot-link-sundhed, priser, udbetalinger og webhook-levering.

Priser — opsætningsgebyr for Brand Partner

At oprette en gratis prøve-portalkonto er, ja, gratis — men Brand Partner-tilmeldingen er den ene betaling, der gør den til en rigtig brand-partner-konto. Du betaler engangsopsætningsgebyret på reception.mintbot.ai/mintoffice (eller reception.mintbot.dev/mintoffice for dev-/testmiljøet), og den samme betaling låser begge portaler op:

Niveau Pris Hvad der er inkluderet
Gratis prøve (standard for hver ny partner) €0 10 engangs-DEV-udrulninger til test af din portal + skabelon
Brand Partner — lanceringskampagne €49 engangsbeløb + €10/måned 20 DEV-udrulninger (€1 agent-kredit hver), første måneds kontoadministration inkluderet, Brand Partner-status på både mint.mintbot.ai + mint.mintbot.dev, grundig opsætningsguide (en agent kan styre hele guiden for dig)
Brand Partner — standard €99 engangsbeløb + €10/måned Samme som lanceringskampagnen — uden kampagnen

Tilmelding er i beta

Brand Partner-checkout er i øjeblikket åben i dev-/testmiljøet (reception.mintbot.dev/mintoffice). Den live .ai-checkout åbner snart.

Hvad opsætningsgebyret dækker:

  • 20 DEV-udrulninger, hver en 24-timers engangs-test-VPS udstyret med €1 agent-kredit — nok til at gennemkøre din portal og tilpasnings- skabelon fra ende til anden.
  • Din første måned af kontoadministration (€10/måned-gebyret nedenfor) — så måned ét er allerede betalt.
  • Brand Partner-status på både mint.mintbot.ai og mint.mintbot.dev.

Kontoadministrationsgebyret på €10/måned:

Fra måned to og frem bærer Brand Partner-kontoen et €10/måned- kontoadministrationsgebyr. Den nemmeste måde at betale det på er et Stripe- eller PayPal-abonnement (anbefales — det fornyer sig selv); engangs- opsætningsgebyret kan også betales med kort eller krypto (BTC, XMR og mange mønter via CCPayment).

Hvis det månedlige gebyr udløber, flyttes din MintOffice-konto til paused: du kan ikke udrulle nye agenter, men dine eksisterende kundeagenter kører videre. Vi kontakter dig, før noget stopper, så du kan genoptage.

Hvad der sker, når du har betalt:

  1. Reception behandler opsætningsbetalingen på reception.mintbot.ai/mintoffice (eller .dev, hvis du er i testmiljøet) — kort / Apple Pay / Google Pay, eller krypto.
  2. Reception sender straks en signeret bevilling til både mint.mintbot.ai og mint.mintbot.dev, hvilket skifter din konto til Brand Partner-status på begge portaler.
  3. Du modtager en velkomstmail fra pigeon@mintbot.ai (eller pigeon@mintbot.dev, hvis du købte i testmiljøet), der indeholder begge login-links og en henvisning til denne guide.
  4. Log ind på den portal, du vil starte med. Hvis cross-env- skubbet af en eller anden grund skulle ramme forbi en af portalerne, spørger det første login på den portal reception "har denne e-mail betalt?" og anvender bevillingen med det samme.

Lanceringskampagnen er slået til som standard, mens vi ruller MintOffice ud; den styres af serverflaget MINTOFFICE_SETUP_PROMO, så den pris, du ser ved checkout, er den pris, du betaler.

Refunderinger

14-dages refunderingsvindue, ingen spørgsmål stillet — hvis niveauet ikke er det værd for din brugssituation, så skriv til support@mintbot.ai, og vi sender gebyret tilbage.

Engros-per-agent-priser (den sats, mintbot fakturerer dig for hver kundeordre, du minter) er uafhængig af opsætningsgebyret og findes i Trin 5 — Priser nedenfor.

Lad en agent sætte dig op

Det meste af det tekniske arbejde — at købe et domæne, konfigurere DNS, oprette en Telegram-bot, forke skabelonrepoet — er mekanisk. Du kan gøre det i hånden, men den nemmeste vej er at delegere det til en mintbot-agent.

Anbefalet vej

Start en mintbot-agent, og bed den: "Sæt mig op som MintOffice-brand-partner under domænet yourbrand.com — før mig gennem onboarding-guiden og udfyld alt, hvad du kan, på mine vegne."

Agenten har adgang til en terminal, en browser, et DNS-API, GitHub-auth og kendskab til denne guide. Den fortæller dig præcis, hvilket trin der kræver din indgriben (f.eks. at klikke på BotFathers bekræftelse i Telegram) og håndterer resten.

Din egen Hermes, en OpenCode- / OpenClaw-installation, Cursor-agenttilstand eller enhver anden kodningsagent virker lige så godt — giv den denne side som kontekst og fortæl den målet.

Hvis du hellere vil styre guiden selv, er trinnene nedenfor præcis, hvad agenten ville gøre.

Trin 0 — Opret din konto

  1. Åbn mint.mintbot.ai.
  2. Indtast den e-mailadresse, du vil bruge som dit operatør-login.
  3. Klik på Send mig et sign-in-link.
  4. Åbn e-mailen fra pigeon@mintbot.ai, og klik på magic-linket (gyldigt i 24 t, kan kun bruges én gang).

Der er ingen adgangskode — hvert efterfølgende login er endnu et magic-link. Dette er bevidst: adgangskoder lækker, magic-links gør ikke, og de er nemme for en agent at automatisere senere, hvis du opsætter e-mailadgang.

Trin 1 — Domæne

Guidens første spørgsmål er hvor dine agenter skal bo. Du har to valg:

Agenter bor på subdomæner af et domæne, du ejer — f.eks. agent1.yourbrand.com, agent2.yourbrand.com, … Dette er den brandede oplevelse, dine kunder ser.

Du skal bruge:

  • Apex-domæne — et registreret, bart domæne (intet https://, intet subdomæne): yourbrand.com.
  • DNS-udbyder — i øjeblikket har kun Zone.ee en fungerende backend. Cloudflare og manuelle tilstande er på roadmappen.
  • Zone.ee API-nøgle + brugernavn — udstedt fra my.zone.eu → Account settings → API keys → Create new key. Agenten bruger dette til at oprette A-records automatisk, når du provisionerer en agent.

Stil for subdomæne-nummerering

  • Tekstpræfiks + tal (standard) — agent1.yourbrand.com, agent2.yourbrand.com, … Mest læsevenlig.
  • Kun numerisk — 1.yourbrand.com, 2.yourbrand.com, … Kort.
  • Numerisk, nul-udfyldt — 001.yourbrand.com, … Stabil bredde.

Valget er rent kosmetisk — deploy-workeren er tilfreds med alle tre.

Agenter bor på *.mintbot.ai — ingen opsætning, ingen DNS, men URL'en bærer ikke dit brand. Nyttigt til at prøve det af; skift til dit eget domæne før kundevendt lancering.

Trin 2 — Bot

Hver agent får en chat-overflade. Standardindstillingerne antager Telegram — Discord og Slack er stilladset, men endnu ikke koblet til.

Dine kunder chatter med @yourbrand_bot, hvilket holder brandet intakt.

  1. Åbn @BotFather i Telegram.
  2. Send /newbot. Giv botten et visningsnavn og et brugernavn (skal ende på bot).
  3. BotFather returnerer et token i formen 123456789:AA… (mindst 40 tegn).
  4. Indsæt det token i guiden.

Se Telegrams bot-tutorial, hvis du vil have den lange version.

Kunder chatter med @mintbot_dev_bot. Hurtigt til en demo, men ubrandet. Skift til din egen bot før lancering.

Spring Telegram helt over. Kunder får adgang til agenter udelukkende gennem webpanelet. Du kan tilføje en bot senere fra Settings.

Trin 3 — Agent-tilpasningsrepo

Hver agent udrulles på en standard, ubrandet base af mintbot selv. For at sætte dit brand ovenpå — persona, paneltema, tekst, ekstra værktøjer — peger du guiden på et agent-tilpasningsrepo: et GitHub-repository, som agentens egen VPS kloner og kører efter standardudrulningen. Du bestemmer udseendet; du ejer koden.

Sådan virker agent-tilpasningsrepoet

Repo-roden indeholder to scripts:

  • install.sh — kører én gang på agentens VPS, efter standardudrulningen er færdig, og agenten er sund. Det er her, du anvender din tilpasning: tema, persona-justeringer, ekstra værktøjer, enhver klientspecifik opsætning.
  • update.sh — valgfri; kører efter hver opdatering af basispakken, så du kan genanvende dit lag oven på den netop opdaterede base.

Mintbot kører aldrig dit repo — kun agentens egen VPS gør, på kundens egen maskine. Indsæt dit repos GitHub HTTPS-URL i guiden; lad den være tom, og du får den almindelige ubrandede base.

Opret et repo med en install.sh (og valgfri update.sh) i dets rod, der anvender din CSS / dine strenge / din persona, og indsæt derefter repoets GitHub HTTPS-URL. Agentens VPS kloner det efter udrulning og kører dine scripts for at lægge dit brand oven på basen.

Et fejlbehæftet script kan ikke ødelægge din kundes agent

Dine scripts er fejl-isolerede. Hvis install.sh eller update.sh mangler, fejler eller kører langsomt, lykkes udrulningen stadig, basispakke-opdateringen blokeres eller tilbagerulles aldrig, og agenten forbliver sund. Fejlen logges på VPS'en og vises til dig — aldrig til slutkunden. Den eneste ulempe ved et fejlbehæftet script er, at agenten forbliver på den almindelige base i stedet for dit brandede lag, så test dit repo på en DEV-udrulning først.

Almindelig ubrandet base-styling og -persona — intet agent-tilpasningsrepo. Du kan tilføje en repo-URL senere fra Settings.

Trin 4 — API

Brand Partner-API'et lader dig orkestrere agentoprettelse fra din egen backend i stedet for at bruge dashboardet. Guiden springer API-opsætning over som standard — gem det til senere, medmindre du er klar til at integrere nu.

Når du er klar:

  1. Fra dashboardet skal du åbne Settings → API access.
  2. Klik på Generate key. Klarteksten vises én gang — gem den i din secret manager.
  3. (Valgfrit) Konfigurer en webhook-URL til at modtage livscyklusbegivenheder.
  4. (Valgfrit) Generer en webhook-signeringshemmelighed, når din modtager er klar til at verificere signaturer.

Se Brand Partner API-referencen for den fulde endpoint-liste og webhook-payload-formerne.

Webhook-URL og signeringshemmelighed er valgfrie

Ingen af dem er påkrævet for at begynde at sælge — dashboardet og API'et virker fint uden dem. Webhook-URL-feltet forbliver tomt, indtil du har en modtager, der peger på https://<your-host>/...; signeringshemmeligheden er kun nyttig, når du har sat den URL og vil verificere X-Mintbot-Signature-headeren. Begge kan tilføjes (eller roteres) når som helst fra Settings → API access.

Lad en integrationsagent opdage opsætningen

Når du har en API-nøgle, kan en agent kalde GET /api/v1/settings for at læse din fulde ikke-hemmelige konfiguration på én gang — domæne, DNS-udbyder, bot, agent-tilpasningsrepo, subdomæne-mønster, priser, parathed. Ingen hemmelighed returneres nogensinde (tokens og nøgler vises kun som *_set-booleans), så nøglen er sikker at dele med den agent, der installerer din white-label- opsætning på en frisk server.

Spring kedeligheden over — fork referenceportalen

En komplet, kørbar eksempel-storefront findes på mintbot-ai/partner-portal-example. Se Referenceportal nedenfor for den fulde gennemgang.

Trin 5 — Priser

Det sidste trin i guiden er, hvad dine kunder betaler per pakke. MintOffice opdeler priser i to tilstande — du kan skifte senere under Settings → Pricing:

Kunder ser mintbots anbefalede pris per niveau (Trial, Starter, Pro, Max). Du tjener partnermarginen mellem den anbefalede pris og engrosgulvet — nul opsætning. Vælg denne, hvis du blot vil begynde at sælge.

Du sætter den pris, hver kunde betaler for hvert niveau. Du beholder hver eneste cent over engrosgulvet. Vælg denne, når du har en bevidst markup-strategi.

Engrosgulvet er, hvad mintbot fakturerer dig per ordre — det er det absolutte minimum, du kan fakturere. Din partnerandel er customer_price − wholesale_floor per ordre. Guiden viser en forhåndsvisning af de beregnede marginer per niveau, før du indsender.

Brugerdefinerede priser kan være delvise

Selv i brugerdefineret tilstand behøver du ikke at tilsidesætte hvert niveau — lad et niveau stå på standarden, og det arver mintbots anbefalede pris. Rediger kun dem, du går op i.

Gå live

Efter guiden viser dashboardet et banner, der lister enhver stadig manglende påkrævet information. De tre påkrævede felter er:

  1. Telegram-bot-token (eller en anden bot-udbyder)
  2. DNS API-nøgle (f.eks. Zone.ee-nøgle + brugernavn)
  3. Apex-domæne

Agent-tilpasningsrepo-URL'en er valgfri — lad den være tom, og dine agenter udrulles på den almindelige ubrandede base.

Når de påkrævede felter er udfyldt, og DNS-udbyder-kontrollen består, aktiveres knappen Go Live. Et klik på den skifter din partnerstatus fra onboarding → live, og Brand Partner-API'et begynder at acceptere ordreoprettelses-anmodninger.

Aktivering er et envejs-håndtryk

Din konto forbliver i onboarding, indtil du klikker på Go Live. Mens du onboarder, afviser API'et skrivninger med en 403 (læsninger forbliver åbne, så du kan inspicere tilstanden). Aktiver ikke, før dit domænes DNS er verificeret i Zone.ee og (hvis du bruger et) du har testet dit tilpasnings- repo på en DEV-udrulning.

Efter Go Live: domæne- + Telegram-bot-indstillinger låses

Når din partnerstatus er live, bliver Domain- og Telegram bot-sektionerne i Settings skrivebeskyttede. Eksisterende kundeagenter peger allerede på dit apex-domæne og chatter gennem din bot — en stille ændring ville efterlade dem forældreløse midt i livet. De andre sektioner forbliver redigerbare:

Sektion Redigerbar mens live?
Domæne / DNS / subdomæne-mønster Nej — kontakt support, hvis du har brug for at migrere
Telegram-bot Nej — kontakt support, hvis du har brug for at migrere
Agent-tilpasningsrepo Ja — nye agenter kloner den nye repo-URL; eksisterende agenter genkører den via update.sh ved deres næste base-opdatering
API-nøgle / webhook Ja — roter når som helst
Priser Ja — gælder for fremtidige ordrer

Låsen håndhæves både i UI'et (fieldset deaktiveret, banner der forklarer hvorfor) og på serveren (POSTs til /settings med section=domain eller section=bot returnerer 403).

Webhooks + udbetalinger

  • Webhook-leveringer — hver livscyklusbegivenhed (ordre oprettet, aktiveret, udløbet) postes til den webhook-URL, du sætter i Settings. Dashboardets per-partner Webhook health-chip viser leverings- succesrate over de seneste 24 t.
  • Indtægtsbog — hver betalt ordre skriver en række med dit brutto, din andel og mintbots andel. Dashboardet viser livstidstotaler og den ubetalte saldo.
  • Udbetalinger — akkumuleres. Mintbot-teamet udbetaler dem manuelt per partneraftale; dashboardet sporer betalt vs. ubetalt status.

Referenceportal

Hvis du ikke vil bygge en storefront fra bunden, så fork det officielle eksempel: mintbot-ai/partner-portal-example. Det er MIT-licenseret FastAPI + SQLite + Docker, leveres med en fiktiv "AcmeAI"-branding, du kan skifte ud, og dækker hele sløjfen fra ende til anden:

  • landingsside med plankort,
  • /buy-formular → POST /api/v1/orders → Stripe-checkout-omdirigering,
  • tak- / annuller-returnsider,
  • POST /webhooks/mintoffice med HMAC-signaturverifikatoren,
  • HTTP-Basic-auth /admin-begivenhedsbrowser,
  • /healthz-liveness-probe.

Opsætningsgennemgang

  1. Fork repoet, så du kan holde dine branding-ændringer i git:

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

  2. Udfyld .env med værdier fra dit MintOffice-dashboard:

    Variabel Hvad der skal stå her
    PARTNER_BRAND Kundesynligt brandnavn (bruges også som Stripe-linjeelement-etiketten).
    MINTOFFICE_API_URL https://mint.mintbot.ai for live, https://mint.mintbot.dev for test.
    MINTOFFICE_API_KEY API-nøgle fra Settings → API access (format mo_live_…).
    MINTOFFICE_WEBHOOK_SECRET Webhook-signeringshemmelighed vist én gang ved oprettelse i samme dashboard.
    PUBLIC_BASE_URL Den HTTPS-URL, din portal vil bo på (bruges til at bygge Stripe success_url / cancel_url).
    ADMIN_USERNAME / ADMIN_PASSWORD Basic-auth-gate på /admin. Brug en lang tilfældig adgangskode.

  3. Kør det — Docker er den nemmeste vej; bare-metal virker også:

    docker compose up --build

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

  4. Eksponer det over HTTPS — MintOffice afviser http:// for både Stripe- omdirigerings-URL'er og webhook-URL'en (private IP'er og localhost er blokeret af SSRF-vagten). Til lokal udvikling kan du bruge Cloudflare Tunnel, Tailscale Funnel eller ngrok. Til produktion skal du udrulle til din egen host.

  5. Peg din partnerrække mod portalen — tilbage i dashboardet:

    • Sæt Webhook URL til https://<your-host>/webhooks/mintoffice.
    • Det var det. Afgiv en testordre fra /buy, og se begivenhederne ankomme i /admin.

Rebranding

Standardskabelonerne lader som om, de er AcmeAI. Tre kontaktpunkter:

  • PARTNER_BRAND i .env — flyder ind i Stripe, headers, footers.
  • app/templates/base.html — CSS-variabler for farver / accent.
  • app/templates/*.html — tekst og per-side-layout. Oversættelser (estisk, spansk, …) findes som forks af disse filer.

Hurtig udrulning på samme VPS som dine agenter

Eksempelportalen er lille nok til at køre side om side med din MintOffice- deploy-agent. Hvis du allerede har en mintbot-agent-VPS, så bed den: "Udrul partner-portal-example som en webhook-modtager under https://portal.<my-domain>/, udfyld MINTOFFICE_API_KEY og MINTOFFICE_WEBHOOK_SECRET fra GET /api/v1/settings, og sæt webhook-URL'en på min partnerrække." Agenten har dokumentationen og API- nøglestien til at gøre dette fra ende til anden.

Brand Partner-API

For programmatisk agentoprettelse, statusafstemning og webhook-begivenheder, se Brand Partner API-referencen. For den bredere arkitektur (hvordan din storefront, API'et, deploy-workeren og hver kundes agent-VPS passer sammen), se MintOffice — Teknisk.