Kihagyás

MintOffice

A MintOffice a mintbot.ai Brand Partner portálja. Lehetővé teszi, hogy a mintbotot a saját márkád alatt értékesítsd tovább: a saját domaineden, a saját botoddal, a saját ügyféllistáddal — miközben a háttérben a mintbot intézi a telepítést, a számlázási csatornákat és az ügynökönkénti infrastruktúrát.

Az élő partnerportál a mint.mintbot.ai címen érhető el.

Ez az útmutató végigvezet az „épp most hallottam a MintOffice-ról” állapottól egészen addig, hogy „az első white-label ügynököm él a saját domainemen”. A technikai részeket (DNS-rekordok, GitHub-repó, bot token) érdemes a nevedben egy mintbot ügynökre bízni — mielőtt belevágsz, nézd meg a Bízd egy ügynökre a beállítást szakaszt.

Magad építenéd meg az integrációt?

A fejlesztői oldalról — hogy mely repókat birtoklod, hogyan fut a telepítési folyamat elejétől a végéig, és hogyan illeszkedik egymáshoz az ügynök testreszabási repója és a webáruház — lásd a MintOffice — Technikai oldalt.

Mit kapsz

  • A mintbot összes csomagját (Trial, Starter, Pro, Max) a saját domaineden értékesítheted tovább — az ügyfeleid az agent1.yourbrand.com címet látják, nem a *.mintbot.ai címet.
  • Használhatod a saját Telegram botodat (@yourbrand_bot) a csevegésforgalomhoz, vagy a tesztelés alatt kölcsönkérheted a mintbot botját.
  • Te döntöd el az ügyfeleknek szóló árakat, és zsebre teszed a különbözetet aközött, amit tőlük kérsz, és amit a mintbot számláz neked (a MintOffice nagykereskedelmi alja).
  • Egy Brand Partner API a programozott rendelésfelvételhez, az életciklus állapotának lekérdezéséhez, valamint a saját rendszereidbe visszahívó webhookokhoz.
  • Egy vezérlőpult, amely az aktív ügyfélrendeléseket, a bot-kapcsolatok állapotát, az árazást, a kifizetéseket és a webhookok kézbesítését mutatja.

Árazás — Brand Partner beállítási díj

A próbaverziós portálfiók ingyenes regisztrációja — nos — ingyenes, de a Brand Partner regisztráció az egyetlen fizetés, amely valódi brand partner fiókká alakítja. Az egyszeri beállítási díjat a reception.mintbot.ai/mintoffice címen fizeted meg (vagy a reception.mintbot.dev/mintoffice címen a fejlesztői/teszt környezethez), és ugyanaz a fizetés mindkét portált feloldja:

Csomag Ár Mit tartalmaz
Ingyenes próba (minden új partner alapja) €0 10 eldobható DEV telepítés a portálod + a sablonod teszteléséhez
Brand Partner — bevezető akció €49 egyszeri + €10/hó 20 DEV telepítés (egyenként €1 ügynökkredittel), az első hónap fiókkezelése benne van, Brand Partner státusz mind a mint.mintbot.ai, mind a mint.mintbot.dev portálon, alapos beállítási útmutató (egy ügynök az egész varázslót végigviheti helyetted)
Brand Partner — alap €99 egyszeri + €10/hó Ugyanaz, mint a bevezető — az akció nélkül

A regisztráció bétában van

A Brand Partner fizetés jelenleg a fejlesztői/teszt környezetben nyitott (reception.mintbot.dev/mintoffice). Az élő .ai fizetés hamarosan elérhető lesz.

Mit fedez a beállítási díj:

  • 20 DEV telepítés, mindegyik egy 24 órás, eldobható teszt-VPS, amely €1 ügynökkredittel van feltöltve — épp elég ahhoz, hogy a portálodat és a testreszabási sablonodat elejétől a végéig kipróbáld.
  • A fiókkezelés első hónapja (a lentebbi €10/hó díj) — így az első hónap már ki van fizetve.
  • Brand Partner státusz mind a mint.mintbot.ai, mind a mint.mintbot.dev portálon.

A €10/hó fiókkezelési díj:

