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.

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

  • Příkaz:

    /setDefaultSubscriptionUrl:{URL_adresa_prodejni_stranky_nebo_formulare}

  • Vysvětlení parametru:

    • {URL_adresa_prodejni_stranky_nebo_formulare}: Nahraďte skutečnou webovou adresou. Může to být:
      • URL vaší prodejní stránky, kde představujete tarify a odkud se uživatel může prokliknout k objednávce (např. na Stripe nebo FAPI formulář).
      • Přímo URL adresa vašeho hlavního prodejního formuláře (např. ve Stripe nebo FAPI) pro základní předplatné.

  • 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 20.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}

    • Příklad výsledné URL, na kterou je uživatel přesměrován: Pokud zadáte /setDefaultSubscriptionUrl:https://www.mujweb.cz/ai-expert-tarify, uživatel může být ve výsledku přesměrován na adresu jako:
      • https://www.mujweb.cz/ai-expert-tarify?userId=123456789 (pokud používáte FAPI)
      • https://www.mujweb.cz/ai-expert-tarify?client_reference_id=123456789 (pokud používáte Stripe)

20.2 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šší.

  • Příkaz:

    /setUpgradeSubscriptionUrl:{URL_adresa_stranky_s_upgrade_nebo_balicky}

  • Vysvětlení parametru:

    • {URL_adresa_stranky_s_upgrade_nebo_balicky}: Nahraďte skutečnou webovou adresou. Může to být:
      • URL stránky, kde nabízíte možnost přejít na vyšší tarif předplatného (pokud máte více úrovní).
      • URL stránky, kde si uživatelé mohou zakoupit jednorázové balíčky extra zpráv.
      • Přímo URL adresa prodejního formuláře (např. ve FAPI) pro nejčastěji dokupovaný balíček nebo pro upgrade.

  • 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 setDefaultSubscriptionUrl, i zde BuddyPro automaticky přidává parametr userId nebo client_reference_id pro identifikaci.

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

Pokud URL adresy, které jste nastavili pomocí příkazů /setDefaultSubscriptionUrl nebo /setUpgradeSubscriptionUrl, 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áže 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):

    • Nejčastějším a spolehlivým řešením je použití následujícího jednoduchého JavaScriptového kódu, který vložíte do HTML hlavičky (<head>) vaší stránky s rozcestníkem.
    <script src="https://cdn.jsdelivr.net/gh/buddy-fm/buddy-public@latest/userparam.js"></script>
    • Tento skript automaticky detekuje parametry userId nebo client_reference_id v URL, se kterou uživatel přišel na váš rozcestník.
    • Při kliknutí na tlačítko (odkaz) na této stránce poté skript tyto parametry dynamicky přidá k cílové URL daného tlačítka (tedy k odkazu na konkrétní FAPI/Stripe formulář).
note

🚨

Odkazy musí vést přímo na FAPI formuláře, musí být tedy ve tvaru https://form.fapi.cz/?id=…, jinak tento skript fungovat nebude.

Pokud máte pro jednotlivé formuláře svoji vlastní stránku, např. https://www.mujweb.cz/predplatne-500-zprav, https://www.mujweb.cz/predplatna-1000-zprav, bude potřeba vytvořit vlastní skript. Návod najdete v tomto videu.

Postup vložení JavaScript kódu:​

  • U Miowebu: Přejděte na stránku s rozcestníkem > Vlastní kódy > Přidat kód pro tuto stránku v hlavičce
  • U jiných systémů: postupujte podle možností vašeho redakčního systému

A poté ověřte, že když do url adresy vašeho rozcestníku přidáte na konec ?userId=123456, tak odkazy na prodejní formuláře pak také budou obsahovat tento parametr ?userId=123456

