Správa vašich uživatelů a jejich předplatných

Jako vlastník BuddyPro instance máte k dispozici několik užitečných příkazů, které vám umožní získávat informace o vašich platících (i zkušebních) uživatelích a spravovat jejich přístupy či zprávy.

23.0: Celkové statistiky a analytika

Jako vlastník (owner) nebo člen týmu použít příkaz /stats. Tento příkaz zobrazí přehledný report, který obsahuje sekci USER ANALYTICS s klíčovými metrikami:

• Total users: Celkový počet uživatelů (bez owneta a týmu).
• Active subscriptions: Počet uživatelů s aktivním placeným předplatným.
• Currently on trial: Počet uživatelů, kteří jsou aktuálně ve zkušebním období (nebo ho již dokončili a nekoupili si tarif).
• Avg used trial messages per user: Průměrný počet zpráv, které uživatelé využijí v rámci trialu.
• Avg AI cost per trial user: Průměrné náklady na jednoho uživatele v trialu.

Tento příkaz je ideální pro získání rychlého přehledu o zdraví a růstu vaší uživatelské základny.

Nová metrika ve /stats: Průměrné měsíční náklady na uživatele

Do příkazu /stats jsme přidali novou hodnotu:

• Average monthly cost per active user (Průměrné měsíční náklady na jednoho uživatele s aktivním předplatným)

Tato metrika Vám ukáže, jaká je průměrná výše nákladů na AI za jednoho uživatele, který má aktivní předplatné.

ℹ️ Jak se počítá:

• zahrnuti jsou pouze uživatelé, kteří mají předplatné aktivní alespoň 7 dní,
• výpočet probíhá měsíčně a je orientační,
• metrika je k dispozici od 11. srpna 2025.

23.1 Jak získat detailní informace o konkrétním uživateli a jeho předplatném?

Pokud potřebujete zjistit podrobnosti o konkrétním platícím uživateli (například stav jeho předplatného, datum příští platby nebo kolik mu zbývá zpráv), použijte příkaz:

/getInfoAboutUser:{subscriptionId}

• {subscriptionId}: Toto je unikátní identifikátor předplatného daného uživatele ve vašem platebním systému.
  • Pokud používáte FAPI, {subscriptionId} je ID periodické faktury tohoto uživatele. Najdete ho ve vašem FAPI účtu v sekci Šablony pravidelných faktur.
  • Pokud používáte Stripe, {subscriptionId} je ID předplatného tohoto uživatele. Najdete ho ve Stripe Dashboardu

Jaké informace vám tento příkaz zobrazí?

Příkaz obvykle poskytne přehled o:

• Stavu předplatného (např. aktivní, zrušené, problém s platbou).
• Datumu příští plánované fakturace/obnovy předplatného.
• Aktuálním počtu zbývajících zpráv v rámci jeho měsíčního limitu.
• Počtu zbývajících extra zpráv (pokud si nějaké dokoupil v balíčku).
• Informacích o použitém tarifu.
• Historii jeho plateb a aktivací.

Tento příkaz je velmi užitečný pro řešení dotazů od klientů ohledně jejich účtu nebo pro investigaci případných problémů s předplatným.

23.2 Jak deaktivovat předplatné nebo přístup uživatele k vaší AI instanci?

Mohou nastat situace, kdy potřebujete uživateli okamžitě ukončit přístup k vašemu AI Expertovi (např. na jeho žádost, při porušení podmínek, nebo pokud mu vracíte peníze za předplatné). K tomu slouží příkaz:

/disableUser:{subscriptionId}

• Opět použijte {subscriptionId} z vašeho platebního systému (ID periodické faktury z FAPI atd.).

Tento příkaz okamžitě ukončí aktivní předplatné daného uživatele v systému BuddyPro a zamezí mu v dalším odesílání zpráv vaší AI instanci.

⚠️ VELMI DŮLEŽITÉ UPOZORNĚNÍ: Pokud uživateli vracíte peníze za jeho předplatné přímo ve vašem platebním systému (např. vystavíte dobropis ve FAPI a vrátíte platbu), musíte VŽDY POTÉ použít i tento příkaz /disableUser v BuddyPro! Samotné vrácení peněz ve FAPI (nebo jiném systému) automaticky neukončí přístup uživatele k AI v BuddyPro. Bez použití /disableUser by mohl uživatel službu nadále využívat, i když jste mu vrátili platbu.

Platforma BuddyPro se snaží automaticky deaktivovat uživatele, pokud jejich pravidelná platba za předplatné opakovaně selže a není včas uhrazena, ale pro manuální zásahy je tento příkaz nezbytný.

23.3 Jak přidat uživateli bonusové (extra) zprávy nad rámec jeho tarifu?

Pokud chcete některému platícímu uživateli (např. jako odměnu, kompenzaci nebo pro speciální účely) přidat určitý počet extra zpráv, které nebudou expirovat a budou se čerpat až po vyčerpání jeho standardního měsíčního limitu, použijte příkaz:

/giveExtraMessages:{subscriptionId}:{extraMessages}

• {subscriptionId}: Identifikátor předplatného uživatele (viz výše).
• {extraMessages}: Počet extra zpráv, které chcete uživateli přidat (např. 50, 100).
  • Můžete zde zadat i zápornou hodnotu (např. 20), pokud byste z nějakého důvodu potřebovali uživateli extra zprávy odebrat (např. pokud jste mu je omylem přidali dříve).

23.4 Manuální správa zkušebních (trial) zpráv pro existující (ale dosud neplatící) uživatele

Tyto příkazy slouží k úpravě počtu zkušebních (trial) zpráv pro uživatele, kteří jsou buď ve zkušebním období, nebo jim již vypršel, ale dosud si nezakoupili placené předplatné. Například pokud chcete věrnému fanouškovi prodloužit trial nebo poskytnout více zpráv pro důkladnější otestování.

K použití těchto příkazů potřebujete znát unikátní Telegram ID daného uživatele ({userId}).

• Jak zjistit {userId}? Nejjednodušší je požádat daného uživatele, aby do chatu s vaší AI instancí napsal a odeslal příkaz:

  /myid

  Vaše AI instance mu pak jeho {userId} zobrazí. Toto ID si od něj vyžádejte.

• Příkazy pro správu zkušebních zpráv:

  • /setTrialMessages:{userId}:{count}
    • Nastaví nový celkový počet zkušebních zpráv pro uživatele s daným {userId} na hodnotu {count}. Pokud měl předtím nějaké zkušební zprávy, tato hodnota je přepíše.
    • Funguje pouze pro uživatele, kteří dosud nikdy nezačali platit předplatné.
  • /addTrialMessages:{userId}:{count}
    • Přidá zadaný počet {count} zkušebních zpráv k aktuálnímu zůstatku zkušebních zpráv uživatele s daným {userId}.
    • Pokud chcete odebrat zkušební zprávy, můžete zde použít záporné číslo pro {count}.
    • Opět funguje pouze pro dosud neplatící uživatele.

23.5 Sledování využití vašich pozvánkových kódů

Pokud pro akvizici nových uživatelů používáte specifické pozvánkové odkazy vygenerované příkazem /generateBuddyProInvite (viz bod 20.6), můžete sledovat jejich úspěšnost. Použijte příkaz:

/checkInvite:{code}

• {code}: Zadejte přesný 7místný kód pozvánky, jehož statistiky chcete zobrazit (ten, který jste si definovali, nebo který vám BuddyPro vygeneroval).

Co vám příkaz zobrazí?

• Kolikrát byla tato konkrétní pozvánka celkem použita (kolik uživatelů přes ni přišlo).
• Kolik z těchto uživatelů si následně zakoupilo placené předplatné (konverzní poměr).
• Kolik uživatelů z této pozvánky je aktuálně stále ve zkušebním (trial) období.
• Průměrný počet zpráv, které uživatelé z této pozvánky využili během svého trialu.
• Průměrné AI náklady na jednoho uživatele v trialu přicházejícího přes tuto pozvánku.

Tento příkaz je velmi užitečný pro vyhodnocování efektivity vašich různých marketingových kampaní, affiliate partnerů nebo různých typů nabídek zkušebních verzí.

23.6 Přehled využitých pozvánek

Kromě příkazu /checkInvite:{code}, který prověřuje konkrétní pozvánkový kód, máte nyní k dispozici také příkaz:

• /listInvites

Tento příkaz Vám vypíše všechny pozvánky, které byly využity dvěma nebo více lidmi.

U každé pozvánky zároveň uvidíte, kolik z těchto uživatelů si aktivovalo předplatné.

👉 Díky tomu snadno zjistíte, které pozvánky jsou nejefektivnější a přinášejí reálné konverze na platící uživatele.

23.7 Rozšířená statistika aktivity uživatelů

BuddyPro nově nabízí rozšířený přehled aktivity vašich předplatitelů pomocí příkazu:

/stats

Tento příkaz nyní nezobrazuje pouze základní informace, ale také denní, týdenní a měsíční aktivitu uživatelů (active rate).

Co ve statistikách uvidíte:

• počet aktivních uživatelů za den
• počet aktivních uživatelů za týden
• počet aktivních uživatelů za měsíc
• přehled celkové aktivity předplatitelů v čase

Statistiky vám pomohou lépe:

• vyhodnocovat zapojení uživatelů
• sledovat dopad změn v onboardingu nebo obsahu
• optimalizovat cenové tarify a komunikaci
• rozhodovat o dalším rozvoji vaší BuddyPro instance

ℹ️ Poznámka:

Příkaz /stats je určen primárně pro majitele BuddyPro instance a slouží jako analytický nástroj pro dlouhodobou správu a růst vašeho AI experta.

---

---