A második hónaptól kezdve a Brand Partner fiók €10/hó fiókkezelési díjjal jár. Ezt a legegyszerűbben egy Stripe- vagy PayPal-előfizetéssel fizetheted (ajánlott — magától megújul); az egyszeri beállítási díj bankkártyával vagy kriptóval is rendezhető (BTC, XMR és számos érme a CCPayment-en keresztül).

Ha a havidíj lejár, a MintOffice fiókod paused állapotba kerül: nem telepíthetsz új ügynököket, de a meglévő ügyfélügynökeid tovább futnak. Mielőtt bármi leállna, jelentkezünk, hogy folytathasd.

Mi történik, miután fizetsz:

  1. A reception feldolgozza a beállítási fizetést a reception.mintbot.ai/mintoffice címen (vagy a .dev címen, ha a teszt környezetben vagy) — kártya / Apple Pay / Google Pay, vagy kriptó.
  2. A reception azonnal aláírt engedélyt küld mind a mint.mintbot.ai, mind a mint.mintbot.dev portálnak, és mindkét portálon Brand Partner státuszra állítja a fiókodat.
  3. Kapsz egy üdvözlő e-mailt a pigeon@mintbot.ai címről (vagy a pigeon@mintbot.dev címről, ha a teszt környezetben vásároltál), amely tartalmazza mindkét bejelentkezési linket és egy mutatót erre az útmutatóra.
  4. Jelentkezz be azon a portálon, amelyikkel kezdeni szeretnél. Ha a környezetek közötti továbbítás valamiért épp az egyik portált kihagyná, az adott portálon az első bejelentkezéskor a rendszer megkérdezi a receptiontől, hogy „fizetett-e ez az e-mail-cím?”, és az engedélyt rögtön alkalmazza.

A bevezető akció alapból be van kapcsolva, amíg a MintOffice-t kigördítjük; ezt a MINTOFFICE_SETUP_PROMO szerverkapcsoló vezérli, így a fizetésnél látott ár az az ár, amelyet fizetni fogsz.

Visszatérítések

14 napos visszatérítési ablak, kérdés nélkül — ha a csomag nem éri meg a te felhasználási eseted szempontjából, írj a support@mintbot.ai címre, és visszaküldjük a díjat.

Az ügynökönkénti nagykereskedelmi árazás (az a díjszabás, amelyet a mintbot számláz neked minden egyes általad lekötött ügyfélrendelésért) független a beállítási díjtól, és lentebb, az 5. lépés — Árazás szakaszban szerepel.

Bízd egy ügynökre a beállítást

A technikai munka java része — egy domain megvásárlása, a DNS beállítása, egy Telegram bot létrehozása, a sablonrepó forkolása — gépies. Megteheted kézzel is, de a legegyszerűbb út az, ha egy mintbot ügynökre bízod.

Ajánlott út

Indíts el egy mintbot ügynököt, és kérd meg: „Állíts be MintOffice brand partnerként a yourbrand.com domain alatt — vezess végig az onboarding varázslón, és tölts ki helyettem mindent, amit tudsz.”

Az ügynöknek van hozzáférése egy terminálhoz, egy böngészőhöz, egy DNS API-hoz, GitHub-hitelesítéshez, és ismeri ezt az útmutatót. Pontosan megmondja, melyik lépéshez van szükség a beavatkozásodra (pl. a BotFather megerősítésének rákattintása a Telegramban), a többit pedig elintézi.

A saját Hermes példányod, egy OpenCode / OpenClaw telepítés, a Cursor agent módja vagy bármely más kódoló ügynök ugyanígy megfelel — add oda neki ezt az oldalt kontextusként, és mondd meg a célt.

Ha inkább magad vezetnéd a varázslót, az alábbi lépések pontosan azt írják le, amit az ügynök is tenne.

0. lépés — Hozd létre a fiókodat

  1. Nyisd meg a mint.mintbot.ai oldalt.
  2. Írd be azt az e-mail-címet, amelyet operátor-bejelentkezésként szeretnél használni.
  3. Kattints a Küldjetek bejelentkezési linket gombra.
  4. Nyisd meg a pigeon@mintbot.ai címről érkező e-mailt, és kattints a varázs- linkre (24 órán át érvényes, egyszer használatos).

