Přeskočit na hlavní obsah

Nastavení klíčových URL adres a parametrů trial verze ve vaší BuddyPro instanci

Aby váš AI Expert věděl, kam má uživatele směrovat v různých fázích (např. po skončení zkušební verze nebo když chtějí upgradovat svůj tarif), a jak má komunikovat základní informace o ceně a podmínkách, musíte ve své BuddyPro instanci nastavit několik důležitých parametrů. Toto nastavení provedete vy jako vlastník instance zasláním specifických příkazů do chatu s vaší BuddyPro instancí v Telegramu.

Všechna níže popsaná nastavení najdete v Dashboardu v sekci Konfigurace.

Nastavení URL adresy pro zahájení předplatného​

Tato URL adresa bude uživateli nabídnuta například po skončení jeho zkušebního (trial) období, nebo pokud projeví zájem o placenou verzi vašeho AI Experta.

  • Vysvětlení parametru: URL adresa, kam bude uživatel přesměrován pro zahájení předplatného.
  • Jak to funguje: Když uživateli skončí trial a pokusí se odeslat další zprávu, váš AI Expert mu zobrazí vámi definovanou zprávu (viz bod 18.4) a v ní bude odkaz právě na tuto URL.
  • Automatické přidání parametrů k URL: BuddyPro k vámi zadané URL adrese automaticky přidá na konec unikátní parametry, které pomáhají identifikovat konkrétního uživatele a vaši instanci. Pro FAPI je to ve formátu: ?userId={ID_uzivatele}, pro Stripe ve formátu ?client_reference_id={ID_uzivatele}.

Nastavení URL adresy pro upgrade předplatného nebo dokoupení balíčku extra zpráv​

Tato URL adresa bude uživateli nabídnuta, když vyčerpá svůj měsíční limit zpráv a bude chtít pokračovat v používání vašeho AI Experta, nebo pokud máte více úrovní tarifů a uživatel chce přejít na vyšší.

  • Vysvětlení parametru: URL adresa, kam bude uživatel přesměrován pro upgrade nebo dokoupení zpráv.
  • Jak to funguje: Když aktivní platící uživatel vyčerpá svůj měsíční limit zpráv, AI mu nabídne možnost navýšení a odkáže ho na tuto URL.
  • Automatické přidání parametrů k URL: Stejně jako u URL pro spuštění předplatného, i zde BuddyPro automaticky přidává parametr userId nebo client_reference_id pro identifikaci.

Důležité řešení pro rozcestníky s více tarify​

Pokud URL adresy, které jste nastavili pomocí URL pro spuštění předplatného nebo URL pro upgrade/nákup, nevedou přímo na konkrétní prodejní formulář, ale na vaši webovou stránku, která slouží jako "rozcestník" s výběrem z více tarifů nebo balíčků (např. tlačítka "Tarif BASIC", "Tarif PRO", "Balíček 100 ZPRÁV", kde každé tlačítko vede na jiný formulář), musíte technicky zajistit následující:

Parametr userId={ID_uzivatele} (v případě že používáte FAPI) nebo client_reference_id={ID_uzivatele} (v případě že používáte Stripe), který BuddyPro automaticky přidal k URL vašeho rozcestníku, se musí "přenést" i na cílovou URL toho konečného prodejního formuláře, skrze který uživatel nakoupí.

Proč je to důležité? Pokud by se tento parametr ztratil cestou, BuddyPro by po úspěšné platbě ve FAPI (nebo Stripe) nedokázalo automaticky spárovat platbu s konkrétním Telegram uživatelem, který přišel z vaší AI instance. Jeho přístup by se tak neaktivoval automaticky a propojí se pouze tehdy, pokud ručně klikne na odkaz na děkovací stránce nebo v děkovacím e-mailu, což je neefektivní a zhoršuje uživatelskou zkušenost.

