Gå till innehållet

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 varje mintbot-paket (Trial, Starter, Pro, Max) 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:

  1. Reception behandlar uppstartsbetalningen på reception.mintbot.ai/mintoffice (eller .dev om du är i testmiljön) — kort / Apple Pay / Google Pay, eller krypto.
  2. 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.
  3. 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.
  4. 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

  1. Öppna mint.mintbot.ai.
  2. Skriv in den e-postadress du vill använda som din operatörsinloggning.
  3. Klicka på Send me a sign-in link.
  4. Ö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:

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 — för närvarande har endast Zone.ee en fungerande backend. Cloudflare och manuella lägen finns på vägkartan.
  • 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.

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

  1. Öppna @BotFather i Telegram.
  2. Skicka /newbot. Ge boten ett visningsnamn och ett användarnamn (måste sluta på bot).
  3. BotFather returnerar en token i formatet 123456789:AA… (minst 40 tecken).
  4. 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.

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å VPS:en och visas för dig — aldrig för slutkunden. 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:

  1. Från instrumentpanelen, öppna Settings → API access.
  2. Klicka på Generate key. Klartexten visas en gång — spara den i din hemlighetshanterare.
  3. (Valfritt) Konfigurera en webhook-URL för att ta emot livscykelhändelser.
  4. (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. Fältet för webhook-URL förblir tomt tills du har en mottagare pekad mot https://<your-host>/...; signeringshemligheten är bara användbar när du har angett den URL:en och vill verifiera 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:

Kunder ser mintbots rekommenderade pris per nivå (Trial, Starter, Pro, Max). 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 åsidosätta varje nivå — lämna en nivå på standardvärdet så ärver den mintbots rekommenderade pris. Redigera bara de du bryr dig om.

Gå live

Efter guiden visar instrumentpanelen en banner som listar all fortfarande saknad obligatorisk information. De tre obligatoriska fälten är:

  1. Telegram-bot-token (eller en annan bot-leverantör)
  2. DNS-API-nyckel (t.ex. Zone.ee-nyckel + användarnamn)
  3. Apex-domän

URL:en till anpassningsrepot är valfri — lämna den tom så driftsätts dina agenter på den vanliga varumärkeslösa basen.

När de obligatoriska fälten är ifyllda och DNS-leverantörens kontroll går igenom aktiveras knappen Go Live. Att klicka på den växlar din partnerstatus från onboarding → live, och Brand Partner API:et börjar acceptera förfrågningar om orderskapande.

Aktivering är en enkelriktad handskakning

Ditt konto förblir i onboarding tills du klickar på Go Live. Under onboarding avvisar API:et skrivningar med en 403 (läsningar förblir öppna så att du kan inspektera tillståndet). Aktivera inte förrän din domäns DNS är verifierad i Zone.ee och (om du använder ett) du har testat ditt anpassningsrepo på en DEV-deploy.

Efter Go Live: 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, aktiverad, utgången) postas till webhook-URL:en du anger i Settings. Instrumentpanelens Webhook health-chip per partner visar leveransframgång under de senaste 24 h.
  • 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 "AcmeAI"-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

  1. 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

  2. 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.

  3. Kör det — Docker är den enklaste vägen; bare-metal fungerar också:

    docker compose up --build

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

  4. 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.

  5. 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 AcmeAI. 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.