Nincs jelszó — minden további bejelentkezés egy újabb varázslink. Ez szándékos: a jelszavak kiszivárognak, a varázslinkek nem, ráadásul egy ügynök később könnyen automatizálhatja őket, ha beállítasz neki e-mail-hozzáférést.

1. lépés — Domain

A varázsló első kérdése az, hogy hol fognak élni az ügynökeid. Két lehetőséged van:

Az ügynökök egy általad birtokolt domain aldomainjein élnek — pl. agent1.yourbrand.com, agent2.yourbrand.com, … Ez az a márkás élmény, amelyet az ügyfeleid látnak.

Szükséged lesz:

  • Apex domain — egy bejegyzett, csupasz domain (https:// nélkül, aldomain nélkül): yourbrand.com.
  • DNS-szolgáltató — jelenleg csak a Zone.ee rendelkezik működő backenddel. A Cloudflare és a kézi mód az ütemtervben szerepel.
  • Zone.ee API-kulcs + felhasználónév — a my.zone.eu oldalon → Account settings → API keys → Create new key. Az ügynök ezt használja, hogy automatikusan létrehozza az A-rekordokat, amikor ügynököt provizionálsz.

Az aldomainek számozási stílusa

  • Szöveges előtag + szám (alapértelmezett) — agent1.yourbrand.com, agent2.yourbrand.com, … A legolvashatóbb ember számára.
  • Csak szám — 1.yourbrand.com, 2.yourbrand.com, … Rövid.
  • Szám, nullával feltöltve — 001.yourbrand.com, … Állandó szélességű.

A választás pusztán kozmetikai — a telepítő worker mindhárommal jól elboldogul.

Az ügynökök a *.mintbot.ai címen élnek — semmi beállítás, semmi DNS, de a URL nem viseli a márkádat. Hasznos a próbálgatáshoz; az ügyfelek felé történő indulás előtt válts a saját domainedre.

2. lépés — Bot

Minden ügynök kap egy csevegőfelületet. Az alapértelmezés a Telegramot feltételezi — a Discord és a Slack vázként megvan, de még nincsenek bekötve.

Az ügyfeleid a @yourbrand_bot-tal csevegnek, ami megőrzi a márkát.

  1. Nyisd meg a @BotFather-t a Telegramban.
  2. Küldd el a /newbot parancsot. Adj a botnak megjelenítendő nevet és felhasználónevet (kötelezően bot-ra végződik).
  3. A BotFather egy 123456789:AA… alakú tokent ad vissza (legalább 40 karakter).
  4. Másold be ezt a tokent a varázslóba.

Ha a hosszabb verzióra kíváncsi vagy, nézd meg a Telegram bot oktatóanyagát.

Az ügyfelek a @mintbot_dev_bot-tal csevegnek. Gyors egy demóhoz, de márka nélküli. Indulás előtt válts a saját botodra.

Hagyd ki teljesen a Telegramot. Az ügyfelek csak a webes panelen keresztül érik el az ügynököket. Botot később is hozzáadhatsz a Beállításokból.

3. lépés — Ügynök testreszabási repó

Minden ügynököt egy szabványos, márka nélküli alapra telepít maga a mintbot. Ahhoz, hogy a te márkádat tedd rá — persona, panel téma, szövegek, bármilyen extra eszköz —, a varázslót egy ügynök testreszabási repóra irányítod: egy GitHub-repóra, amelyet az ügynök saját VPS-e a szabványos telepítés után klónoz és futtat. Te döntöd el a megjelenést; tiéd a kód.

Hogyan működik az ügynök testreszabási repója

A repó gyökere két szkriptet tartalmaz:

  • install.sh — egyszer fut le az ügynök VPS-én, miután a szabványos telepítés befejeződött és az ügynök egészséges. Itt alkalmazod a testreszabásodat: téma, persona-finomítások, extra eszközök, bármilyen ügyfélspecifikus beállítás.
  • update.sh — opcionális; minden alapcsomag-frissítés után lefut, így újra ráteheted a saját rétegedet a frissen frissített alapra.

A mintbot soha nem futtatja a repódat — csak az ügynök saját VPS-e teszi, az ügyfél saját gépén. Másold be a repód GitHub HTTPS URL-jét a varázslóba; ha üresen hagyod, a csupasz, márka nélküli alapot kapod.

Hozz létre egy repót, amelynek a gyökerében egy install.sh (és opcionális update.sh) található, ami alkalmazza a CSS-edet / szövegeidet / personádat, majd másold be a repó GitHub HTTPS URL-jét. Az ügynök VPS-e a telepítés után klónozza, és lefuttatja a szkriptjeidet, hogy ráhúzza a márkádat az alapra.

Egy hibás szkript nem teheti tönkre az ügyfeled ügynökét

A szkriptjeid hibatűrően el vannak szigetelve. Ha az install.sh vagy az update.sh hiányzik, hibára fut vagy lassú, a telepítés akkor is sikerül, az alapcsomag-frissítés sosem akad el és nem áll vissza, az ügynök pedig egészséges marad. A hiba a VPS-en naplózódik, és neked jelenik meg — soha nem a végfelhasználónak. Egy hibás szkript egyetlen hátránya az, hogy az ügynök a csupasz alapon marad a márkás réteged helyett, ezért előbb egy DEV telepítésen teszteld a repódat.

Csupasz, márka nélküli alapstílus és persona — nincs ügynök testreszabási repó. Repó-URL-t később is hozzáadhatsz a Beállításokból.

4. lépés — API

A Brand Partner API lehetővé teszi, hogy az ügynökök létrehozását a saját backendedből vezényeld, ahelyett hogy a vezérlőpultot használnád. A varázsló alapból kihagyja az API beállítását — hagyd későbbre, hacsak nem állsz készen arra, hogy most integráld.

Amikor készen állsz:

  1. A vezérlőpulton nyisd meg a Settings → API access menüpontot.
  2. Kattints a Generate key gombra. A nyílt szöveg egyszer jelenik meg — tárold a titokkezelődben.
  3. (Opcionális) Állíts be egy webhook URL-t az életciklus-események fogadásához.
  4. (Opcionális) Generálj egy webhook aláíró titkot, amint a fogadód készen áll az aláírások ellenőrzésére.

A teljes végpontlistáért és a webhook-üzenetek alakjáért lásd a Brand Partner API referenciát.

A webhook URL és az aláíró titok opcionális

Egyik sem szükséges az értékesítés megkezdéséhez — a vezérlőpult és az API jól működik nélkülük. A webhook URL mező üresen marad, amíg nincs egy https://<your-host>/... címre mutató fogadód; az aláíró titok csak akkor hasznos, ha már beállítottad ezt a URL-t, és ellenőrizni szeretnéd az X-Mintbot-Signature fejlécet. Mindkettő bármikor hozzáadható (vagy cserélhető) a Settings → API access menüből.

Hagyd, hogy egy integrációs ügynök fedezze fel a beállítást

Amint van API-kulcsod, egy ügynök meghívhatja a GET /api/v1/settings végpontot, hogy egy lépésben kiolvassa a teljes, nem titkos konfigurációdat — domain, DNS-szolgáltató, bot, ügynök testreszabási repó, aldomain-minta, árazás, készenlét. Soha nem ad vissza titkot (a tokenek és kulcsok csak *_set logikai értékként jelennek meg), így a kulcs nyugodtan megosztható azzal az ügynökkel, amelyik a white-label beállításodat telepíti egy friss szerverre.

Hagyd ki a sablonkódot — forkold a referenciaportált

Egy teljes, futtatható példa-webáruház a mintbot-ai/partner-portal-example címen él. A teljes bemutatóért lásd a lentebbi Referenciaportál szakaszt.

5. lépés — Árazás

A varázsló utolsó lépése az, hogy az ügyfeleid mennyit fizetnek csomagonként. A MintOffice két módra bontja az árazást — később a Settings → Pricing menüben válthatsz:

Az ügyfelek a mintbot által ajánlott árat látják csomagonként (Trial, Starter, Pro, Max). A partneri árrésedet az ajánlott ár és a nagykereskedelmi alj közötti különbözeten szerzed — nulla beállítással. Ezt válaszd, ha csak el akarsz kezdeni értékesíteni.

Te állítod be, mennyit fizet minden ügyfél az egyes csomagokért. Minden centet zsebre teszel a nagykereskedelmi alj fölött. Ezt válaszd, ha tudatos felárazási stratégiád van.

A nagykereskedelmi alj az, amit a mintbot számláz neked rendelésenként — ez az abszolút minimum, amennyit kérhetsz. A partneri részesedésed rendelésenként customer_price − wholesale_floor. A varázsló a beküldés előtt előnézetet ad a számított árrésekről csomagonként.

Az egyedi árazás lehet részleges

Még egyedi módban sem kell minden csomagot felülírnod — hagyj egy csomagot alapértelmezetten, és örökli a mintbot ajánlott árát. Csak azokat szerkeszd, amelyek számítanak neked.

Élesítés

A varázsló után a vezérlőpulton egy szalag listázza a még hiányzó kötelező adatokat. A három kötelező mező:

  1. Telegram bot token (vagy egy másik bot-szolgáltató)
  2. DNS API-kulcs (pl. Zone.ee kulcs + felhasználónév)
  3. Apex domain

Az ügynök testreszabási repó URL-je opcionális — hagyd üresen, és az ügynökeid a csupasz, márka nélküli alapra települnek.

Amint a kötelező mezők ki vannak töltve és a DNS-szolgáltató ellenőrzése sikeres, a Go Live gomb aktívvá válik. A rákattintás onboarding → live állapotba billenti a partnerstátuszodat, és a Brand Partner API elkezdi fogadni a rendeléslétrehozási kéréseket.

Az aktiválás egyirányú kézfogás

A fiókod onboarding állapotban marad, amíg a Go Live gombra nem kattintasz. Onboarding közben az API 403-mal elutasítja az írásokat (az olvasások nyitva maradnak, hogy meg tudd vizsgálni az állapotot). Ne aktiválj, amíg a domained DNS-e nincs igazolva a Zone.ee-ben, és (ha használsz ilyet) le nem tesztelted a testreszabási repódat egy DEV telepítésen.

A Go Live után: a domain + Telegram bot beállítások lezárulnak

Amint a partnerstátuszod live, a Beállítások Domain és Telegram bot szakasza csak olvashatóvá válik. A meglévő ügyfélügynökök már a te apex domainedre mutatnak és a botodon keresztül csevegnek — egy csendes változtatás menet közben árván hagyná őket. A többi szakasz szerkeszthető marad:

Szakasz Szerkeszthető live közben?
Domain / DNS / aldomain-minta Nem — ha migrálnod kell, fordulj a támogatáshoz
Telegram bot Nem — ha migrálnod kell, fordulj a támogatáshoz
Ügynök testreszabási repó Igen — az új ügynökök az új repó-URL-t klónozzák; a meglévő ügynökök a következő alapfrissítéskor az update.sh-n keresztül újrafuttatják
API-kulcs / webhook Igen — bármikor cserélhető
Árazás Igen — a jövőbeli rendelésekre vonatkozik

A zárat mind a felületen érvényesítjük (a fieldset letiltva, szalag magyarázza, miért), mind a szerveren (a /settings végpontra section=domain vagy section=bot mezővel küldött POST-ok 403-at adnak vissza).

Webhookok + kifizetések

  • Webhook-kézbesítések — minden életciklus-esemény (rendelés létrehozva, aktiválva, lejárva) elküldésre kerül a Beállításokban megadott webhook URL-re. A vezérlőpult partnerenkénti Webhook health jelvénye az elmúlt 24 óra kézbesítési sikerarányát mutatja.
  • Bevételi főkönyv — minden fizetett rendelés ír egy sort a bruttóddal, a részesedéseddel és a mintbot részesedésével. A vezérlőpult megjeleníti az élettartam-összesítéseket és a kifizetetlen egyenleget.
  • Kifizetések — felhalmozódnak. A mintbot csapata kézzel fizeti ki őket a partnermegállapodás szerint; a vezérlőpult követi a fizetett és a kifizetetlen státuszt.

Referenciaportál

Ha nem akarsz a nulláról webáruházat építeni, forkold a hivatalos példát: mintbot-ai/partner-portal-example. MIT-licencelt FastAPI + SQLite + Docker, egy kitalált „AcmeAI” márkázással érkezik, amelyet lecserélhetsz, és lefedi a teljes kört elejétől a végéig:

  • nyitóoldal csomagkártyákkal,
  • /buy űrlap → POST /api/v1/orders → Stripe checkout átirányítás,
  • köszönő / megszakítás visszatérő oldalak,
  • POST /webhooks/mintoffice az HMAC aláírás-ellenőrzővel,
  • HTTP-Basic-auth /admin eseménybrowser,
  • /healthz életjel-szonda.

Beállítási bemutató

  1. Forkold a repót, hogy a márkázási változtatásaidat gitben tarthasd:

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

  2. Töltsd ki a .env-et a MintOffice vezérlőpultod értékeivel:

    Változó Mi kerül ide
    PARTNER_BRAND Az ügyfél által látható márkanév (egyben a Stripe tételsor címkéje is).
    MINTOFFICE_API_URL https://mint.mintbot.ai éleshez, https://mint.mintbot.dev teszteléshez.
    MINTOFFICE_API_KEY API-kulcs a Settings → API access menüből (mo_live_… formátum).
    MINTOFFICE_WEBHOOK_SECRET Webhook aláíró titok, amely a létrehozáskor egyszer jelenik meg ugyanazon a vezérlőpulton.
    PUBLIC_BASE_URL Az a HTTPS URL, amelyen a portálod élni fog (a Stripe success_url / cancel_url felépítéséhez).
    ADMIN_USERNAME / ADMIN_PASSWORD Basic-auth kapu az /admin-on. Használj hosszú, véletlenszerű jelszót.

  3. Futtasd — a Docker a legegyszerűbb út; a bare-metal is működik:

    docker compose up --build

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

  4. Tedd elérhetővé HTTPS-en — a MintOffice elutasítja a http://-t mind a Stripe átirányítási URL-ekhez, mind a webhook URL-hez (a privát IP-ket és a localhost-ot az SSRF-védelem blokkolja). Helyi fejlesztéshez használj Cloudflare Tunnelt, Tailscale Funnelt vagy ngrokot. Élesben telepítsd a saját hosztodra.

  5. Irányítsd a partnersorodat a portálra — vissza a vezérlőpulton:

    • Állítsd be a Webhook URL-t a https://<your-host>/webhooks/mintoffice címre.
    • Ennyi. Adj le egy tesztrendelést a /buy-ról, és figyeld, ahogy az események megérkeznek az /admin-ba.

Újramárkázás

Az alapértelmezett sablonok AcmeAI-nak adják ki magukat. Három érintkezési pont:

  • PARTNER_BRAND a .env-ben — beáramlik a Stripe-ba, a fejlécekbe, a láblécekbe.
  • app/templates/base.html — CSS-változók a színekhez / kiemeléshez.
  • app/templates/*.html — szövegek és oldalankénti elrendezés. A fordítások (észt, spanyol, …) ezeknek a fájloknak a forkjaiként élnek.

Gyors telepítés ugyanarra a VPS-re, mint az ügynökeid

A példaportál elég kicsi ahhoz, hogy a MintOffice telepítő ügynököd mellett fusson. Ha már van egy mintbot ügynök VPS-ed, kérd meg: „Telepítsd a partner-portal-example-t webhook-fogadóként a https://portal.<my-domain>/ cím alatt, töltsd ki a MINTOFFICE_API_KEY-t és a MINTOFFICE_WEBHOOK_SECRET-et a GET /api/v1/settings-ből, és állítsd be a webhook URL-t a partnersoromon.” Az ügynöknek megvannak a dokumentumai és az API-kulcs útvonala ahhoz, hogy ezt elejétől a végéig elvégezze.

Brand Partner API

A programozott ügynöklétrehozáshoz, az állapot lekérdezéséhez és a webhook-eseményekhez lásd a Brand Partner API referenciát. A tágabb architektúráért (hogyan illeszkedik egymáshoz a webáruházad, az API, a telepítő worker és minden egyes ügyfél ügynök-VPS-e) lásd a MintOffice — Technikai oldalt.