MintOffice¶

MintOffice är Brand Partner-portalen för mintbot.ai. Den låter dig sälja mintbot vidare under ditt eget varumärke: din domän, din bot, din kundlista — medan mintbot sköter driftsättning, betalningsflöden och infrastrukturen per agent bakom kulisserna.

Den aktiva partnerportalen finns på mint.mintbot.ai.

Den här guiden tar dig från "jag har precis hört talas om MintOffice" till "min första white label-agent är live på min egen domän". De tekniska delarna (DNS-poster, GitHub-repo, bot-token) hanteras bäst av en mintbot-agent åt dig — se Låt en agent ställa in allt åt dig innan du börjar.

Bygger du integrationen själv?

För den utvecklarvända sidan — vilka repositorier du äger, hur driftsättningsflödet körs från början till slut, och hur agentens anpassningsrepo + butiksfront hänger ihop — se MintOffice — Teknisk.

Vad du får¶

Sälj vidare mintbots Brand Partner-paket (Test 24h, Standard, Performance) under din egen domän — dina kunder ser agent1.yourbrand.com, inte *.mintbot.ai.
Använd din egen Telegram-bot (@yourbrand_bot) för chattrafik, eller låna mintbots bot medan du fortfarande testar.
Välj dina kundvända priser och behåll skillnaden mellan vad du tar betalt av dem och vad mintbot tar betalt av dig (MintOffice grossistgolv).
Ett Brand Partner API för programmatisk orderskapning, livscykelstatus och webhooks tillbaka in i dina egna system.
En instrumentpanel som visar aktiva kundordrar, botlänkens hälsa, prissättning, utbetalningar och webhook-leveranser.

Prissättning — Brand Partner-uppstartsavgift¶

Att registrera ett gratis testkonto i portalen är, ja, gratis — men Brand Partner-registreringen är den enda betalning som gör det till ett riktigt brand partner-konto. Du betalar engångsavgiften för uppstart på reception.mintbot.ai/mintoffice (eller reception.mintbot.dev/mintoffice för dev-/testmiljön) och samma betalning låser upp båda portalerna:

Nivå	Pris	Vad som ingår
Gratis testperiod (standard för varje ny partner)	€0	10 engångs-DEV-deploys för att testa din portal + mall
Brand Partner — lanseringserbjudande	€49 engångs + €10/månad	20 DEV-deploys (€1 agentkredit vardera), första månadens kontohantering ingår, Brand Partner-status på både `mint.mintbot.ai` + `mint.mintbot.dev`, grundlig installationsguide (en agent kan köra hela guiden åt dig)
Brand Partner — standard	€99 engångs + €10/månad	Samma som lanseringserbjudandet — utan kampanjpriset

Registreringen är i beta

Brand Partner-utcheckningen är för närvarande öppen i dev-/testmiljön (reception.mintbot.dev/mintoffice). Den aktiva .ai-utcheckningen öppnar inom kort.

Vad uppstartsavgiften täcker:

20 DEV-deploys, var och en en engångs-test-VPS som lever i 24 timmar och är förladdad med €1 agentkredit — tillräckligt för att köra din portal och anpassningsmall från början till slut.
Din första månad av kontohantering (€10/månad-avgiften nedan) — så månad ett är redan betald.
Brand Partner-status på både mint.mintbot.ai och mint.mintbot.dev.

€10/månad-avgiften för kontohantering:

Från och med månad två bär Brand Partner-kontot en €10/månad-avgift för kontohantering. Det smidigaste sättet att betala den är en Stripe- eller PayPal-prenumeration (rekommenderas — den förnyas av sig själv); engångsavgiften för uppstart kan också betalas med kort eller krypto (BTC, XMR och många mynt via CCPayment).

Om månadsavgiften förfaller flyttas ditt MintOffice-konto till paused: du kan inte driftsätta nya agenter, men dina befintliga kundagenter fortsätter att köra. Vi hör av oss innan något stoppas, så att du kan återuppta.

Vad som händer efter att du har betalat:

Reception behandlar uppstartsbetalningen på reception.mintbot.ai/mintoffice (eller .dev om du är i testmiljön) — kort / Apple Pay / Google Pay, eller krypto.
Reception skickar omedelbart en signerad behörighet till både mint.mintbot.ai och mint.mintbot.dev och växlar ditt konto till Brand Partner-status på båda portalerna.
Du får ett välkomstmejl från pigeon@mintbot.ai (eller pigeon@mintbot.dev om du köpte i testmiljön) som innehåller båda inloggningslänkarna och en hänvisning till den här guiden.
Logga in på vilken portal du än vill börja med. Om cross-env-överföringen av någon anledning skulle missa någon av portalerna, frågar den första inloggningen på den portalen reception "betalade den här e-postadressen?" och tillämpar behörigheten på stället.

Lanseringserbjudandet är aktivt som standard medan vi rullar ut MintOffice; det styrs av serverflaggan MINTOFFICE_SETUP_PROMO, så priset du ser vid utcheckningen är det pris du betalar.

Återbetalningar

14 dagars återbetalningsfönster, inga frågor ställda — om nivån inte är värd det för ditt användningsfall, mejla support@mintbot.ai så skickar vi tillbaka avgiften.

Grossistprissättning per agent (priset mintbot tar betalt av dig för varje kundorder du skapar) är oberoende av uppstartsavgiften och finns under Steg 5 — Prissättning nedan.

Låt en agent ställa in allt åt dig¶

Det mesta av det tekniska arbetet — köpa en domän, konfigurera DNS, skapa en Telegram-bot, forka mallrepot — är mekaniskt. Du kan göra det för hand, men det smidigaste sättet är att delegera det till en mintbot-agent.

Rekommenderad väg

Starta upp en mintbot-agent och be den: "Ställ in mig som MintOffice brand partner under domänen yourbrand.com — guida mig genom onboarding-guiden och fyll i allt du kan åt mig."

Agenten har tillgång till en terminal, en webbläsare, ett DNS-API, GitHub-autentisering och kännedom om den här guiden. Den talar om exakt vilket steg som kräver din inblandning (t.ex. att klicka på BotFathers bekräftelse i Telegram) och sköter resten.

Din egen Hermes, en OpenCode- / OpenClaw-installation, Cursors agentläge eller vilken annan kodningsagent som helst fungerar lika bra — mata den med den här sidan som kontext och berätta målet.

Om du hellre vill köra guiden själv är stegen nedan exakt vad agenten skulle göra.

Steg 0 — Skapa ditt konto¶

Öppna mint.mintbot.ai.
Skriv in den e-postadress du vill använda som din operatörsinloggning.
Klicka på Mejla mig en inloggningslänk.
Öppna mejlet från pigeon@mintbot.ai och klicka på magiclänken (giltig i 24 h, kan bara användas en gång).

Det finns inget lösenord — varje efterföljande inloggning är ännu en magiclänk. Detta är medvetet: lösenord läcker, magiclänkar gör det inte, och de är enkla för en agent att automatisera senare om du ställer in e-poståtkomst.

Steg 1 — Domän¶

Guidens första fråga är var dina agenter ska bo. Du har två val:

Använd min egen domän (rekommenderas)Använd mintbot.ai-subdomän

Agenter bor på subdomäner till en domän du äger — t.ex. agent1.yourbrand.com, agent2.yourbrand.com, … Detta är den varumärkesförsedda upplevelsen dina kunder ser.

Du behöver:

Apex-domän — en registrerad, naken domän (ingen https://, ingen subdomän): yourbrand.com.
DNS-leverantör — Zone.ee är den enda leverantören med automatisk DNS. I läget Manuellt lägger du själv till varje agents A-post; Cloudflare kommer snart.
Zone.ee API-nyckel + användarnamn — utfärdas från my.zone.eu → Account settings → API keys → Create new key. Agenten använder detta för att skapa A-poster automatiskt när du provisionerar en agent.

Stil för subdomännumrering

Textprefix + nummer (standard) — agent1.yourbrand.com, agent2.yourbrand.com, … Mest läsbar för människor.
Endast numeriskt — 1.yourbrand.com, 2.yourbrand.com, … Kort.
Numeriskt, nollutfyllt — 001.yourbrand.com, … Stabil bredd.

Valet är rent kosmetiskt — deploy-arbetaren klarar alla tre.

Agenter bor på *.mintbot.ai — ingen installation, ingen DNS, men URL:en bär inte ditt varumärke. Användbart för att testa lite; byt till din egen domän innan kundvänd lansering.

Steg 2 — Bot¶

Varje agent får en chattyta. Standardvalen utgår från Telegram — Discord och Slack är förberedda men ännu inte kopplade.

Ta med min egen Telegram-bot (rekommenderas)Låna mintbots botIngen bot än

Dina kunder chattar med @yourbrand_bot, vilket bevarar varumärket.

Öppna @BotFather i Telegram.
Skicka /newbot. Ge boten ett visningsnamn och ett användarnamn (måste sluta på bot).
BotFather returnerar en token i formatet 123456789:AA… (minst 40 tecken).
Klistra in den token i guiden.

Se Telegrams bot-handledning om du vill ha den längre versionen.

Kunder chattar med @mintbot_dev_bot. Snabbt för en demo, men utan varumärke. Växla till din egen bot innan lansering.

Hoppa över Telegram helt. Kunder kommer åt agenter endast via webbpanelen. Du kan lägga till en bot senare från Settings.

Steg 3 — Agentens anpassningsrepo¶

Varje agent driftsätts på en standardiserad, varumärkeslös bas av mintbot självt. För att lägga ditt varumärke ovanpå — persona, paneltema, texter, eventuella extra verktyg — pekar du guiden mot ett agentens anpassningsrepo: ett GitHub-repository som agentens egen VPS klonar och kör efter standarddriftsättningen. Du bestämmer utseendet; du äger koden.

Så fungerar agentens anpassningsrepo

Repots rot innehåller två skript:

install.sh — körs en gång på agentens VPS, efter att standarddriftsättningen är klar och agenten är frisk. Det är här du tillämpar din anpassning: tema, personajusteringar, extra verktyg, eventuell klientspecifik installation.
update.sh — valfritt; körs efter varje uppdatering av baspaketet, så att du kan lägga om ditt lager ovanpå den nyligen uppdaterade basen.

Mintbot kör aldrig ditt repo — bara agentens egen VPS gör det, på kundens egen maskin. Klistra in ditt repos GitHub-HTTPS-URL i guiden; lämna det tomt och du får den vanliga varumärkeslösa basen.

Peka på mitt eget anpassningsrepo (rekommenderas)Lämna det tomt

Skapa ett repo med ett install.sh (och valfritt update.sh) i dess rot som tillämpar din CSS / dina texter / din persona, och klistra sedan in repots GitHub-HTTPS-URL. Agentens VPS klonar det efter driftsättning och kör dina skript för att lägga ditt varumärke ovanpå basen.

Ett trasigt skript kan inte ha sönder din kunds agent

Dina skript är felisolerade. Om install.sh eller update.sh saknas, ger fel eller körs långsamt lyckas driftsättningen ändå, uppdateringen av baspaketet blockeras eller återställs aldrig, och agenten förblir frisk. Felet loggas på agentens egen VPS — slutkunden ser det aldrig. Den enda nackdelen med ett trasigt skript är att agenten stannar kvar på den vanliga basen istället för ditt varumärkeslager, så testa ditt repo på en DEV-deploy först.

Vanlig varumärkeslös basstil och persona — inget anpassningsrepo. Du kan lägga till en repo-URL senare från Settings.

Steg 4 — API¶

Brand Partner API:et låter dig orkestrera agentskapande från din egen backend istället för att använda instrumentpanelen. Guiden hoppar över API-konfiguration som standard — lämna det till senare om du inte är redo att integrera nu.

När du är redo:

Från instrumentpanelen, öppna Settings → API access.
Klicka på Generera API-nyckel. Klartexten visas en gång — spara den i din hemlighetshanterare.
(Valfritt) Konfigurera en webhook-URL för att ta emot livscykelhändelser.
(Valfritt) Generera en webhook-signeringshemlighet när din mottagare är redo att verifiera signaturer.

Se Brand Partner API-referensen för den fullständiga listan över endpoints och formen på webhook-payloads.

Webhook-URL och signeringshemlighet är valfria

Inget av dem krävs för att börja sälja — instrumentpanelen och API:et fungerar bra utan dem. Webhooks levereras först när båda är angivna: med en URL men utan signeringshemlighet skickas inga händelser. Det är med hemligheten du verifierar headern X-Mintbot-Signature. Båda kan läggas till (eller roteras) när som helst från Settings → API access.

Låt en integrationsagent upptäcka konfigurationen

När du har en API-nyckel kan en agent anropa GET /api/v1/settings för att läsa hela din icke-hemliga konfiguration i ett svep — domän, DNS-leverantör, bot, anpassningsrepo, subdomänmönster, prissättning, beredskap. Ingen hemlighet returneras någonsin (tokens och nycklar visas bara som *_set-booleaner), så nyckeln är säker att dela med agenten som installerar din white label-konfiguration på en ny server.

Hoppa över standardkoden — forka referensportalen

Ett komplett, körbart exempel på en butiksfront finns på mintbot-ai/partner-portal-example. Se Referensportal nedan för hela genomgången.

Steg 5 — Prissättning¶

Guidens sista steg är vad dina kunder betalar per paket. MintOffice delar upp prissättningen i två lägen — du kan byta senare under Settings → Pricing:

Använd standardprissättningen (rekommenderas)Sätt egna priser per nivå

Kunder ser mintbots rekommenderade pris för varje paket. Du tjänar partnermarginalen mellan det rekommenderade priset och grossistgolvet — ingen installation. Välj detta om du bara vill börja sälja.

Du sätter priset varje kund betalar för varje nivå. Du behåller varje cent över grossistgolvet. Välj detta när du har en medveten påslagsstrategi.

Grossistgolvet är vad mintbot tar betalt av dig per order — det är det absoluta minimum du kan ta betalt. Din partnerandel är customer_price − wholesale_floor per order. Guiden förhandsvisar de beräknade marginalerna per nivå innan du skickar in.

Egen prissättning kan vara partiell

Även i läget egen behöver du inte prissätta varje paket — ett paket utan eget pris faller tillbaka på ett standardpris från mintbot, och API:et flaggar sådana ordrar med pricing_fallback: true.

Gå live¶

Efter guiden visar instrumentpanelen en banner som listar all fortfarande saknad obligatorisk information. Vilka fält som är obligatoriska beror på vilka alternativ du valde:

Telegram-bot-token — om du använder en egen bot
DNS-API-nyckel (Zone.ee-nyckel + användarnamn) — om du använder en egen domän
Apex-domän — om du använder en egen domän
URL:en till anpassningsrepot — bara om du valde ett eget repo i Steg 3; med den vanliga basen behövs den inte.

När de obligatoriska fälten är ifyllda och DNS-leverantörens kontroll går igenom visar instrumentpanelen väntar på aktivering av mintbot-teamet. Det finns ingen Go Live-knapp som du själv trycker på: mintbot-teamet aktiverar ditt konto, vilket växlar din partnerstatus från onboarding → live, och Brand Partner API:et börjar acceptera förfrågningar om orderskapande.

Aktiveringen görs av mintbot-teamet

Ditt konto förblir i onboarding tills mintbot-teamet aktiverar det. Under onboarding avvisar API:et skrivningar med en 403 partner_not_live (läsningar förblir öppna så att du kan inspektera tillståndet). Se före aktiveringen till att din domäns DNS är verifierad i Zone.ee och att du (om du använder ett) har testat ditt anpassningsrepo på en DEV-deploy.

Efter aktivering: inställningarna för domän + Telegram-bot låses

När din partnerstatus är live blir sektionerna Domain och Telegram bot i Settings skrivskyddade. Befintliga kundagenter pekar redan mot din apex-domän och chattar genom din bot — en tyst ändring skulle göra dem föräldralösa mitt i livet. De övriga sektionerna förblir redigerbara:

Sektion	Redigerbar medan `live`?
Domän / DNS / subdomänmönster	Nej — kontakta supporten om du behöver migrera
Telegram-bot	Nej — kontakta supporten om du behöver migrera
Agentens anpassningsrepo	Ja — nya agenter klonar den nya repo-URL:en; befintliga agenter kör om det via `update.sh` vid sin nästa basuppdatering
API-nyckel / webhook	Ja — rotera när som helst
Prissättning	Ja — gäller framtida ordrar

Låset upprätthålls både i gränssnittet (fältgrupp inaktiverad, banner som förklarar varför) och på servern (POST till /settings med section=domain eller section=bot returnerar 403).

Webhooks + utbetalningar¶

Webhook-leveranser — varje livscykelhändelse (order skapad, betald, agent klar, misslyckad, utgången) postas till webhook-URL:en du anger i Settings, signerad med din signeringshemlighet för webhooks.
Intäktsreskontra — varje betald order skriver en rad med din brutto, din andel och mintbots andel. Instrumentpanelen visar livstidstotaler och det obetalda saldot.
Utbetalningar — ackumuleras. Mintbot-teamet betalar ut dem manuellt enligt partneravtal; instrumentpanelen spårar status för betalt kontra obetalt.

Referensportal¶

Om du inte vill bygga en butiksfront från grunden, forka det officiella exemplet: mintbot-ai/partner-portal-example. Det är MIT-licensierat FastAPI + SQLite + Docker, levereras med ett påhittat "ExampleAI"-varumärke som du kan byta ut, och täcker hela loopen från början till slut:

landningssida med planktort,
/buy-formulär → POST /api/v1/orders → omdirigering till Stripe-utcheckning,
tack-/avbrytsidor,
POST /webhooks/mintoffice med HMAC-signaturverifieraren,
HTTP-Basic-auth-händelseläsare på /admin,
/healthz-liveness-probe.

Installationsgenomgång¶

Forka repot så att du kan behålla dina varumärkesändringar i git:

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

Fyll i .env med värden från din MintOffice-instrumentpanel:

Variabel	Vad som ska in här
`PARTNER_BRAND`	Kundvänligt varumärkesnamn (används även som etikett för Stripe-radposten).
`MINTOFFICE_API_URL`	`https://mint.mintbot.ai` för live, `https://mint.mintbot.dev` för test.
`MINTOFFICE_API_KEY`	API-nyckel från Settings → API access (format `mo_live_…`).
`MINTOFFICE_WEBHOOK_SECRET`	Webhook-signeringshemlighet som visas en gång vid skapandet i samma instrumentpanel.
`PUBLIC_BASE_URL`	HTTPS-URL:en din portal kommer att bo på (används för att bygga Stripe `success_url` / `cancel_url`).
`ADMIN_USERNAME` / `ADMIN_PASSWORD`	Basic-auth-grind på `/admin`. Använd ett långt slumpmässigt lösenord.

Kör det — Docker är den enklaste vägen; bare-metal fungerar också:
DockerLokal Python
docker compose up --build
pip install -e . uvicorn app.main:app --reload
Exponera det över HTTPS — MintOffice avvisar http:// för både Stripe-omdirigerings-URL:er och webhook-URL:en (privata IP-adresser och localhost blockeras av SSRF-skyddet). För lokal utveckling, använd Cloudflare Tunnel, Tailscale Funnel eller ngrok. För produktion, driftsätt till din egen värd.
Peka din partnerrad mot portalen — tillbaka i instrumentpanelen:
- Sätt Webhook URL till https://<your-host>/webhooks/mintoffice.
- Det är allt. Lägg en testorder från /buy och se händelserna anlända i /admin.

Ny varumärkesprofilering¶

Standardmallarna låtsas vara ExampleAI. Tre kontaktpunkter:

PARTNER_BRAND i .env — flödar in i Stripe, headers, sidfötter.
app/templates/base.html — CSS-variabler för färger / accent.
app/templates/*.html — texter och layout per sida. Översättningar (estniska, spanska, …) finns som forks av dessa filer.

Snabb driftsättning på samma VPS som dina agenter

Exempelportalen är liten nog att köra bredvid din MintOffice-deploy-agent. Om du redan har en mintbot-agent-VPS, be den: "Driftsätt partner-portal-example som en webhook-mottagare under https://portal.<my-domain>/, fyll i MINTOFFICE_API_KEY och MINTOFFICE_WEBHOOK_SECRET från GET /api/v1/settings, och sätt webhook-URL:en på min partnerrad." Agenten har dokumentationen och API-nyckelvägen för att göra detta från början till slut.

Brand Partner API¶

För programmatiskt agentskapande, statuspollning och webhook-händelser, se Brand Partner API-referensen. För den bredare arkitekturen (hur din butiksfront, API:et, deploy-arbetaren och varje kunds agent-VPS hänger ihop), se MintOffice — Teknisk.