Jak automatickou aktivaci technicky zajistit (doporučené řešení pomocí JavaScriptu):

  1. Nejčastějším a spolehlivým řešením je použití jednoduchého JavaScriptového kódu, který vložíte do HTML hlavičky (<head>) vaší stránky s rozcestníkem.

  2. Tento skript automaticky detekuje parametr client_reference_id (nebo userId) v URL, se kterou uživatel přišel na váš rozcestník.

  3. Při kliknutí na jakékoli tlačítko (odkaz) na této stránce skript dynamicky přidá tyto parametry k cílové URL daného tlačítka (tedy k odkazu na konkrétní Stripe nebo FAPI formulář).

  4. Jak tento JavaScriptový kód získat? Vložte tento skript na svou webovou stránku (do hlavičky nebo kamkoli do HTML kódu):

    <script src="https://cdn.jsdelivr.net/gh/buddy-fm/buddy-public@latest/userparam.js"></script>

  5. DŮKLADNĚ OTESTUJTE FUNKČNOST! Otevřete URL vašeho rozcestníku s testovacím parametrem (např. https://mujweb.cz/ai-expert?client_reference_id=12345) a klikněte na tlačítka jednotlivých tarifů. Ověřte, že v adresním řádku prohlížeče (po přesměrování na Stripe formulář) stále vidíte přidaný parametr ?client_reference_id=12345 na konci URL.

Definování textu zprávy po vyčerpání trial verze​

Tato zpráva se automaticky zobrazí uživateli, když se pokusí dále komunikovat s vaším AI Expertem poté, co vyčerpal všechny své zkušební (trial) zprávy.

  • Vysvětlení parametru: Text zprávy, která se zobrazí po vyčerpání trial zpráv.
  • Příklad textu zprávy (inspirace): Zdá se, že vaše zkušební jízda s naším AI Expertem právě dospěla ke svému konci, všechny volné zprávy byly vyčerpány. Ale nezoufejte! Pro neomezený přístup ke všem jeho znalostem, personalizovaným radám šitým na míru a nepřetržité podpoře 24/7 si můžete snadno aktivovat plné členství. Stačí kliknout zde: <LINK>. Těším se na naše další inspirativní konverzace a společné objevování!
  • Výchozí zpráva: Pokud nic nenastavíte, použije se anglická zpráva: "Free trial ended. Please activate your subscription: <LINK>". Důrazně doporučujeme nastavit si vlastní, česky formulovanou zprávu.

Nastavení výchozího počtu trial zpráv pro nové uživatele​

Tento příkaz nastavuje, kolik zkušebních zpráv dostanou noví uživatelé, kteří se k vaší AI instanci připojí prostřednictvím "obecných" pozvánek od majitele licencí.

  • Vysvětlení parametru: Počet trial zpráv pro nové uživatele přes obecné pozvánky.
  • Výchozí hodnota: Pokud tento příkaz nepoužijete, je standardně nastaveno 100 zpráv.
  • Příklad použití příkazu: Nastavení 50 trial zpráv pro nové uživatele přes obecné/neurčené pozvánky.
  • Důležité: Toto nastavení neovlivňuje počet zpráv u pozvánek, které generujete vy sami pomocí příkazu /generateBuddyProInvite – tam si počet trial zpráv definujete pro každou pozvánku individuálně (viz následující bod).

Generování specifických pozvánkových odkazů​

Toto je váš klíčový nástroj pro řízené získávání nových uživatelů, testování a sledování efektivity různých marketingových kampaní nebo partnerských aktivit.

Příkaz​

/generateBuddyProInvite:{trialMessages}:{code}:{usersLimit}

Vysvětlení parametrů​

  • {trialMessages}: Počet zkušebních zpráv (celkem tam i zpět), které získá uživatel připojený přes tento konkrétní pozvánkový odkaz. Zadejte celé číslo (např. 50, 100). Pokud chcete, aby pozvánka vedla přímo k placené verzi bez jakéhokoliv trialu, zadejte 0.
  • {code}: Unikátní 7místný kód pozvánky. Měl by obsahovat pouze VELKÁ PÍSMENA anglické abecedy (A-Z) a číslice (0-9) pro maximální kompatibilitu a čitelnost. Kód pozvánky zároveň umožňuje snadno identifikovat a sledovat, odkud uživatelé přišli (např. kód WEBINAR5 pro účastníky webináře z května, FBADSJUL pro kampaň na Facebooku v červenci).
  • {usersLimit}: Volitelný parametr. Celkový počet možných použití (aktivací) této konkrétní pozvánky. Zadejte celé číslo (např. 1 pro jednorázovou pozvánku pro VIP klienta, 50 pro kampaň s omezeným počtem míst). Pokud tento parametr vynecháte nebo zadáte 0, pozvánka bude mít neomezený počet použití.
  • {timeLimit}: Volitelný parametr. Doba trvání zkušební doby (počet dní) po aktivaci. Pokud je nastaven, zkušební doba končí, když je dosažen buď limit zpráv, nebo časový limit -- podle toho, co nastane dříve. Pokud není nastaven nebo je nastaven na 0, zkušební doba končí pouze při dosažení limitu zpráv.

Jak to funguje​

Po zadání příkazu vám vaše BuddyPro instance vygeneruje unikátní URL odkaz ve formátu podobném tomuto:

https://t.me/VASE_UZIVATELSKE_JMENO_BOTA?start=VASKODPOZVANKY

Tento odkaz pak použijete ve svých marketingových materiálech, e-mailech, reklamách atd.

Příklady použití příkazu​

  • /generateBuddyProInvite:100:STARTNOW:0 -- Vytvoří pozvánku se 100 trial zprávami, kódem STARTNOW a neomezeným počtem použití.
  • /generateBuddyProInvite:0:VIPONLY:10 -- Vytvoří pozvánku bez trial zpráv, vedoucí přímo k nabídce placení, s kódem VIPONLY, pro maximálně 10 uživatelů.
  • /generateBuddyProInvite:75::1 -- Vytvoří pozvánku se 75 trial zprávami, BuddyPro vygeneruje náhodný kód, pouze pro 1 osobu.
  • /generateBuddyProInvite:100:ABCDEFG:5:30 -- Vytvoří pozvánku se 100 trial zprávami, kódem ABCDEFG, pouze pro 5 uživatelů, s platností 30 dní od aktivace.

Často kladené otázky (FAQ)​

Co se stane, když nezadám žádnou URL pomocí URL pro spuštění předplatného a uživateli skončí trial?

Uživatel uvidí zprávu o konci trial verze, ale bez funkčního odkazu na nákup. Proto je důležité tuto URL nastavit ještě před spuštěním trial verze pro uživatele.

Mohu použít stejný kód pozvánky pro více různých nastavení /generateBuddyProInvite?

Ne, každý kód pozvánky musí být unikátní. Pokud chcete různé parametry (jiný počet zpráv), použijte jiný kód.

Když nastavím zprávu po zkušební době, ovlivní to i pozvánky, které jsem již vygeneroval/a s jiným počtem trial zpráv?

Zpráva po trial verzi se zobrazí všem uživatelům, kterým skončí trial – bez ohledu na to, přes jakou pozvánku přišli. Toto nastavení je globální pro celou instanci.

Co když zákazník přijde na můj rozcestník s tarify, ale parametr userId / client_reference_id se ztratí? Může si i tak koupit a aktivovat?

Zákazník si stále může koupit, ale jeho přístup se neaktivuje automaticky. Aktivaci bude muset provést ručně kliknutím na aktivační odkaz na děkovací stránce nebo v emailu. Proto je důležité zajistit přenos parametru pomocí JavaScriptu.