Testování funkčnosti:​

  • Otevřete URL vašeho rozcestníku a přidejte parametr (např. https://vašweb.cz/tarify?userId=12345)
  • Klikněte na libovolné tlačítko tarifu
  • Ověřte, že v nové URL adrese zůstal parametr userId=12345

Alternativní řešení: Pokud nechcete řešit JavaScript, můžete také:

  • Odkazovat přímo na FAPI/Stripe formuláře místo na rozcestník

Takto zajistíte, že když uživatel klikne na jakýkoliv tarif, BuddyPro bude vědět, který uživatel si objednal předplatné, a automaticky mu aktivuje příslušný tarif bez dalšího manuálního propojování.

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

  • Příkaz:


    /setTrialEndedMessage:{text_zprávy_s_tagem_LINK}

  • Vysvětlení parametru:

    • {text_zprávy_s_tagem_LINK}: Nahraďte vaším vlastním textem.
    • NAPROSTO KLÍČOVÉ: Text této zprávy MUSÍ obsahovat speciální zástupný tag <LINK> (přesně takto, s ostrými závorkami). Platforma BuddyPro tento tag automaticky nahradí URL adresou, kterou jste nastavili pomocí příkazu /setDefaultSubscriptionUrl (viz bod 20.1), včetně dynamicky přidaných parametrů userId nebo client_reference_id.

  • 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í! ✨

  • Příklad použití příkazu:

    /setTrialEndedMessage: Zdá se, že vaše zkušební jízda... (viz text výše) ...klikněte zde: <LINK>. Těším se na další inspirativní konverzace! ✨

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

20.5 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 stávajících uživatelů...

  • Příkaz:

    /setInviteTrialMessages:{počet_zpráv}

  • Vysvětlení parametru:

    • {počet_zpráv}: Zadejte číslo (např. 50, 100). Počítají se zprávy v obou směrech (otázky uživatele + odpovědi AI).

  • Výchozí hodnota: Pokud tento příkaz nepoužijete, je standardně nastaveno 100 zpráv.

  • Příklad použití příkazu:(Noví uživatelé přes obecné/neurčené pozvánky dostanou 50 trial zpráv.)

    /setInviteTrialMessages:50

  • Důležité: Tento příkaz 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).

20.6 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}:{timeLimit}

  • 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 vám 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) k tomuto kroku:​

  • Otázka: Co se stane, když nezadám žádnou URL pomocí /setDefaultSubscriptionUrl a uživateli skončí trial?
    • Odpověď: Pokud prodejní URL není nastavena, uživatel po skončení trialu pravděpodobně uvidí pouze obecnou zprávu o konci trialu, ale bez možnosti snadno přejít k předplatnému. Důrazně doporučujeme tuto URL vždy nastavit.
  • Otázka: Mohu použít stejný kód pozvánky ({code}) pro více různých nastavení /generateBuddyProInvite?
    • Odpověď: Kód pozvánky by měl být vždy unikátní.
  • Otázka: Když nastavím /setInviteTrialMessages:50, ovlivní to i pozvánky, které jsem již vygeneroval/a s jiným počtem trial zpráv?
    • Odpověď: Ne, již vygenerované pozvánky pomocí /generateBuddyProInvite mají počet trial zpráv pevně daný v momentě jejich vytvoření. Příkaz /setInviteTrialMessages ovlivňuje pouze nové pozvánky, které vzniknou "obecným" způsobem (zpravidla tak, že váš stávající uživatel pozve nového).
  • Otázka: 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?
    • Odpověď: Ano, i pokud se parametr nepřenese (např. přijde na váš web přímo, ne přes odkaz od BuddyPro), může si zakoupit tarif. Na děkovací stránce a v emailu po zaplacení (nastavených ve FAPI) by měl být vložený aktivační odkaz, který si sám proklikne do Telegramu a tím si službu aktivuje. Předávání userId/client_reference_id však zajišťuje hladší a automatizovanější proces, zejména když uživatel přichází přímo z konverzace s AI Expertem.
Naposledy aktualizováno