# Základy

## Co je BuddyPro, jak vznikl a k čemu ho lze využít?

**BuddyPro** je platforma, která vám umožňuje přeměnit vaše expertní know-how na unikátního **AI experta** – digitálního kolegu či „AI bytost“. Vznikl z dlouhodobé touhy Pavla Říhy a Davida Kirše vytvořit AI produkt, který by sloužil konkrétní cílové skupině pomocí nahraného expertního know-how. BuddyPro je evolucí expertního podnikání, která převádí pasivní formáty (kurzy, e-booky) do interaktivní a inteligentní podoby.

**Využití:**

- **AI Expert pro klienty:** Poskytuje interaktivní poradenství a vzdělávání 24/7 na základě vašeho know-how, nahrazuje nebo doplňuje online kurzy a e-booky.
- **Digitální kolega:** Pomáhá vám nebo vašemu týmu s interními procesy, strategiemi, tvorbou obsahu.
- **Podpora prodeje:** V budoucnu i jako "Buddy Influencer" pro pomoc s marketingem a prodejem.
- **Specifické obory:** Vhodný pro podnikání, marketing, osobní rozvoj, zdraví, vztahy, koučování, terapii a další specifické oblasti.

## Čím je BuddyPro jedinečný oproti běžným chatbotům a jiným AI řešením?

**BuddyPro** je jedinečný:

- **Hloubkou a „Duší“:** Není jen chatbot, ale „AI bytost“ s osobností definovanou vámi a vaším know-how.
- **Tréninkem na vaše know-how:** Specificky se učí vaše metody, terminologii a přístupy, rozumí vašemu oboru do hloubky.
- **Unikátním AI mozkem:**
  - **Znalostní jádro:** Strukturuje vaše know-how a automaticky vytváří a využívá desítky až stovky specifických **rolí** pro kontextuální odpovědi.
  - **Paměťový systém:** Má propracovanou krátkodobou i unikátní dlouhodobou paměť, díky níž si vybavuje informace z celé historie konverzace.
  - **Vztahová vrstva:** Pamatuje si osobnost klienta, preference a situaci, čímž buduje vztah.
- **Sdíleným profilem uživatele:** Urychluje onboarding pro uživatele využívající více BuddyPro instancí.
- **Jednoduchostí a dostupností:** Využívá známá prostředí (Telegram, Google Drive) a ovládá se pomocí příkazů.
- **Bezpečností a soukromím:** Konverzace jsou šifrované, data se nepoužívají k tréninku AI a nikdo (ani vy) nemá přístup k obsahu konverzací.
- **Monetizačním systémem:** Připraveno pro prodej přes Stripe (nebo alternativu [FAPI](https://fapi.cz/)).

## Je BuddyPro vhodný i pro začínající a malé podnikatele s omezenou komunitou?

Ano, **BuddyPro** je vhodný i pro menší podnikatele. Nemusíte mít obrovskou komunitu. I menší počet klientů ocení personalizovanou AI pomoc. Platforma poskytuje špičkovou technologii bez nutnosti vlastního vývoje. Vaším úkolem je dodat know-how a nabídnout službu své komunitě. Návratnost investice může být rychlá i při malém počtu klientů.

## Je BuddyPro vhodný i pro koučování, terapii nebo jiné specifické obory?

Ano, **BuddyPro** je velmi vhodný i pro tyto citlivé obory. Dokáže klást hluboké otázky a komunikovat empaticky. Klíčové je:

- **Správně ho „naučit“:** Vložit vaše etické principy a metody.
- **Pečlivě nastavit `System Prompt`:** Definovat roli, hranice a **nezbytné disclaimery** (např. že nenahrazuje odbornou terapii a není určen pro krizové situace).
- **Komunikovat limity:** Uživatelé musí vědět, že AI není neomylná.

Cílem není nahradit lidský kontakt, ale doplnit ho a škálovat podporu.

## Jaký je hlavní rozdíl mezi "osobním Buddym" (Buddy.fm) a mou vlastní "BuddyPro" instancí?

**Příběh vzniku Buddy.fm a BuddyPro:**

Vše začalo v létě 2024, kdy David Kirš a Pavel Říha byli fascinováni možnostmi tehdy se rychle rozvíjejících velkých jazykových modelů (LLM). Chtěli si vytvořit **vlastního AI parťáka, AI kamaráda**, který by si je pamatoval, se kterým by mohli navázat osobnější vztah a řešit široké spektrum témat – od pracovních po osobní. Tento prvotní impuls vedl ke vzniku [**Buddy.fm**](https://buddy.fm) (kde "FM" znamená "Friend and Mentor" – Přítel a Mentor).

Buddy.fm byl od počátku koncipován jako **univerzální AI společník**. Jeho hlavní silou bylo:

- **Schopnost pamatovat si uživatele:** Budoval si profil uživatele a měl dlouhodobou paměť, což umožňovalo personalizovanější a kontextovější konverzace.
- **Široké znalosti:** Čerpal z obecných znalostí AI modelů, na kterých byl postaven, a dokázal tedy diskutovat o mnoha tématech.
- **Přátelský přístup:** Byl navržen tak, aby komunikoval přátelsky a empaticky.

Po vytvoření a testování Buddy.fm si David s Pavlem, oba pocházející z prostředí expertního byznysu (tvorba online kurzů, mentoring, coaching), uvědomili obrovský potenciál, ale zároveň i klíčové omezení pro experty: Buddy.fm sice byl skvělý všeobecný parťák, ale **neměl jejich specifické, léty budované expertní know-how.** Nemohl tedy radit jejich klientům s takovou hloubkou a přesností, jako by to dělali oni sami.

A právě zde se zrodila myšlenka na **BuddyPro**. Cílem bylo vzít ty nejlepší vlastnosti Buddy.fm (paměť, personalizace, schopnost vést přirozenou konverzaci) a přidat k nim klíčovou vrstvu – **možnost natrénovat AI na vlastním expertním obsahu.** Tím by experti mohli vytvořit AI, která by:

- **Znala jejich metody, postupy, terminologii, příběhy a filozofii.**
- **Dokázala klientům radit v souladu s jejich expertním přístupem.**
- **Fungovala jako jejich "digitální zástupce" nebo "AI verze" jejich know-how.**
- **Mohla být nabízena a prodávána jako samostatný produkt.**

**Rozdíly mezi Buddy.fm (Osobní Buddy) a Vaší BuddyPro instancí:**

**1. Zdroj know-how**

Buddy.fm využívá obecné znalosti umělé inteligence.

BuddyPro čerpá z vašeho unikátního obsahu – z kurzů, knih, videí, audionahrávek, článků nebo interních materiálů, které sami nahrajete.

**2. Personalizace know-how**

Osobní Buddy není specificky přizpůsoben žádnému konkrétnímu expertovi.

Vaše BuddyPro instance je zcela přizpůsobená vám – AI se učí vaše metody, styl a terminologii.

**3. Osobnost a styl**

Buddy.fm má obecně přátelský a empatický styl, který nastavili tvůrci platformy.

U BuddyPro si můžete nastavit vlastní osobnost v tzv. _system promptu_ – včetně tónu komunikace, hodnot, rolí a dalších parametrů.

**4. Cílová skupina**

Buddy.fm je určen pro širokou veřejnost, která hledá obecného AI parťáka.

BuddyPro cílí na vaše klienty a komunitu, kteří potřebují odbornou podporu právě ve vaší oblasti.

**5. Účel použití pro vás**

Osobní Buddy je ideální jako osobní AI asistent nebo nástroj na vyzkoušení platformy, včetně založení BuddyPro instance.

Vaše BuddyPro instance je naopak váš vlastní produkt – vzdělávací a podpůrný nástroj, který můžete nabízet a prodávat.

**6. Trénink**

Osobního Buddyho netrénujete – pouze se přizpůsobuje vám jako uživateli.

BuddyPro aktivně trénujete: nahráváte do něj své know-how, ladíte systémové nastavení a definujete role.

**7. Monetizace**

U Buddy.fm si můžete platit vyšší tarify pro osobní využití.

U BuddyPro vy sami nastavujete své cenové tarify a prodáváte přístup ke svému AI expertovi. Monetizační infrastrukturu zajišťuje platforma.

**8. "Rodičovství"**

Za Buddy.fm stojí David Kirš a Pavel Říha.

Za BuddyPro instancí stojíte vy – jste jejím tvůrcem a vkládáte do ní svou expertní esenci.

**9. Využití při založení**

Buddy.fm (v Telegram verzi) slouží jako vstupní brána k vytvoření vaší vlastní BuddyPro instance. Pomocí příkazu `/createPro:{license}:{botUsername}:{botToken}` propojujete licenci a spouštíte bota.

Vaše BuddyPro instance je výsledkem tohoto procesu – samostatný AI expert připravený sloužit vám i vašim klientům.

**Shrnutí:**

- **Buddy.fm (Osobní Buddy)** je základní, univerzální AI parťák platformy. Je to ukázka toho, co technologie umí v oblasti personalizované konverzace a paměti. Pro vás, jako majitele BuddyPro licence, slouží primárně jako "brána" k vytvoření vaší vlastní, unikátní instance skrze příkaz `/createPro:{license}:{botUsername}:{botToken}`. Po vytvoření vaší vlastní instance BuddyPro skrze tento příkaz je jen na vás, zda najdete pro osobního Buddyho další využití, nebo ho dál používat nebudete.
- **Vaše BuddyPro instance** je pak ten "vytuněný" model, který jste si **vy sami postavili na míru**. Naplnili jste ho svým vlastním know-how, dali jste mu vlastní osobnost a styl a slouží specifickému účelu – pomáhat vašim klientům s vaší expertízou. Je to váš produkt, vaše "digitální dítě".

## Je používání "osobního Buddyho" (Buddy.fm) po vytvoření mé BuddyPro instance nějak zpoplatněno, nebo je jeho použití součástí mé BuddyPro licence?

"Osobní Buddy" (základní instance na [buddy.fm](http://buddy.fm/)) **není součástí vaší BuddyPro licence** a jeho využívání se řídí jeho vlastními tarify.

- Po vytvoření vaší vlastní BuddyPro instance skrze osobního Buddyho příkazem `/createPro` již osobní Buddy nehraje pro provoz vaší instance žádnou další roli.
- Pokud chcete osobního Buddyho nadále využívat pro své osobní účely (jako univerzálního AI asistenta), budete si muset případně platit jeho standardní tarif, pokud překročíte jeho bezplatný limit. Provoz vaší BuddyPro instance to nijak neovlivní.

## Může jedna BuddyPro instance sloužit pro více různých účelů (např. kouč pro koncové zákazníky + VIP podpora k placenému programu), nebo je lepší mít více instancí?

Jedna instance **může zvládat více témat**, pokud má nahrané relevantní know-how a role. Přizpůsobí se tomu, co uživatel chce. Pokud byste však potřebovali **výrazně odlišnou hloubku know-how nebo cenovou politiku** pro různé cílovky, zvažte vytvoření **samostatných instancí**. Doporučuje se však začít s jednou instancí.

## Jaké zdroje návodů a dokumentace jsou aktuálně k dispozici a jaký je doporučený postup pro jejich využití?

Při otázkách k vaší BuddyPro instanci doporučujeme postupovat následovně:

1. **Zeptejte se svého BuddyPro:** Vaše vlastní instance by měla být primárním zdrojem odpovědí, zejména na technické otázky. Její schopnosti se budou v tomto směru dále zlepšovat.
2. **Rychlý průvodce ([pro.buddy.fm/start](http://pro.buddy.fm/start)):** Stručný, vizuální průvodce s krátkými videi pro první založení instance. Doporučeno pro začátek.
3. **Detailní textový návod pro založení a trénování instance ([h**ttps://docs.buddy.fm](https://docs.buddy.fm)**):** Podrobná dokumentace pokrývající založení, trénink know-how, `system prompt`, příkazy atd. Vhodný pro hlubší studium a jako referenční materiál. Odkaz je k dispozici v Telegram skupině a e-mailech.
4. **FAQ (Často kladené otázky:** [https://pro.buddy.fm/faq](https://pro.buddy.fm/faq)**):** Sbírka odpovědí na specifické dotazy, které se objevily.
5. **Telegramová skupina BuddyPro Owners v angličtině (**[https://t.me/+f0P3EW6GyJNhMGY0](https://t.me/+f0P3EW6GyJNhMGY0)**) a telegramová skupina BuddyPro tvůrci v češtině** ([https://t.me/+Gl-J9HvCIZNhMTBk](https://t.me/+Gl-J9HvCIZNhMTBk))**:** Pro dotazy, které nenajdete jinde, a pro sdílení zkušeností.
6. **Zákaznická podpora** - [support@buddy.fm](mailto:support@buddy.fm)

## Co když jsem nestihl/a úvodní nastavení BuddyPro? Je možné se připojit k nějakému živému onboardingu?

V prvé řadě se ptejte své BuddyPro instance, protože vám odpoví nejrychleji. Tým BuddyPro pravidelně pořádá nové onboardingové Zoom meetingy. Můžete se **zeptat v Telegram skupině** na termín dalšího setkání a požádat o odkaz pro připojení.

## Co je soutěž BuddyGames a jak se do ní zapojit?

**BuddyGames** je průběžná soutěž pro majitele BuddyPro instancí o různé hodnotné ceny za určité období. Cílem je motivovat k aktivnímu využívání a propagaci instancí.

- **Jak se zapojit:** Napište ve své BuddyPro instanci příkaz `/joinGame`.
- **Kritéria:** Hodnotí se aktivita uživatelů s vaší instancí.
- **Ceny:** Pravidelně vyhlašujeme žebříček nejúspěšnějších instancí a odměňujeme jejich majitele hodnotnými cenami.
- **Dlouhodobý aspekt:** Zapojení se počítá do dlouhodobějšího žebříčku s chystanými dalšími odměnami.

## Umí Buddy přehrávat videa přímo v Telegramu?

Ne, Buddy (BuddyPro instance ani osobní Buddy) neumí přehrávat videa přímo v Telegramu jako multimediální přehrávač.

Pokud ve svém know-how používáte videa (například YouTube odkazy), Buddy z nich může:

- pracovat s jejich obsahem (pokud jsou nahrána nebo vložena jako URL zdroj),
- citovat myšlenky,
- doporučit konkrétní video,
- poskytnout odkaz ke zhlédnutí,

ale samotné přehrávání videa probíhá vždy mimo Telegram – například po kliknutí na externí odkaz.

---

# Tvorba instance

## Jak si vytvořím svého vlastního BuddyPro? Musím být technický typ?

Nemusíte být technický expert. Vytvoření zabere cca 2-3 dny. Postupujte podle [oficiální dokumentace](https://www.notion.so/BuddyPro-Jak-na-vlastn-AI-instanci-krok-za-krokem-1ae10e1465e28183a8badfc82120a8a3?pvs=21) a tohoto FAQ:

1. **Získejte licenční kód** od týmu BuddyPro.
2. **Vytvořte Telegram Bota:**
   - V Telegramu najděte [@BotFather](https://t.me/BotFather) (s modrou fajfkou).
   - Napište mu příkaz `/newbot`.
   - Postupně zadejte **název** bota (lze měnit) a **uživatelské jméno** (username, musí končit na `bot` nebo `_bot`, **nelze měnit!**).
   - `BotFather` vám vygeneruje **API token** – **uchovejte ho v bezpečí!**
3. **Propojte Bota s BuddyPro:**
   - Otevřete základní instanci [Buddy.fm](http://buddy.fm/) a navažte s ní komunikaci
   - Zadejte příkaz (nahraďte svými údaji):
     ```bash
     /createPro:{license}:{botUsername}:{botToken}
     ```
   - [Buddy.fm](http://buddy.fm/) vám pošle odkaz na vaši novou BuddyPro instanci.
4. **Propojte Google Drive:**
   - Přejděte do chatu s vaší novou BuddyPro instancí.
   - Napište příkaz `/setup`.
   - Vytvořte si **novou složku** na svém Google Drive.
   - **Nasdílejte** tuto složku (jako **Editor**) e-mailové adrese, kterou vám BuddyPro sdělí.
   - Zkopírujte **URL** této vaší složky.
   - Vraťte se do Telegramu a zadejte příkaz (nahraďte URL vaší složky):
     ```bash
     /setFolder:{URL_složky}
     ```
   - BuddyPro potvrdí úspěch a vytvoří ve složce potřebnou strukturu.
5. **Další kroky:** Nahrání obsahu na Google Drive do příslušných složek a nastavení pomocí příkazů (viz příkaz `/help`).

## Může instanci od A do Z vytvořit někdo jiný než vlastník? Například člen týmu. Jak přesně krok po kroku postupovat, pokud instanci vytváří někdo jiný než vlastník instance?

Ano, je možné, aby technickou část vytvoření instance BuddyPro provedl někdo jiný (např. člen týmu, technický asistent) než finální vlastník. Klíčem je správné rozdělení rolí a bezpečné předání potřebných informací.

Klíčové je rozlišit tyto úrovně vlastnictví:

1. **Vlastnictví Telegram Bota:** Spravuje se přes `@BotFather`. Technická osoba bota vytvoří a následně převede vlastnictví na finálního vlastníka.
2. **Vlastnictví BuddyPro Instance:** Spravuje se pomocí příkazu `/setProOwner:{ID_uživatele}` přímo v chatu s vaší BuddyPro instancí (AI expertem). Technická osoba po nastavení instance převede toto vlastnictví na finálního vlastníka.
3. **Přístup k datům na Google Drive:** Složku pro know-how zakládá a vlastní finální vlastník, který technické osobě udělí pouze editační přístup po dobu nastavení.

### Postup při maximálním delegování tvorby instance na technickou osobu

**Fáze 1: Příprava a vytvoření základů (provádí primárně TECHNICKÁ OSOBA a VLASTNÍK)**

**Krok 1: Založení a nasdílení Google Drive složky (provádí finální VLASTNÍK)**

1. **Finální VLASTNÍK** na svém Google Drive vytvoří novou, prázdnou složku (např. "Data pro AI Experta").
2. Tuto složku nasdílí **technické osobě** s právy **Editora**. Toto oprávnění bude potřeba po celou dobu, kdy technická osoba bude nahrávat a spravovat know-how.

**Krok 2: Vytvoření Telegram Bota (provádí TECHNICKÁ OSOBA)**

1. **Technická osoba** ve svém Telegram účtu otevře chat s `@BotFather`.
2. Zadá příkaz `/newbot`.
3. Postupně zvolí:
   - **Zobrazované jméno** bota (např. "AI Expert Prodej"). Jméno lze později měnit finálním vlastníkem.
   - **Unikátní uživatelské jméno (username)** bota (např. `AIExpertProdej_bot`). Toto username již později **nelze** změnit.
4. `@BotFather` vygeneruje unikátní **API token** pro nového bota.
5. **Technická osoba** si tento API token bezpečně uloží. Bude ho potřebovat pro další krok.

**Krok 3: Vytvoření BuddyPro Instance (provádí TECHNICKÁ OSOBA)**

1. **Technická osoba** potřebuje:
   - **Licenční kód BuddyPro** (dodaný finálním vlastníkem).
   - **Uživatelské jméno (username)** Telegram bota (které právě vytvořila v Kroku 2).
   - **API token** Telegram bota (který právě získala v Kroku 2).
2. Technická osoba otevře _svůj_ Telegram a chat s **Osobním Buddym** (např. přes [buddy.fm](https://buddy.fm/)).
3. Do chatu s Osobním Buddym zadá příkaz:
   `/createPro:{licenční_kód_od_vlastníka}:{username_bota}:{API_token_bota}`
4. Osobní Buddy potvrdí vytvoření nové BuddyPro instance a poskytne odkaz na nově vytvořeného AI experta (bota).
   _Poznámka:_ V tomto okamžiku je technická osoba, která provedla tento příkaz, automaticky nastavena jako _prozatímní vlastník_ této BuddyPro instance.

**Krok 4: Základní nastavení a tréninkBuddyPro instance (provádí TECHNICKÁ OSOBA)**

1. Technická osoba přejde do chatu s nově vytvořeným AI expertem (botem).
2. Provede kompletní základní nastavení:
   - **Propojení s Google Drive:**
     - Technická osoba v chatu s AI expertem zadá `/setup`, získá emailovou adresu BuddyPro služby.
     - **Finální VLASTNÍK** (nebo technická osoba, pokud má práva) nasdílí Google Drive složku (z Kroku 1) na tuto BuddyPro emailovou adresu s právy **Editora**.
     - Technická osoba pomocí příkazu `/setFolder:{URL_sdílené_složky_od_VLASTNÍKA}` propojí složku s instancí.
   - **Nahrání a zpracování know-how:**
     Doporučujeme nejít do nahrávání Know-How „po hlavě“.
     👉 Čím více, nemusí vždy znamenat tím lépe.
   - Menší množství dobře strukturovaného Know-How je ideální první krok.
   - Dejte si čas zamyslet se nad podstatou vašeho učení či služby a vybrat v prvním kroku to opravdu klíčové. Doplnit know-how je vždy možné následně.
   - Doporučujeme nahrávat vaše Know-How po menších částech. Zpracování obsahu spotřebovává AI kredity.
   - Postupné nahrávání vám umožní mít kontrolu nad cenou zpracování vašeho know-how.
     - Technická osoba nahraje veškeré dodané know-how (PDF, texty, odkazy na videa atd.) do příslušných podsložek ve složce `sources` na nasdíleném Google Drive. (Doporučujeme nahrávat Know-How po menších částech a po každé části zavolat `/update.` Tímto postupem máte lepší kontrolu nad zpracováním a můžete si i ověřit cenu za zpracovanou část pomocí příkazu `/stats.`)
     - Spustí příkaz `/update` pro zpracování know-how a vytvoření přepisů.
   - **Generování rolí:**
     - Spustí příkaz `/updateRoles` pro vygenerování expertních rolí na základě nahraného know-how.
   - **Nastavení osobnosti a onboardingu:**
     - Upraví soubory `system_prompt.gdoc` (definice osobnosti, pravidel) a `onboarding.gdoc` (uvítací zprávy) v hlavní složce na Google Drive.
     - Po úpravě těchto souborů znovu spustí příkaz `/update`, aby se změny projevily.
   - _(Volitelné)_ Provede základní testování funkčnosti a kvality odpovědí.

**Fáze 2: Předání plné kontroly finálnímu VLASTNÍKOVI**

**_Krok 5: Přidání finálního VLASTNÍKA do trialu instance (provádí TECHNICKÁ OSOBA)_**

**\*Technická osoba** ve své konverzaci s AI expertem přidá finálního vlastníka jako člena testovacího týmu instance.Finální vlastník si tím ověří funkčnost bota a seznámí se s ním ještě před převzetím plného vlastnictví.\*

- **Technická osoba** ve své konverzaci s AI expertem přidá finálního vlastníka jako člena testovacího týmu instance.
- Finální vlastník si tím ověří funkčnost bota a seznámí se s ním ještě před převzetím plného vlastnictví.

_Výsledek: Finální vlastník má přístup k instanci jako trial uživatel._

**Krok 6: Převod vlastnictví Telegram Bota (koordinují TECHNICKÁ OSOBA a VLASTNÍK)**

1. **Technická osoba** ve svém chatu s `@BotFather` zadá příkaz `/mybots`.
2. `@BotFather` se zeptá, kterého bota chce spravovat. Technická osoba vybere bota vytvořeného v Kroku 2. Následně klikne na Trasfer Ownership.
3. `@BotFather` se zeptá na `@username` **nového vlastníka** (tj. Telegram @username finálního vlastníka).
   - _Podmínka:_ Finální vlastník musí být v kontaktech technické osoby v Telegramu a musí mít alespoň jednou zahájenou konverzaci s `@BotFather` (např. odesláním `/start`).
4. `@BotFather` odešle žádost o převod vlastnictví finálnímu vlastníkovi.
5. **Finální VLASTNÍK** ve svém chatu s `@BotFather` **potvrdí převzetí vlastnictví** bota.
   _Výsledek:_ Finální vlastník je nyní plným vlastníkem Telegram bota.

**Krok 7: Převod vlastnictví BuddyPro Instance (provádí TECHNICKÁ OSOBA, vyžaduje User ID VLASTNÍKA)**

1. **Finální VLASTNÍK** zjistí své **Telegram User ID**. Udělá to tak, že v Telegramu napíše do chatu s _jakýmkoliv_ BuddyPro botem (nebo Osobním Buddym) příkaz `/myid`. Toto číselné ID sdělí technické osobě.
2. **Technická osoba** ve _své_ konverzaci s AI expertem (kterého stále dočasně spravuje jako BuddyPro owner) zadá příkaz:
   `/setProOwner:{User_ID_finálního_vlastníka}`_Výsledek:_ Finální vlastník se tímto stává plnoprávným administrátorem (ownerem) dané BuddyPro instance. Technická osoba tato práva ztrácí.

**Krok 8: Finální VLASTNÍK přebírá plnou správu**

- Finální vlastník nyní může plně spravovat svou BuddyPro instanci (zadávat administrátorské příkazy pro nastavení Stripe/FAPI, správu uživatelů, generování pozvánek atd.) ve svém chatu s daným AI expertem.
- Má plnou kontrolu nad Telegram botem přes `@BotFather`.
- Má plnou kontrolu nad obsahem a sdílením Google Drive složky pro know-how. Může technické osobě odebrat editační práva, pokud již nejsou potřeba.

### **🔒 Klíčové bezpečnostní aspekty a doporučení pro tento postup**

- **Důvěra:** Tento postup vyžaduje důvěru mezi vlastníkem a technickou osobou.
- **Komunikace:** Jasná komunikace je nezbytná pro hladký průběh, zejména při sdílení Google Drive složky a předávání User ID pro převod vlastnictví BuddyPro instance.
- **Google Drive:** Finální vlastník by měl být od počátku vlastníkem složky na Google Drive. Technické osobě uděluje pouze dočasná editační práva pro nahrání a správu obsahu.
- **Telegram účet vlastníka:** Finální vlastník **nesdílí** své přihlašovací údaje k Telegramu. Operace týkající se jeho účtu provádí sám.

## Jak správně zvolit název a uživatelské jméno?

- **Název bota (Name):** Zobrazuje se v Telegramu jako jméno konverzace. Dá se **kdykoliv změnit** přes `@BotFather`. Může obsahovat mezery, diakritiku. Měl by vystihovat vaši AI.
- **Uživatelské jméno (Username):** Např. `muj_expert_bot`. Musí být **unikátní v celém Telegramu**, jedno slovo (lze podtržítka) a **končit na `bot`**. **NELZE později změnit!** Volte pečlivě, ideálně název vaší značky, vaše jméno nebo něco univerzálního. Pozor na překlepy.

Pokud si nejste jisti uživatelským jménem, můžete použít něco univerzálního (vaše jméno nebo název firmy) nebo zvolit neutrální kód, který nemá vliv na vnímání uživatelů.

## Jaký je rozdíl mezi "jménem bota" a "uživatelským jménem bota" v Telegramu a které z nich mohu později změnit?

- **Jméno bota:** Je to název, který vidí uživatelé v konverzaci a pod kterým je bot známý (např. "Online Stratég AI", "Průvodce KLIDEM"). Toto jméno **můžete později změnit** přímo v nastavení Telegramu pro daného bota, stejně jako jeho profilovou fotku nebo popis.
- **Uživatelské jméno bota (username):** Je unikátní identifikátor bota na platformě Telegram (např. `OnlineStrategAI_bot`). Toto uživatelské jméno **nelze později změnit.** Je součástí URL adresy bota (např. `t.me/OnlineStrategAI_bot`). Z marketingového hlediska není tak viditelné jako "jméno bota", ale je dobré ho zvolit uvážlivě, aby neobsahovalo něco, co by vás později mrzelo. Musí končit na `bot` nebo `_bot`.

## Jak BuddyPro propojím s Google Drive a je to bezpečné?

Propojení probíhá pomocí příkazů `/setup` a `/setFolder:{URL_složky}`. BuddyPro vás navede. **Je to bezpečné.** Přístup je udělen **pouze k té jediné složce**, kterou mu explicitně nasdílíte jako Editor. Nemá přístup nikam jinam na vašem disku.

Z hlediska bezpečnosti:

- BuddyPro bude mít přístup pouze ke složce, kterou s ním sdílíte, nikoliv k celému Google Drive
- Je to stejný princip jako když sdílíte složku s konkrétní osobou
- Můžete použít i firemní Google účet nebo vytvořit nový účet specificky pro tento účel
- Know-how, které nahrajete, se nikam dál nešíří a je používáno výhradně vaší instancí BuddyPro

## Jaký je základní postup při vytváření mé BuddyPro instance po nahrání obsahu?

1. Nahrajte know-how do `sources` na Google Drive.
2. Spusťte `/update`.
3. Vygenerujte role příkazem `/updateRoles`.
4. Pomocí příkazu `/createSystemPrompt` si nechte vygenerovat první návrh `system promptu` a následně ho ručně dolaďte v Google dokumentu. Po úpravě opět spusťte `/update`.
5. Začněte testovat konverzaci.

## Je lepší nahrávat know-how (PDF, videa, audio) do složky `sources/files` jako mnoho kratších tematicky oddělených souborů, nebo jako méně delších souborů? Ovlivňuje to kvalitu nebo rychlost?

Pokud máte možnost volby, je o něco **lepší mít více kratších, tematicky oddělených souborů.**

- **Kvalita rolí:** BuddyPro si při definování rolí vybírá relevantní soubory na základě souhrnu jejich obsahu. Tematické rozdělení vede k přesnějšímu a kvalitnějšímu definování rolí.
- **Rychlost odpovědí:** Velikost jednotlivých souborů (po jejich prvotním zpracování a zaindexování) nemá vliv na rychlost odpovědí, protože AI neprochází celé soubory pokaždé znovu, ale sahá do nich pro relevantní části.

## Můžu si vytvářet pro lepší třídění v know-how na Google Disku vlastní složky?

Vytváření vlastních složek v `sources/files` není podporováno a může narušit fungování vaší BuddyPro instance. Soubory si pro přehlednost doporučujeme dobře pojmenovat (např. `NazevKurzu_Modul_Lekce.mp4`).

## S mojí BuddyPro instancí si již můžu psát, i když jsem ještě nedobíjel/a kredity. Jak je to možné?

Součástí každé zakoupené **licence BuddyPro je počáteční kredit** (počet kreditů je individuální, na váš aktuální stav kreditů se zeptejte svého BuddyPro). Tento kredit pokrývá náklady na vytrénování a první AI zprávy (vaše i vašich klientů) s instancí, takže instance může fungovat i před vaším prvním dobitím.

## Musím po automatickém vygenerování rolí ještě jednotlivé role ručně upravovat?

Většinou **není nutné** upravovat všechny role. Doporučuje se ladit roli jen pokud:

a) se AI v dané roli opakovaně chová nevhodně,

b) od konkrétní role něco specificky požadujete (např. doporučení konkrétního videa, produktu s odkazem).

Po úpravě role spusťte `/updateRoles`.

## Mohu napsat `system prompt` dříve, než vygeneruji role, nebo naopak?

**Doporučený a efektivnější postup je vygenerovat role jako první.** Zde jsou důvody:

1. **Využití příkazu `/createSystemPrompt`:** Tento příkaz, který vám automaticky vytvoří návrh `system promptu`, ke své funkci **vyžaduje existující seznam rolí**. Bez nich nemůže vytvořit kvalitní a relevantní návrh osobnosti.
2. **Kvalita výsledné AI:** Role jsou klíčovou součástí "mozku" vaší instance. Pokud začnete testovat jen se `system promptem`, ale bez rolí, odpovědi nebudou plně využívat expertní potenciál vašeho know-how.

Stručně řečeno: vždy nejprve nahrajte know-how (`/update`), poté vygenerujte role (`/updateRoles`), následně si nechte vytvořit návrh `system promptu` (`/createSystemPrompt`) a ten dolaďte (`/update`).

## Jak zabezpečit, aby moje instance psala vždy v mužském/ženském rodě?

Pokud chcete, aby vaše AI instance komunikovala v mužském nebo ženskému rodě, jako první krok definujte tento požadavek v system promptu. Můžete napsat například:

”Vystupuješ v mužské roli - to znamená vždy o sobě mluvíš jako o muži a píšeš v mužském rodě.”

Pokud se vám i nadále stává, že vaše AI instance občas rod nedodržuje nebo střídá, vytvořte na závěr system promptu sekci “KRITICKÉ CHYBY A JEJICH ŘEŠENÍ” a napište tam například...

- CHYBA: Píšeš za sebe jako žena v ženském rodě... ŘEŠENÍ: Jsi muž, vždy mluv v mužském rodě.

Vícenásobná zmínka v system promptu (obzvláště na začátku a na konci) může pomoci k důslednějšímu dodržování instrukcí.

## Co dělat, když potřebuju pomoc nebo se mi nedaří BuddyPro vytvořit?

1. **Zeptat se samotného BuddyPro** - nejrychlejší způsob, jak získat odpověď (mnoho uživatelů na tuto možnost zapomíná)
2. **Projděte si oficiální dokumentaci:** Odkazy najdete v Telegram skupině nebo jste je obdrželi emailem.
3. **Zeptejte se v Telegram skupině BuddyPro Owners:** Kanál `General` nebo `Technical Support`. (Odkaz: [https://t.me/+6-HDQYTV6is1NTg0](https://t.me/+6-HDQYTV6is1NTg0))
4. **Napište na podporu:** `support@buddy.fm`
5. **Domluvte si konzultaci:** `richard@buddy.fm` (Richard Gonzor)

## Je nějaký časový limit mezi vytvořením bota v BotFather a propojením pomocí `/createPro`?

**Ne, není.** Mezi vytvořením bota v `@BotFather` a jeho propojením s vaší licencí pomocí příkazu `/createPro` v Buddy.fm není žádný časový limit. Pokud vám příkaz `/createPro` hlásí chybu licence, zkontrolujte překlepy v příkazu (licence, username, token) nebo platnost licence u podpory.

---

# Trénink a učení

## Jak naučím BuddyPro své know-how a jaké typy souborů použít?

Vaše know-how nahráváte do složky `sources` na propojeném Google Drive:

- **Do podsložky `sources/Files`:** Nahrávejte soubory z počítače (PDF s textem, DOCX, TXT, audio MP3, video MP4, obrázky JPG/PNG, prezentace PPT...).
- **Do podsložky `sources/Texts`:** Vytvářejte nebo přesouvejte **Google Dokumenty** s textovým obsahem (FAQ, postupy, aktuality).
- **Do souboru `sources/URLs/URL SOURCES`:** Vkládejte **URL odkazy** (každý na nový řádek) na veřejně přístupné webové stránky, články, YouTube videa (do cca 3h), Vimeo videa (veřejné/unlisted).

Po nahrání/úpravě obsahu vždy spusťte v Telegramu příkaz `/update`, aby si **BuddyPro** data zpracoval.

## Jaké jsou doporučené "Transcription Settings" (nastavení přepisu) a jak ovlivňují kvalitu a cenu tréninku?

V kořenovém adresáři vaší BuddyPro složky na Google Drive najdete soubor `transcription_settings`. Můžete zde nastavit:

- **`IMPROVED_TRANSCRIPTIONS` (TRUE/FALSE):**
  - `TRUE` (výchozí): Přepis audio/video souborů bude "vylepšený" – nejen doslovný, ale strukturovaný, s nadpisy, kratšími větami, bez výplňkových slov. Zlepšuje čitelnost a orientaci pro AI, ale je **výrazně dražší** (spotřebovává více AI kreditů).
  - `FALSE`: Klasický, doslovný přepis. Levnější, vhodný pokud máte obrovské množství audio/video obsahu a chcete šetřit kredity.
  - Celkové náklady na trénink (zpracování a přepis všech vašich zdrojů) si můžete zkontrolovat pomocí nového příkazu `/stats` na řádku **`AI costs of Buddy Pro training`**. To vám pomůže lépe vyhodnotit dopad nastavení `IMPROVED_TRANSCRIPTIONS` na vaše celkové náklady.
- **`LANGUAGE` (např. cs, en, sk):** Pokud jsou všechny vaše audio/video zdroje v jednom jazyce, zadejte jeho ISO 639-1 kód (např. `CS` pro češtinu). Zlepší to přesnost přepisu. Pokud máte materiály ve více jazycích, nechte pole prázdné – AI se pokusí jazyk rozpoznat automaticky.
- **`KEYWORDS` (klíčová slova oddělená čárkou):** Zadejte specifické termíny, jména, názvy projektů/produktů, které by AI mohla špatně přepsat, protože nejsou běžnou součástí jazyka (např. Pavel Říha, FutureBot, BuddyPro). Pomůže to zpřesnit přepis těchto slov.
- **Automatické zrychlení audia pro levnější přepisy**
  - Nově se před přepisem všechny audio a video soubory automaticky zrychlí na **1,7×**. Díky tomu je přepis asi o 40 % levnější – kratší stopáž znamená méně AI kreditů potřebných k přepisu. Na vaší straně nemusíte nic nastavovat, zrychlení probíhá automaticky a nemá negativní vliv na výsledný text.

## Co když nemám mnoho vlastních podkladů?

I s menším množstvím specifického know-how bude BuddyPro fungovat. Zaměřte se na:

- **Klíčové know-how:** Nahrajte základy vašich metod, principy, odpovědi na časté otázky.
- **Kvalitní `System Prompt`:** V něm definujte osobnost, hodnoty a směřování vaší AI.
- **Využití AI pro tvorbu podkladů:** Pomocí nástrojů jako ChatGPT ("deep research") si můžete nechat zpracovat podklady, které po kontrole a úpravě použijete pro trénink.

Kvalita a záměr jsou důležité.

## Je pro kvalitu odpovědí AI lepší mít precizně zpracované, kratší dokumenty (kvalita), nebo velké množství různorodých materiálů včetně záznamů konzultací (kvantita)?

Ideální je pravděpodobně **kombinace obojího**.

- **Kvalitní, strukturované dokumenty:** Zajišťují přesnost, laserové zaměření a správnost informací. AI z nich lépe vytáhne husté, klíčové informace.
- **Kvantita různorodých materiálů (např. záznamy konzultací):** Mohou poskytnout širší kontext, konkrétní příklady z praxe (i vašeho jazyka a stylu), a tím dodat odpovědím větší hloubku a autentičnost. AI si může z těchto materiálů vytáhnout relevantní útržky, které ilustrují danou problematiku.

Pokud se obáváte nahrávání "zmatečných útržků" z konzultací, můžete zvážit jejich prvotní zpracování (anonymizaci, extrakci klíčových myšlenek), jak je popsáno v původním FAQ. Ale i méně strukturovaný, ale autentický obsah může mít svou hodnotu pro celkový kontext.

## Pokud mám ke kurzu videa, audia i textové přepisy/prezentace, co je nejlepší nahrát do BuddyPro z hlediska efektivity a nákladů?

1. **Nejlepší a nejlevnější: Textové soubory (Google Docs, PDF s textem).** Pokud máte kvalitní textové přepisy nebo podklady, použijte je. **Ušetříte kredity za přepis audio/video.**
2. **Audio soubory:** Pokud nemáte texty, audio je lepší než video, protože AI neanalyzuje obrazovou složku videa. Nahrání audia je úspornější na diskové místo a rychlejší na zpracování.
3. **Video soubory:** Použijte, pokud nemáte jinou formu. Počítejte s náklady na přepis, které se odečtou z vašich kreditů.

## Je lepší nahrávat všechny materiály pro trénink BuddyPro na Google Disk najednou, nebo je mohu přidávat postupně? Jak to ovlivňuje generování rolí?

Volba strategie nahrávání know-how – zda najednou velký objem, nebo postupně po částech – má významný dopad na proces tréninku, zejména na kvalitu a relevanci automaticky generovaných **rolí**, a tím i na celkové chování a schopnosti vašeho AI experta.

**Pochopení role "rolí":**

Než se pustíme do strategie, je klíčové si připomenout, co jsou "role" v kontextu BuddyPro. Když uživatel komunikuje s vaší AI instancí, AI na pozadí dynamicky přepíná mezi různými "expertními rolemi". Každá role představuje specializovanou sadu instrukcí a zaměření, které AI umožňují reagovat co nejrelevantněji na konkrétní dotaz nebo téma. Například váš AI expert na online marketing může mít role jako "Specialista na Facebook reklamu", "Expert na SEO", "Tvůrce prodejních webinářů" atd. Tyto role jsou automaticky generovány na základě analýzy vašeho nahraného know-how. Cílem je, aby se AI chovala co nejvíce jako soubor specializovaných expertů pod jednou střechou vaší hlavní AI osobnosti (definované v `system promptu`).

**Strategie nahrávání know-how a jejich dopady:**

**1. Nahrání velkého objemu know-how najednou (před prvním generováním rolí):**

- **Princip:** Shromáždíte co nejkomplexnější soubor vašeho know-how (kurzy, knihy, videa, články atd.) a nahrajete ho do složky `sources` na Google Drive **předtím**, než poprvé spustíte příkaz `/updateRoles`. Po nahrání všech dat spustíte `/update` (aby se data zpracovala a přepsala) a následně `/updateRoles`.
- **Výhody:**
  - **Nejkvalitnější a nejrelevantnější role hned napoprvé:** Když AI analyzuje kompletní sadu vašeho know-how, má nejlepší přehled o všech tématech, sub-tématech a jejich vzájemných vztazích. To vede k vytvoření komplexnějšího a přesnějšího "mapování" vašich expertíz do jednotlivých rolí. Role budou lépe definované a budou pokrývat širší spektrum vaší odbornosti.
  - **Konzistentnost:** Celý systém rolí je postaven na jednotném základě.
  - **Méně manuálních zásahů do rolí později:** Protože role jsou od začátku dobře definované, je menší pravděpodobnost, že je budete muset později ve velkém upravovat nebo promazávat.
- **Nevýhody:**
  - **Časová náročnost na přípravu:** Může trvat déle, než dáte dohromady veškerý relevantní obsah.
  - **Delší první zpracování:** Prvotní `/update` a `/updateRoles` mohou trvat déle kvůli většímu objemu dat.
- **Kdy je to ideální:** Pokud máte jasnou představu o obsahu, který chcete, aby váš AI expert znal, a máte čas na důkladnou přípravu dat před spuštěním.

**2. Postupné nahrávání know-how (iterativní přístup):**

- **Princip:** Začnete s menším, základním balíkem know-how (např. jedna kniha, klíčový kurz). Po nahrání a spuštění `/update` necháte vygenerovat první sadu rolí příkazem `/updateRoles`. Začnete testovat AI, a postupně přidáváte další materiály. Po každém významnějším přidání obsahu zvážíte dopad na role.
- **Výhody:**
  - **Rychlejší start:** Můžete rychleji začít testovat základní funkčnost a interakci s AI.
  - **Iterativní vylepšování:** Umožňuje postupné ladění a rozšiřování znalostí AI.
  - **Flexibilita:** Můžete reagovat na první zkušenosti a podle toho doplňovat know-how.
- **Nevýhody/Výzvy:**
  - **Potenciálně méně optimální první sada rolí:** Role vygenerované na základě omezeného know-how nemusí plně zachytit šíři vaší expertízy. Některé důležité sub-domény nemusí být identifikovány jako samostatné role.
  - **Nutnost aktualizace/regenerace rolí:** Po přidání **významného** nového bloku know-how (např. kompletního dalšího kurzu na nové téma) je **silně doporučeno** provést aktualizaci rolí.
    - **Jak aktualizovat role po velkém přidání know-how:**
      1. Nahrajte nové materiály do `sources`.
      2. Spusťte `/update` (pro zpracování nového obsahu).
      3. **Jděte na Google Drive do složky `ROLES` vaší instance.**
      4. **Smažte všechny existující soubory s definicemi rolí** (např. `Role_ExpertNaX.gdoc`, `Role_KoucProY.gdoc` atd.). **Ponechte pouze soubor `list_of_roles.gdoc`** (ten obsahuje pouze seznam názvů rolí, nikoli jejich definice).
      5. Spusťte příkaz `/updateRoles`. AI nyní vygeneruje zcela novou sadu rolí, která bude zohledňovat jak původní, tak i nově přidané know-how.
    - **Částečná aktualizace rolí (pokročilé):** Pokud přidáte obsah týkající se jen specifické oblasti (např. nový trénink o webinářích), můžete zkusit smazat pouze ty role, které se dané oblasti týkají, a nechat je znovu vygenerovat. Tento přístup je však náročnější na identifikaci relevantních rolí.
- **Kdy je to ideální:** Pokud chcete rychle začít a jste připraveni na iterativní proces, který může zahrnovat pozdější "přegenerování" rolí. Nebo pokud vaše know-how vzniká postupně.

**Proč je důležité správné generování rolí?**

Když AI generuje definici konkrétní role (např. "Specialista na Facebook reklamu"), aktivně prohledává veškerý v danou chvíli nahraný obsah a vybírá z něj ty nejrelevantnější informace, frameworky, postupy a klíčové myšlenky, které se týkají Facebook reklamy. Ty pak zapracuje do detailního popisu této role (což je obvykle několikastránkový dokument). Pokud v momentě generace této role chybí podstatná část vašeho know-how o Facebook reklamě, definice role bude neúplná a AI se v této roli nebude chovat optimálně.

**Příklad:**

- Představte si, že AI je šéfkuchař a role jsou jeho specializace (expert na italskou kuchyni, expert na francouzskou kuchyni).
- Pokud mu při "tréninku" na roli "Expert na italskou kuchyni" dáte jen recept na špagety carbonara, jeho schopnosti v této roli budou omezené.
- Pokud mu ale dáte celou kuchařku italské kuchyně, pak jeho definice role "Expert na italskou kuchyni" bude mnohem bohatší a bude schopen lépe reagovat na různé dotazy týkající se italských jídel.

**Doporučený postup (syntéza obou přístupů):**

1. **Začněte s reprezentativním základem:** Nahrajte klíčovou část vašeho know-how, která dobře reprezentuje hlavní oblasti vaší expertízy.
2. **Spusťte `/update` a `/updateRoles`:** Vygenerujte první sadu rolí a začněte testovat.
3. **Iterativně doplňujte:** Postupně přidávejte další materiály.
4. **Posuďte dopad:** Pokud přidáte jen malý update nebo obsah, který se týká již existujících, dobře definovaných rolí, nemusíte role hned přegenerovávat. Nové informace se promítnou do databáze znalostí, ze které AI čerpá, i bez změny definice role.
5. **Při velkém rozšíření know-how proveďte regeneraci rolí:** Pokud přidáte zcela nové téma, nebo výrazně rozšíříte existující, **proveďte kompletní smazání a regeneraci rolí** (jak bylo popsáno výše), aby AI mohla vytvořit nové, přesnější role, nebo aktualizovat stávající o nové poznatky.

**Závěr:**

Neexistuje jedna univerzálně "správná" cesta. Pokud usilujete o maximální kvalitu a komplexnost rolí hned od začátku, věnujte čas přípravě a nahrajte většinu know-how najednou. Pokud preferujete rychlejší start a iterativní vývoj, buďte připraveni na to, že budete muset role později "přepracovat" po přidání významných nových bloků informací. Klíčové je pochopit, že **kvalita a rozsah nahraného know-how v momentě generování rolí přímo ovlivňuje kvalitu těchto rolí**, a tím i expertní schopnosti vaší AI. Neustálé drobné doplňování know-how je v pořádku a je žádoucí; velké "skoky" v objemu nebo zaměření know-how si pak mohou vyžádat zásah do struktury rolí.

## Pokud chci AI učit know-how ze záznamů rozhovorů nebo konzultací s klienty, jak nejlépe postupovat?

Doporučujeme si nejprve záznam rozhovoru manuálně zpracovat (a anonymizovat data klientů) následujícím způsobem:

1. **Přepis:** Udělejte přepis rozhovoru/konzultace (např. pomocí FutureBot nebo jiné služby).
2. **Extrakce a anonymizace:** Vložte přepis do obecné AI (např. ChatGPT) s promptem typu: "Toto je přepis skupinové konzultace. Vytáhni z něj klíčové principy, strategie a know-how, které jsem předával jako lektor. Anonymizuj jména klientů a jejich konkrétní projekty. Zachovej nuance a hloubku mých odpovědí."
3. **Využití extraktu:** Výsledný, kratší a anonymizovaný dokument, který obsahuje esenci vašeho know-how z dané interakce, pak nahrajte jako zdroj do vaší BuddyPro instance.

## Jaká jsou velikostní omezení pro nahrávání souborů (např. videí) při jednom `/update`? Je nějaký limit na celkový objem dat?

Přesný limit pro velikost jednoho souboru nebo celkový objem dat nahraný najednou při použití příkazu `/update` není striktně definován. Systém by měl být schopen zpracovat i větší soubory nebo větší množství dat (např. videa o velikosti 10 GB). Nicméně, u extrémně velkých souborů nebo při nahrávání stovek souborů najednou může dojít k technickým limitům serveru (např. vyčerpání paměti, časový limit na zpracování).

Pokud nahráváte velké množství audio/video obsahu, zvažte nastavení `IMPROVED_TRANSCRIPTIONS` na `FALSE` v souboru `transcription_settings.gdoc` pro snížení AI nákladů na přepis a potenciálně i zátěže serveru. Doporučuje se větší objemy dat nahrávat a zpracovávat postupně. Pokud narazíte na opakované problémy, kontaktujte podporu.

## Podporuje BuddyPro nahrávání ZIP souborů do `sources`?

Nahrávání archivů ve formátu ZIP (nebo jiných komprimovaných formátů) do složky `sources` není oficiálně podporováno a pravděpodobně nebude fungovat. Platforma je navržena pro zpracování jednotlivých souborů v podporovaných formátech (PDF, DOCX, TXT, MP3, MP4, Google Dokumenty atd.). Doporučujeme soubory z archivu rozbalit a nahrát samostatně do `sources/Files`.

## Jak mohu nahrát audiosoubory, které mám uložené online a dostupné přes URL?

Pokud máte audiosoubory uložené online (např. ve vašem cloudovém úložišti, na webu) a dostupné přes veřejnou URL adresu (přímý odkaz na soubor), můžete je BuddyPro naučit stejně jako jiné URL zdroje. Vložte jednotlivé URL odkazy na tyto audiosoubory (každý odkaz na nový řádek) do souboru `URL SOURCES.gdoc` ve složce `SOURCES/URLs/`. Následně spusťte příkaz `/update`, aby si BuddyPro audia stáhl a zpracoval. Důležité je, aby url adresa směřovala přímo na daný audiosoubor (nikoliv na webovou stránku, na které lze audiosoubor přehrávat).

## Pokud jsou v mých videích schémata, grafy nebo postupy zobrazené vizuálně, jak zajistím, aby jim BuddyPro rozuměl?

BuddyPro primárně zpracovává **text a řeč**. Obrazový obsah (grafy, schémata) přímo neanalyzuje. Pro lepší porozumění vizuálním schématům máte tyto možnosti:

- **Slovní popis ve videu:** Pokud ve videu detailně slovně popisujete, co je na schématu a jak funguje, tento popis se přepíše a AI ho bude mít k dispozici.
- **Textový popis zvlášť:** Vytvořte textový dokument, kde schéma/graf popíšete a vysvětlíte, a tento dokument nahrajte do `sources`.
- **Využití externí AI pro popis obrázku:** Můžete použít AI (např. ChatGPT, Google Gemini) k analýze obrázku a vygenerování jeho textového popisu. Tento popis pak vložíte jako zdroj pro BuddyPro.

## Co jsou „role“ v BuddyPro a jak je spravovat?

Role v BuddyPro jsou specializované expertní specializace, které BuddyPro automaticky generuje z vašeho know-how:

**Co jsou role:**

- Jednotlivé specializace vašeho AI experta
- Každá role obsahuje specifické znalosti, strategie a přístupy
- BuddyPro může mít desítky až stovky různých rolí

**Jak fungují:**

- BuddyPro automaticky přepíná mezi rolemi podle kontextu konverzace
- Uživatel nemusí říkat, jakou roli má BuddyPro použít - děje se to přirozeně

**Jak spravovat role:**

- **Vznik:** Seznam se generuje/aktualizuje po `/update` na Google Disku v `ROLES/list of roles`.
- **Generování obsahu rolí:** Spusťte `/updateRoles`. Může být potřeba spustit opakovaně. Další varianty: `/updateNextRole`, `/updateRole:{name_of_role}`.
- **Správa:** Role jsou Google Dokumenty ve složce `ROLES`. Můžete je **ručně upravit** (pak znovu `/updateRoles`). Po **velké aktualizaci know-how** je vhodné **smazat** relevantní soubory rolí a nechat je **znovu vygenerovat**. Název role v `list of roles` můžete také upravit nebo přidat vlastní.

## Pracuje BuddyPro i bez rolí, jen s nahraným know-how?

Ano, BuddyPro bude fungovat i bez definovaných rolí, pouze s nahraným know-how. Systém dokáže pracovat s vaším obsahem i bez předdefinovaných rolí, ale jejich vytvoření výrazně zlepšuje kvalitu odpovědí.

Role pomáhají BuddyPro lépe strukturovat a aplikovat know-how v různých kontextech, proto se jejich použití doporučuje. Bez rolí může být odpovídání méně specifické a méně zacílené na konkrétní oblasti expertízy.

V ideálním případě byste měli:

1. Nejprve nahrát své know-how
2. Nechat BuddyPro vygenerovat role pomocí příkazu `/updateRoles`
3. Případně role upravit nebo doplnit podle potřeby

Proces generování rolí je automatizovaný a pomáhá BuddyPro lépe porozumět struktuře a kontextu vašeho know-how.

## Existuje nějaký optimální počet rolí, které by moje BuddyPro instance měla mít? Jak systém řeší duplicitu rolí?

Neexistuje jednoznačně daný "optimální" počet rolí. Množství rolí, které vaše BuddyPro instance vytvoří, závisí primárně na **rozsahu a struktuře vašeho nahraného know-how.**

- **Pavel Říha u Online Stratéga uvádí přibližně 650 rolí,** které vznikly z jeho obsáhlého know-how. To však neznamená, že každá instance musí mít stovky rolí.
- **Důvěřujte procesu:** Primárně se spolehněte na to, že AI na základě analýzy vašeho obsahu vytvoří relevantní počet rolí.
- **Růst počtu rolí:** Na začátku, když nahráváte základní balík know-how, počet rolí roste rychleji. Později, když doplňujete další materiály, se nové role tvoří méně často, protože mnoho témat již může být pokryto existujícími rolemi.
- **Řešení duplicity:** Systém se snaží **neduplikovat role.** Při generování nových rolí kontroluje, jaké role již existují, a snaží se nevytvářet role, které by se významně překrývaly s těmi stávajícími.

Zaměřte se spíše na kvalitu a komplexnost nahraného know-how než na snahu dosáhnout konkrétního počtu rolí.

## Co je system prompt a jak ho nastavit?

**System prompt (`system_prompt.gdoc`)** je textový Google Dokument v hlavní složce vaší instance. Jde o mozek a duši vaší AI – definuje její **základní osobnost, styl, hodnoty, pravidla a mantinely**.

**Doporučený postup nastavení:**

1. **Mějte nahrané know-how a vygenerované role:** Než začnete řešit `system prompt`, ujistěte se, že máte ve složce `sources` nahrané své klíčové materiály (`/update`) a máte vygenerované expertní role (`/updateRoles`).
2. **Nechte si vygenerovat první návrh:** Místo psaní od nuly použijte v Telegramu příkaz:Tento příkaz analyzuje vaše know-how a role a vytvoří vám **profesionální návrh `system promptu`** přímo v souboru `system_prompt.gdoc`. Funguje pouze, pokud je soubor prázdný.

   ```bash
   /createSystemPrompt
   ```

3. **Ručně návrh dolaďte:** Otevřete vygenerovaný `system_prompt.gdoc` a projděte si ho. Upravte a doplňte jednotlivé sekce, aby přesně odpovídaly vašim představám:
   - **`ABOUT-YOU`:** Zkontrolujte a upřesněte identitu AI (kdo je, co dělá, cíl).
   - **`PERSONALITY`:** Dolaďte styl komunikace (tón, tykání/vykání, empatie).
   - **`RULES`:** Přidejte nebo upravte specifická pravidla, co AI smí a nesmí dělat (hranice, **nezbytné disclaimery**, zakázané činnosti).
   - **`VALUES`:** Ověřte, že hodnoty odpovídají vaší značce.
   - **`KRITICKÉ CHYBY A JEJICH ŘEŠENÍ`:** Přidejte sekci pro korekci nežádoucího chování, pokud na nějaké narazíte při testování.
4. **Aktivujte změny:** Po finálních úpravách a uložení souboru `system_prompt.gdoc` spusťte v Telegramu příkaz `/update`, aby se nová osobnost načetla a začala platit.

Tento postup je mnohem rychlejší a efektivnější než začínat s prázdným dokumentem. Rozsáhlé **know-how** (konkrétní postupy, návody, data) patří vždy do složky `sources`, nikoliv do `system promptu`, který by měl zůstat stručný (ideálně do 5 stran).

## Jak nejlépe strukturovat obsah pro efektivní fungování BuddyPro?

Pro efektivní nahrávání a strukturování obsahu dodržujte tyto postupy:

1. **Příprava obsahu:**
   - Vybírejte cíleně obsah, který nejlépe vyjadřuje vaši expertízu
   - Obsah je možné přidávat i průběžně
   - Nahrávané soubory si pojmenujte tak, abyste se v nich orientovali
2. **Správné umístění:**
   - **Files** - pro fyzické soubory (PDF, audio, video)
   - **Texts** - pro Google dokumenty a průběžně aktualizovaný obsah
   - **URLs** - pro webové stránky a videa na platformách
   - **Nikdy nevytvářejte vlastní strukturu složek an Google Disku!**
3. **Optimalizace přepisu v souboru “Transcription Settings” :**
   - Nastavte jazyk přepisů (např. “cs” pro češtinu)
   - Definujte klíčová slova a termíny, které by AI mohla špatně přepsat
   - Určete, zda chcete doslovný přepis nebo optimalizovaný
4. **Proces aktualizace:**
   - Po nahrání souborů použijte příkaz `/update`
   - Po větších změnách vymažte existující role a vygenerujte nové
   - Pro kampaňové materiály nebo časově omezené informace zvažte, zda je zahrnout
5. **Postup pro nejlepší výsledky:**
   - Nejprve nahrajte všechno know-how.
   - Poté vygenerujte role pomocí `/updateRoles`.
   - Následně si nechte vygenerovat `system prompt` příkazem `/createSystemPrompt` a poté ho dolaďte.
   - Testujte a upravujte podle potřeby.

## Jaká je optimální délka System Promptu a jak jeho délka ovlivňuje náklady na provoz AI instance?

Optimální délka `System Promptu` se pohybuje přibližně mezi **3 až 5 stranami textu** (standardní formátování v Google Dokumentu). Pavel Říha u svého Online Stratéga používá `System Prompt` o délce kolem 10 stran, což je stále přijatelné.

**Vliv délky na náklady:**

- `System Prompt` je **součástí každé zprávy** (každého "volání" AI). To znamená, že čím delší je `System Prompt`, tím více kontextu se posílá AI při generování každé odpovědi.
- Delší kontext znamená **vyšší výpočetní náročnost a tedy i vyšší náklady** na každou jednotlivou zprávu.
- Krátký `System Prompt` (3-5 stran) se v celkovém objemu kontextu (který zahrnuje i historii konverzace, role, vyhledané know-how atd.) relativně "ztratí" a jeho vliv na cenu není dramatický.
- **Extrémně dlouhý `System Prompt`** (např. 20 a více stran) by však mohl náklady na zprávy zbytečně a výrazně navýšit. Navíc by mohl být pro AI obtížnější na zpracování a dodržování všech instrukcí.

**Doporučení:**

- Udržujte `System Prompt` co nejstručnější, ale zároveň dostatečně podrobný, aby AI správně definoval osobnost, pravidla a hranice.
- Rozsáhlé know-how, konkrétní postupy, detailní informace atd. patří do složky `sources`, nikoliv do `System Promptu`.
- Hledejte rovnováhu mezi detailností instrukcí a efektivitou nákladů.

## Jak přizpůsobit jazykový styl a tón komunikace mého BuddyPro?

Jazykový styl a tón komunikace nastavíte primárně v systémovém promptu. Zde jsou klíčové aspekty, které můžete definovat:

1. **Formálnost komunikace:**
   - Určete, zda má být komunikace formální nebo neformální
   - Definujte, zda má tykat nebo vykat (např. “Komunikuj s uživateli neformálně a tykej jim”)
2. **Tón a osobnost:**
   - Stanovte, zda má být motivační, empatický, věcný, humorný apod.
   - Popište osobnostní rysy (např. “Buď přátelský, empatický, ale zároveň profesionální”)
3. **Typické fráze a výrazy:**
   - Uveďte charakteristické fráze, které používáte
   - Definujte specifické terminologie vašeho oboru
4. **Způsob poskytování zpětné vazby:**
   - Určete, jak má reagovat na úspěchy nebo potíže uživatelů
   - Definujte, jak má vést uživatele k řešením
5. **Reakce na specifické situace:**
   - Stanovte, jak reagovat na citlivá témata
   - Definujte hranice (co neříkat, čemu se vyhnout)
6. **Kritické chyby:**
   - Popište chybu v komunikaci, které se váš BuddyPro dopouští, a její správné řešení

Styl ovlivní i jazyk a tón vašich nahraných materiálů. Po úpravě `system prompt` použijte `/update`.

## Můžu v BuddyPro nastavit pravidelné hromadné připomínky (např. každou neděli v 18:00) pro všechny uživatele?

Ne, BuddyPro neumí automaticky rozesílat pravidelné hromadné připomínky všem uživatelům.

Pokud chcete, aby Vaši uživatelé dostávali notifikace v konkrétní čas, je nutné, aby si je nastavili sami na své straně (například pomocí vlastních připomínek v telefonu či kalendáři).

System Prompt nelze využít k tomu, aby Buddy spouštěl plánované zprávy pro všechny uživatele. Buddy reaguje pouze na interakce, nikoliv na předem naplánované časovače.

## Jak zajistím, aby BuddyPro prioritizoval fakta z mého know-how nad obecnými znalostmi AI (např. u zákonů)?

Toto je výzva pro všechny AI. Pro zvýšení přesnosti a priority vašeho know-how:

1. **Instrukce v `System Prompt`:** Explicitně nařiďte, aby pro danou citlivou oblast (např. právo, daně) **vždy vycházel primárně nebo výhradně z nahraného know-how** a nepoužíval obecné znalosti, pokud si jsou v rozporu. Můžete mu i přikázat, aby vždy uvedl zdroj informace (např. odkaz na konkrétní část vašeho know-how, pokud je to technicky možné - což zatím není).
2. **Instrukce v `System Prompt`:** Explicitně nařiďte, aby pro danou citlivou oblast (např. právo, daně) **vždy vycházel primárně nebo výhradně z nahraného know-how** a nepoužíval obecné znalosti, pokud si jsou v rozporu. Můžete mu i přikázat, aby vždy uvedl zdroj informace (např. odkaz na konkrétní část vašeho know-how, pokud je to technicky možné - což zatím není).
3. **Aktuálnost know-how:** Udržujte vaše materiály (zákony, postupy) **naprosto aktuální**. Odstraňte zastaralé verze.
4. **Struktura know-how:** Rozdělte komplexní témata do menších, jasně definovaných dokumentů nebo sekcí.
5. **Ladění rolí:** Zajistěte, aby relevantní role obsahovaly nebo odkazovaly na nejdůležitější faktické informace.
6. **Příkaz `/investigateAnswer:{message}`:** Použijte ho k analýze, zda AI při chybné odpovědi vůbec sáhla do vašeho know-how, nebo zda použila jen obecné znalosti či špatnou roli.

## Moje AI instance se stále odkazuje na starý projekt nebo informaci, kterou už nechci uvádět. Lze nějak promazat její paměť nebo konkrétní vzpomínku?

Jako majitel AI instance máte několik způsobů, jak ovlivnit, o čem vaše instance mluví a co si "pamatuje" ze zdrojových dat, i když přímé "smazání konkrétní vzpomínky" z profilu existujícího uživatele není možné z důvodu ochrany soukromí.

Pokud vaše AI instance odkazuje na staré projekty nebo informace, které již nejsou relevantní, je potřeba se podívat na zdroje, ze kterých tyto informace čerpá.

Zde jsou kroky, které můžete podniknout:

1.  **Aktualizujte své know-how (složka `sources` na Google Drive):**
    - **Odstraňte neaktuální soubory:** Pokud jsou staré informace obsaženy v PDF, videích, audio souborech nebo textových dokumentech, které jste nahráli do složek `sources/Files`, `sources/Texts` nebo `sources/URLs`, fyzicky tyto soubory nebo odkazy z Google Drive odstraňte nebo upravte jejich transcript tak, aby neaktuální informace neobsahovaly.
    - **Spusťte příkaz `/update`:** Po jakékoliv změně ve složce `sources` (smazání souboru, úprava obsahu Google Dokumentu atd.) je nezbytné v Telegramu ve vaší instanci BuddyPro spustit příkaz `/update`. Tím se změny synchronizují se znalostní databází vaší AI instance a informace z odstraněných/upravených souborů přestanou být pro AI dostupné.
      ```bash
      /update
      ```
2.  **Zkontrolujte a upravte `system_prompt.gdoc`:**
    - Otevřete soubor `system_prompt.gdoc` v kořenové složce vaší instance na Google Drive.
    - Pečlivě projděte jeho obsah a odstraňte veškeré zmínky o starém projektu nebo neaktuálních informacích.
    - **Přidejte instrukci do sekce "Kritické chyby":** Do `system_prompt.gdoc` můžete na konec přidat sekci (např. `# KRITICKÉ CHYBY A JEJICH ŘEŠENÍ`), kde AI explicitně nařídíte, aby o daném starém projektu nebo informaci nemluvila. Příklad:
      `CHYBA: Odkazuješ na můj starý projekt XYZ.ŘEŠENÍ: Projekt XYZ již není aktuální a není relevantní. Nikdy o něm nemluv a neodkazuj na něj.`
    - Po úpravě souboru `system_prompt.gdoc` opět spusťte příkaz `/update`.
3.  **Zkontrolujte a případně přegenerujte Role (složka `ROLES`):**
    - Staré informace mohou být součástí definic některých rolí, které byly vygenerovány na základě původního (neaktuálního) know-how.
    - **Identifikujte relevantní role:** Použijte příkaz `/lastRole` poté, co AI zmíní starou informaci, abyste zjistili, která role byla aktivní.
    - **Smažte definiční soubory rolí:** Na Google Drive ve složce `ROLES` smažte soubory `.gdoc` těch rolí, které mohou obsahovat neaktuální informace. Soubor `list_of_roles.gdoc` ponechte.
    - **Spusťte příkaz `/updateRoles`:**
      Tím se role, jejichž definiční soubory jste smazali, vygenerují znovu na základě aktuálního stavu vašeho know-how (po provedení `/update`). Můžete také cíleně přegenerovat konkrétní roli příkazem `/updateRole:name_of_role`.
          ```bash
          /updateRoles
          ```

**Důležité shrnutí:**

- **Nemůžete přímo mazat "vzpomínky" nebo obsah profilu jiných uživatelů.** To je chráněno z důvodu soukromí.
- Můžete však **zásadně ovlivnit, z jakých informací vaše AI instance čerpá** tím, že budete pečlivě spravovat obsah ve složce `sources`, souboru `system_prompt.gdoc` a případně definicích rolí.
- Příkaz `/update` je klíčový po jakékoliv změně zdrojových dat.
- Při vlastním testování můžete použít příkazy `/del` nebo testovací profily pro "čistší" interakci.
- Explicitní zákazy v `system_prompt.gdoc` (sekce kritických chyb) mohou být velmi účinné.

## Může moje BuddyPro instance nabídnout uživateli ke stažení konkrétní soubor (např. PDF šablonu, checklist), který mám uložený online?

Ano, toto je možné. Pokud máte doplňkové materiály (šablony, checklisty, e-booky, pracovní listy atd.) uložené online a dostupné přes veřejnou URL adresu (např. na vašem webu, Google Drive, Dropboxu), můžete svou BuddyPro instanci instruovat, aby tyto odkazy v relevantním kontextu uživateli nabídla.

Tuto instrukci můžete zapracovat buď do hlavního `system_prompt.gdoc` (např. "Pokud se uživatel ptá na plánování projektu, nabídni mu odkaz na náš projektový checklist: [URL adresa souboru]"), nebo ji můžete přidat do definice konkrétní role (např. role "Projektový manažer AI" by měla instrukci nabízet tento checklist).

Uživatel pak obdrží přímý odkaz a soubor si může stáhnout. Funkce přímého nahrávání souborů z AI do chatu k uživateli (jako příloha) zatím není implementována, ale sdílení odkazu je plně funkční.

## Jak poznám, že dlouho běžící příkazy jako /update nebo /updateRoles opravdu dokončily zpracování všeho?

Tyto příkazy byly **vylepšeny**, aby běžely na pozadí déle (až 5 hodin) a zpracovaly veškerý obsah nebo role najednou, aniž byste je museli volat opakovaně.

- **Po dokončení:** BuddyPro vám v Telegramu pošle zprávu, že proces **"finished successfully"**. Pokud zpracovával mnoho rolí a dokončil je všechny, odpověď "finished successfully" přijde velmi rychle (téměř okamžitě) po opětovném zadání příkazu `/updateRoles`, protože už nemá co generovat.
- **V případě chyby:** Pokud během zpracování dojde k chybě, BuddyPro pošle zprávu "finished with errors" a vypíše soubory/URL, u kterých nastal problém.
- **Zastavení procesu:** Pokud potřebujete proces z nějakého důvodu přerušit, můžete použít příkazy `/stopUpdate` nebo `/stopUpdateRoles`.

## Může zákazník přejít na nižší tarif (downgrade) jednoduše pomocí příkazu `/stop`?

Ne, downgrade na nižší tarif **neprobíhá automaticky**.

Příkaz **`/stop`** pouze **zruší automatické prodlužování** aktuálního předplatného — službu může zákazník používat až do konce zaplaceného období, ale **nepřepne se mu automaticky** na levnější tarif.

Pokud chce zákazník po skončení aktuálního období přejít na nižší tarif, může to udělat jednoduše:

1. Zadá v chatu příkaz `/stop` (tím ukončí obnovování svého současného tarifu),
2. Po skončení aktuálního období si může **zakoupit nový, levnější tarif**.

Pokud však chce přejít na nižší tarif **okamžitě**, je potřeba zásah ze strany vlastníka instance:

1. Vlastník ručně zruší předplatné ve FAPI (stornuje periodickou fakturu),
2. Poté použije příkaz `/disableUser` s ID daného předplatného,
3. Následně si zákazník může ihned zakoupit nový, nižší tarif.

**Shrnutí:**

- `/stop` → používá zákazník, zruší pouze automatické obnovení (přístup běží do konce období)
- `/disableUser` → používá vlastník, ruší přístup okamžitě (např. při downgrade/refundaci)
- **Automatický downgrade neexistuje** — vždy je buď manuální, nebo po skončení období

## Může zákazník přejít na vyšší tarif (upgrade), i když mu běží stávající předplatné?

Ano. Stačí, aby uživatel klikl na aktivační odkaz v e‑mailu / na děkovací stránce. Následně bude vyzván k potvrzení akce příkazem /upgrade. Poté dojde automaticky ke zrušení původního předplatného, nevyčerpané zprávy z aktuálního měsíčního limitu se převedou na neexpirující extra zprávy a aktivuje se nové předplatné.

## Existují limity pro velikost/délku video/audio souborů? Co když přepis selže?

Ano, mohou existovat limity dané technickými možnostmi serveru, který soubory zpracovává.

- **Problém s pamětí:** U datově velmi velkých souborů (např. 12minutové video o velikosti 1 GB, jak bylo zmíněno v chatu) může dojít k vyčerpání operační paměti serveru a přepis selže.
- **Délka videa:** Problém může nastat i u několikahodinových videí, i když systém by měl být navržen tak, aby je zvládl. Výjimečně může dojít také k výpadku přepisu YouTube videí, jelikož YouTube pro stahování videí neposkytuje oficiální API.

**Co dělat, když přepis selže:**

- **Zmenšit soubor:** Nahrajte video v nižší kvalitě nebo nahrajte pouze jeho audio stopu (MP3), která je datově mnohem menší.
- **Kontaktovat podporu:** Pokud přepis selhává i u menších souborů nebo z nejasných důvodů, nahlaste problém podpoře (`support@buddy.fm`) a ideálně poskytněte odkaz na problematický soubor ke stažení pro analýzu.

## BuddyPro používá špatný support email, i když jsem ho nastavil pomocí /setSupportEmail. Co s tím?

Pokud BuddyPro stále uvádí nesprávný email podpory:

1. **Zkontrolujte `system prompt`:** Ujistěte se, že správný email je explicitně uveden i zde, ideálně s instrukcí, že *toto* je jediný platný kontakt na podporu.
2. **Prohledejte know-how:** Je možné, že nesprávný email je zmíněn někde ve vašich nahraných materiálech (`sources`). Pokud ano, opravte to v materiálech a spusťte `/update`.
3. **Kontaktujte podporu:** Pokud problém přetrvává, může jít o technickou chybu – kontaktujte `support@buddy.fm`.

## Přistupuje BuddyPro během konverzace přímo do mých složek na Google Drive, aby našel informace?

**Ne, nepřistupuje.** Proces funguje jinak:

1. Příkazem `/update` dáte pokyn ke **zpracování obsahu** z vašich složek `sources` na Google Drive.
2. BuddyPro obsah **přepíše**, rozdělí na menší části (útržky) a tyto útržky **uloží do speciální vektorové databáze**.
3. Během konverzace s uživatelem pak BuddyPro **prohledává tuto vektorovou databázi** (nikoli váš Google Drive) a vybírá nejrelevantnější útržky know-how a relevantní roli pro odpověď.

Google Drive tedy slouží pouze jako **zdroj pro prvotní nahrání a aktualizaci** know-how, nikoli pro vyhledávání v reálném čase během konverzace. Proto nelze v `system prompt` říct např. "odpověz podle souboru XYZ".

## Pokud ručně upravím přepis souboru ve složce TRANSCRIPTIONS, jak zajistím, aby BuddyPro používal tuto upravenou verzi?

Ano, **je možné** ručně upravovat textové soubory s přepisy (transcriptions), které BuddyPro automaticky vytváří ve složkách `sources/FILES/TRANSCRIPTIONS` nebo `sources/URLs/TRANSCRIPTIONS`.

Abyste zajistili, že BuddyPro začne používat vaši upravenou verzi:

1. Proveďte požadované úpravy přímo v Google Dokumentu s přepisem.
2. Po uložení změn **spusťte v Telegramu příkaz `/update`** Tím se změny synchronizují se znalostní databází BuddyPro.

## Moje BuddyPro instance má problémy s výslovností českých číslic v audio odpovědích. Co s tím?

Toto je problém týkající se syntézy řeči (TTS) pro český jazyk u některých AI modelů. O problému víme a pracujeme na řešení pro zlepšení české výslovnosti, zejména u číslic.

## Plánuje se do budoucna nějaké zjednodušení procesu nastavování BuddyPro?

Ano, cílem je, aby vás vaše BuddyPro instance **sama proaktivně vedla** jednotlivými kroky nastavení a hlídala, co už máte hotové. Toto vylepšení se připravuje.

## Jak mám jako vlastník instance řešit situaci, kdy AI slíbí něco, co nemůže splnit (např. "zpracuji to do rána"), nebo když "halucinuje"?

Klíčem je **vzdělávání uživatelů** (onboarding). Vysvětlete jim, že AI není neomylná a může občas "halucinovat" nebo slíbit nesplnitelné. Neměli by ji brát jako absolutní autoritu. Pokud AI opakovaně chybuje v určité oblasti, revidujte `system prompt` nebo příslušné know-how/role.

## Jak docílit toho, aby moje AI instance aktivně doporučovala konkrétní mé produkty, služby nebo materiály (videa, PDF) v relevantním kontextu, aniž by je "cpala" uživatelům neustále?

Nejlepším způsobem je zapracovat tato doporučení **do definic konkrétních rolí**, nikoliv do hlavního `system_prompt.gdoc`.

- **Postup:**
  1. Identifikujte nebo vytvořte roli, která souvisí s tématem produktu/materiálu.
  2. Otevřete Google Dokument této role ve složce `ROLES`.
  3. Do textu role přidejte instrukci AI, aby v případě, že to uzná za vhodné a relevantní pro uživatele, doporučila daný produkt/materiál, včetně jeho popisu a URL adresy.
  4. Po úpravě role spusťte příkaz `/updateRoles` nebo `/updateRole:{nazev_role}`.
- **Výhoda:** Doporučení bude nabídnuto pouze tehdy, když bude aktivní daná relevantní role a AI vyhodnotí, že je to pro konverzaci přínosné.

## Mohu si v BuddyPro vytvořit úplně novou roli, pokud automaticky vygenerované role nepokrývají specifickou oblast, kterou potřebuji?

Ano, je to možné, i když se jedná o pokročilejší techniku.

- **Postup:**
  1. Otevřete soubor `ROLES/list_of_roles.gdoc` (seznam názvů všech rolí).
  2. Na nový řádek připište název vaší nové role. Název by měl být co nejvýstižnější, protože AI podle něj vybírá relevantní roli.
  3. Uložte soubor `list_of_roles.gdoc`.
  4. V Telegramu spusťte příkaz `/updateRole:{presny_nazev_nove_role_vcetne_mezer}`. Systém by měl na základě existujícího know-how vytvořit nový Google Dokument s definicí této role ve složce `ROLES`.
  5. Tento nově vytvořený dokument můžete následně otevřít a detailně upravit jeho obsah (instrukce pro AI) podle vašich potřeb.
  6. Po finální úpravě role opět spusťte `/updateRole:{presny_nazev_nove_role}` nebo `/updateRoles`.

---

# Onboarding uživatelů

## Jak nastavit onboarding pro nové uživatele?

Upravte soubor **`onboarding`** na Google Drive:

- **`first_messages`**: Definujte zde **uvítací zprávy** (může jich být více, vybere se náhodně). Vložte text, tipy, výzvu k akci, **odkaz na YouTube video**. Dodržte syntaxi souboru!
- **`onboarding_messages`**: Nastavte zprávy pro **automatické odeslání** po dosažení určitého počtu interakcí (např. po 10., 30.). Nepřehánějte to s počtem. Dodržte syntaxi!

Kvalitní onboarding je klíčový pro úspěšný start uživatelů s vaším BuddyPro:

1. **Upravte uvítací zprávu** v souboru “onboarding”:
   - Představte svého BuddyPro a jeho schopnosti
   - Vysvětlete, jak s ním nejlépe komunikovat
   - Nastavte reálná očekávání, co BuddyPro umí a neumí
2. **Vložte onboardingové video**:
   - Vytvořte krátké video (15-20 minut) s ukázkou používání
   - Vložte YouTube odkaz do uvítací zprávy
   - Video se v Telegramu zobrazí jako přehratelný náhled
3. **Nastavte automatické zprávy**:
   - Využijte možnost nastavit zprávy, které se zobrazí po určitém počtu interakcí
   - Například po 10. zprávě BuddyPro může uživatele informovat o možnosti posílat hlasové zprávy
   - Tyto zprávy nastavíte také v souboru “onboarding”
4. **Veďte uživatele ke správnému používání**:
   - Doporučte jim nejprve sdílet kontext a informace o sobě
   - Vysvětlete, že není třeba psát složité prompty
   - Ukažte příklady otázek, které mohou pokládat
5. **Přidejte disclaimery**:
   - Pro citlivé obory (zdraví, finance, právo) přidejte jasné disclaimery
   - Tyto lze zahrnout do uvítací zprávy i do systémového promptu

**Nový parametr `type` pro onboardingové zprávy**

K uvítacím a onboardingovým zprávám lze nyní přidat volitelný parametr `type`. Ten určuje, v jaké formě se zpráva novému uživateli pošle.

- `text` – odešle se pouze textová zpráva (výchozí chování).
- `text-audio` – odešle se textová zpráva a zároveň stejná zpráva namluvená v podobě hlasovky.
- `audio` – odešle se pouze hlasovka bez textu.

Pokud parametr neuvedete, použije se hodnota `text`. Příklad nastavení onboardingové zprávy, která se odešle po 10. interakci jako text i hlasovka.
Json:

```jsx
{
"uniqueId": "VOICE",
"atMessageNumber": 10,
"orderForBuddy": "Řekni uživateli, že ti může poslat i hlasovou zprávu…",
"type": "text-audio"
}
```

Po každé změně souboru `onboarding` spusťte `/update`.

## Jak klientům efektivně komunikovat sdílený uživatelský profil BuddyPro, aby o něm věděli a pochopili jeho výhody?

Připravili jsme pro vás materiály a doporučení, které vám umožní předem **efektivně komunikovat sdílený uživatelský profil BuddyPro**, představit jeho výhody a eliminovat překvapení...

👉 [**Zde je Google prezentace uživatelského profilu BuddyPro**](https://docs.google.com/presentation/d/17PNfCOhzYrvozcaxUFc2bmV7FgXJPH06Q5fH6nr7MOE/edit?usp=sharing) (připravená k doplňení loga a názvu vašeho AI experta)

👉 [**Zde je návod jak prezentaci editovat**](https://www.loom.com/share/259d2eb2ed054cba9437be1e8caa0fd5)

Připravenou prezentaci můžete:

- Zahrnout do onboardingových videí a materiálů
- Využít při prodejních webinářích
- Umístit na webové stránky jako součást vzdělávacích materiálů nebo FAQ
- Přiložit k e-mailu při řešení dotazů klientů

🔽 Pokud chcete uživatelský profil BuddyPro komunikovat zákazníkům předem, zde je pár nápadů, jak to můžete udělat:

1️⃣ **V onboardingovém videu:** Krátká zmínka o tom, že vaše AI využívá pokročilý systém, který si může pamatovat základní informace z předchozích interakcí s jinými AI experty na platformě BuddyPro. Stručné vysvětlení výhod sdíleného profilu s důrazem na bezpečnost dat s možným využitím prezentace výše nebo jejich částí.

2️⃣ **V představení produktu:** V prodejních materiálech můžete zmínit výhody profilu BuddyPro například takto: "[Název Vaší instance] využívá uživatelské profily BuddyPro, které umožňují rychlou adaptaci a personalizaci již od prvního kontaktu. Nemusíte znovu vysvětlovat základní informace - Pokud jste již mluvili s dalšími experty na této platformě, AI expert Vás již zná a může se rovnou soustředit na poskytování expertních rad ve své specializaci. Tím šetříte počet spotřebovaných zpráv a výrazně zkracujete fázi prvotního učení."

3️⃣ **V podmínkách služby:** Do podmínek můžete uvést například: "[Název Vaší instance] je vytvořen na platformě BuddyPro, která využívá jednotný AI mozek a uživatelský profil. To znamená, že základní informace o vás a sdílených tématech mohou být dostupné i jiným AI v rámci BuddyPro ekosystému, pokud s nimi budete v budoucnu komunikovat. Tato funkce slouží výhradně ke zlepšení uživatelské zkušenosti a poskytování relevantnějších odpovědí. K obsahu vašich konverzací či obsahu vašeho uživatelského profilu nemá přístup žádná fyzická osoba, včetně tvůrců jednotlivých AI expertů či týmu BuddyPro. Veškerá data zůstávají šifrovaná a bezpečně uložená a jsou využívána pouze pro účely komunikace s AI experty na paltformě BuddyPro."

Při komunikaci o sdíleném profilu vždy zdůrazněte:

- **Bezpečnost:** Žádná fyzická osoba nemá přístup k obsahu konverzací
- **Soukromí:** Data jsou šifrována a zpracována pouze v rámci AI systému
- **Výhody:** Rychlejší seznámení, personalizace, relevantnější podpora, ušetřené náklady za zprávy
- **Transparentnost:** Otevřeně vysvětlujte, jak systém funguje, bez technického žargonu

Pro lepší pochopení doporučujeme použít následující přirovnání s učitelem:

🤖 **Přirovnání s robotickým učitelem**

"Představte si pokročilého robotického učitele, který byl naprogramován pro školní výuku několika různých předmětů. Na matematice používá matematické pomůcky, speciální analytické algoritmy a komunikuje přesným, logickým jazykem. Na tělocviku využívá sportovní náčiní, aplikuje tréninkové metody založené na fyziologii pohybu a motivuje energickým, povzbuzujícím způsobem. Na umělecké výchově pracuje s kreativními technikami, učí podle estetických principů a vyjadřuje se inspirativním, obrazným jazykem.

Pro každý předmět má robotický učitel nainstalovaný jiný výukový modul s unikátními expertními znalostmi, metodami a přístupy. Přesto jde o téhož robota s jedním centrálním mozkem, který si pamatuje vaše preference, silné stránky, témata, která řešíte, i oblasti, kde potřebujete podporu, napříč všemi předměty.

Tento robotický učitel byl navržen s naprostým důrazem na soukromí žáků. I když zná studenty ze všech hodin a pamatuje si jejich individuální potřeby, za žádných okolností nesdělí žádnému živému člověku – ani řediteli, ani svým tvůrcům – obsah osobních konzultací nebo průběh hodin. Jeho programování to technicky neumožňuje.

Přesně takto funguje [název vaší instance] a další AI experti na platformě BuddyPro. Každý má svou jedinečnou specializaci a přístup, ale všichni sdílejí jednotný AI mozek, který jim umožňuje lépe vám porozumět. Obsah vašich konverzací je šifrovaný a zůstává v naprostém bezpečí – žádná fyzická osoba, včetně mě jako tvůrce [název vaší instance], dalších expertů se svými AI s mozkem BuddyPro, či dokonce tvůrců platformy BuddyPro, nemá k obsahu vašeho profilu přístup."

## Jak nejlépe uživatele do BuddyPro uvést?

- **Komunikujte hodnotu:** Zdůrazněte personalizaci, vaše know-how, dostupnost.
- **Vytvořte onboarding video:** Ukažte praktické použití, nastavte očekávání.
- **Veďte k představení:** Vyzvěte uživatele, aby AI řekli o sobě.
- **Podporujte přirozenou komunikaci.**
- **Nastavte realistická očekávání:** Zmiňte možnost chyb a disclaimery.
- **Využijte komunitu:** Sdílejte zkušenosti.
- **Mluvte o AI jako o "parťákovi".**

## Co určuje jazyk první zprávy, kterou váš BuddyPro přivítá nového uživatele?

- **Nastavení jazyka aplikace Telegram:** **Ano, má vliv na první zprávu.** BuddyPro se při úplně první interakci s uživatelem snaží použít jazyk nastavený v jeho Telegram aplikaci. Pokud tedy máte Telegram česky, první zpráva by měla být česky. Pokud ho máte anglicky, bude pravděpodobně anglicky.
- **Nastavení jazyka telefonu:** Nemá přímý vliv.
- **Další konverzace:** Po první zprávě se BuddyPro primárně řídí **jazykem, kterým s ním komunikuje uživatel**.

## Jak motivovat uživatele k pravidelnému používání AI experta a vytvoření návyku?

- **Kvalitní onboarding:** Úvodní video, inspirativní první zpráva.
- **Pravidelné podněty v prvních 30 dnech užívání:** Např. 30denní emailová série tipů, co s AI probírat a jak ji využít naplno.
- **Vytváření rituálů:** Navést uživatele k pravidelným "sezením" s vaším AI expertem, využití **funkce připomínek** (pokud o to uživatel požádá, AI sama iniciuje konverzaci na domluvené téma v určený čas).
- **Propojení s vaším obsahem:** Doporučujte v rámci svého obsahu vaší AI jako nástroj k individuálnímu probrání témat z kurzů, masterclassů, videí, atd.

## Jak mohu uživatele lépe navést k tomu, co mohou s mou AI instancí řešit, pokud se sami neorientují nebo jsou zvyklí jen na jednoduché dotazy jako u ChatGPT?

Kromě kvalitního `onboarding.gdoc` zvažte následující:

- **E-mailová série pro nové uživatele:** Po registraci (nebo zakoupení přístupu) jim můžete posílat pravidelné e-maily (např. po dobu 30 dní) s tipy, jaká témata mohou s AI probírat, jak klást otázky, nebo jaké konkrétní úkoly jim AI může pomoci vyřešit ve vašem oboru.
- **Vzdělávací videa:** Natočte krátká videa ukazující praktické příklady využití vaší AI pro typické problémy vašich klientů. Můžete je zahrnout do onboardingu nebo e-mailové série.
- **Obsah ve vaší komunitě/na sítích:** Pravidelně ukazujte, jak AI sami používáte k řešení problémů. Například sdílejte zajímavý výstup z vaší AI a na konci přidejte výzvu: "Chcete si toto téma probrat individuálně? Zkuste mého AI experta zde [odkaz na trial]."
- **Instrukce v `system_prompt.gdoc`:** Můžete AI instruovat, aby se snažila být proaktivnější v navádění uživatele, nabízela možná témata k diskusi nebo se ptala na další oblasti, se kterými by mohla pomoci.
- **Seznam témat v první zprávě:** V `onboarding.gdoc` můžete do první zprávy zahrnout nejen uvítání, ale i odkaz na dokument nebo stránku s přehledem témat a příklady otázek.

## Jak docílit toho, aby moje AI instance fungovala jako dlouhodobý průvodce, který uživatele vede například k dosažení konkrétního cíle?

Toto vyžaduje **aktivní spolupráci uživatele** a správné nastavení očekávání. AI nemůže sama o sobě plně řídit tento proces, ale může být velmi nápomocným partnerem.

- **Kroky:**
  1. **Definice cíle:** Uživatel by měl AI jasně sdělit svůj dlouhodobý cíl, ideálně i s konkrétním datem (pokud je relevantní). AI si tuto informaci uloží do uživatelského profilu.
  2. **Pravidelné "check-iny":** Uživatel si může nastavit pravidelné připomínky (např. týdenní), kdy s AI zrevidují pokrok směrem k cíli. Během těchto sezení mohou probrat, co se podařilo, co jsou další kroky atd.
  3. **Vedení konverzace:** Uživatel by měl vědět, jak AI požádat o pomoc s plánováním, hledáním řešení, nebo udržením motivace.
- Naučte své uživatele (např. v onboardingu, kurzu), jak s AI takto pracovat – jak definovat cíle, jak využívat připomínky pro pravidelnou reflexi a plánování. AI dokáže dobře držet kontext dlouhodobého cíle a vracet se k němu v konverzacích.

---

# Fungování

## Jak přesně BuddyPro odpovídá uživatelům a co se děje na pozadí?

Když uživatel pošle zprávu, na pozadí proběhne sofistikovaný proces:

1. **Analýza dotazu** - BuddyPro analyzuje otázku a kontext konverzace
2. **Aplikace systémového promptu** - Základní systémový prompt definující osobnost, hodnoty a základní pravidla chování je vždy základem každé odpovědi
3. **Výběr role** - Na základě obsahu dotazu je automaticky vybrána nejvhodnější role z desítek či stovek rolí, které byly vytvořeny podle vašeho know-how
4. **Vyhledání relevantního know-how** - Systém prohledá vektorovou databázi s vaším know-how a najde nejrelevantnější části pro daný dotaz
5. **Zpracování uživatelského profilu** - Je načten profil uživatele obsahující důležité informace zjištěné během předchozích konverzací
6. **Aktivace krátkodobé paměti** - Systém načte několik desítek předchozích zpráv z aktuální konverzace pro pochopení kontextu
7. **Vyhledání v dlouhodobé paměti** - Z dlouhodobé paměti jsou vyhledány relevantní “vzpomínky” z dřívějších konverzací
8. **Generování odpovědi** - Všechny tyto komponenty jsou předány AI, která vygeneruje finální odpověď přizpůsobenou uživateli

Tento komplexní proces zajišťuje, že každá odpověď je personalizovaná, kontextově relevantní a vychází z vašeho know-how.

## Jak funguje paměť BuddyPro? Opravdu si můj AI expert pamatuje všechny minulé konverzace?

BuddyPro má dva typy paměti, které fungují podobně jako lidská paměť:

1. **Krátkodobá paměť**:
   - Obsahuje přibližně 30 posledních zpráv z aktuální konverzace
   - Poskytuje bezprostřední kontext pro současnou diskuzi
   - Je vždy aktivní během konverzace
2. **Dlouhodobá paměť**:
   - Ukládá se do ní vše, co si uživatel s BuddyPro kdy řekl
   - Funguje podobně jako lidská paměť - BuddyPro si nevybavuje automaticky vše najednou
   - Při každé zprávě vyhledává přibližně deset nejrelevantnějších “vzpomínek” souvisejících s aktuálním tématem
   - Umožňuje BuddyPro odkazovat na dřívější konverzace i po měsících nebo letech

Díky této kombinaci paměti může BuddyPro poskytovat kontinuitu v konverzacích a budovat skutečný vztah s uživatelem. Může se například zeptat na pokrok v projektu, o kterém jste mluvili před měsícem, nebo si vzpomenout na vaše preference a osobní situace.

## Jak dokáže BuddyPro rozpoznat potřeby různých typů uživatelů?

BuddyPro rozpoznává potřeby uživatelů díky několika mechanismům:

1. **Vytváření uživatelského profilu**:
   - Během konverzace si BuddyPro vytváří profil uživatele
   - Do profilu ukládá důležité informace o preferencích, situaci a cílech
   - Tento profil se postupně rozšiřuje s každou další interakcí
2. **Analýza komunikačního stylu**:
   - BuddyPro se přizpůsobuje komunikačnímu stylu uživatele
   - Rozpoznává, zda uživatel preferuje stručné nebo detailní odpovědi
   - Přizpůsobuje úroveň formálnosti a tón komunikace
3. **Kontextové porozumění**:
   - Analyzuje, jaká témata uživatel řeší opakovaně
   - Identifikuje vzorce v otázkách a potřebách
4. **Sdílený profil mezi instancemi BuddyPro**:
   - Unikátní funkce je sdílený profil uživatele mezi různými instancemi BuddyPro
   - Pokud uživatel používá více AI expertů na platformě BuddyPro, nemusí se při každém seznamovat znovu
   - Nový BuddyPro už o uživateli ví základní informace, což výrazně zrychluje onboarding

Tato schopnost personalizace je jednou z největších výhod BuddyPro oproti běžným chatbotům nebo generickým AI řešením.

## Jaký je vztah mezi počtem rolí a využitím know-how? Použije AI méně know-how, když má více rolí?

Nikoliv. Počet rolí neomezuje množství know-how použitého v odpovědi. Proces funguje takto:

1. Vybere se **1 relevantní role**.
2. Vybere se **několik (cca 10) nejrelevantnějších útržků know-how** z *celé* znalostní báze (bez ohledu na role).

Více rolí znamená, že AI je **specifičtější** a lépe zacílená pro daný kontext (díky detailnějším instrukcím v roli), ale stále má přístup k celému vašemu know-how prostřednictvím vyhledání nejrelevantnějších útržků. Vyšší počet rolí tedy neznamená menší využití know-how, ale jeho přesnější aplikaci.

## Jaké typy médií a souborů v komunikaci zvládá?

- **Pro trénink (`sources`):** PDF, DOCX, TXT, Google Docs, PPT, MP3, MP4, obrázky, URL (web, YouTube, Vimeo).
- **V komunikaci s uživatelem (koncový uživatel posílá v chatu):**
  Uživatelé mohou k telegramové zprávě připojit soubory a bavit se o nich. Váš AI expert si obsah těchto souborů pamatuje a může na něj odkazovat i v budoucích konverzacích. - **Přijímá a zpracovává:** - **Text, audio zprávy.** - **Soubory:** Prakticky jakékoliv běžné formáty jako PDF, DOCX, TXT, tabulky (XLSX, CSV) a další. - **Obrázky:** JPG, PNG a další pro vizuální analýzu. - **Videa:** AI zpracuje **pouze audio stopu** videa, nikoliv jeho vizuální obsah. - **Odesílá:** - **Text, audio zprávy**
- Do Know‑how URL lze nově vložit odkaz na celý YouTube kanál nebo playlist. BuddyPro automaticky zpracuje všechna videa (kromě Shorts) na daném kanálu nebo playlistu.

## Umí BuddyPro AI instance počítat nebo provádět matematické operace?

Základní matematické operace (např. "kolik je 5 x 5") BuddyPro obvykle zvládne. Nicméně, pro **složitější výpočty, tvorbu rozpočtů nebo finanční plánování není aktuálně optimalizován** a jeho schopnosti v této oblasti budou omezené. Do budoucna se zvažuje integrace modelů specializovaných na matematiku.

## Jak funguje sdílený uživatelský profil mezi různými AI instancemi na platformě BuddyPro a lze toto chování nějak ovlivnit, zejména pokud jde o využívání osobních informací při zahájení konverzace novou instancí?

Platforma BuddyPro využívá inovativní koncept **sdíleného uživatelského profilu**. To znamená, že když uživatel komunikuje s různými AI experty (instancemi) na platformě BuddyPro, ty mohou bezpečně sdílet základní kontext o uživateli.

- **Klíčový přínos:** Tento přístup dramaticky **zvyšuje efektivitu a relevanci vašeho AI experta hned od první interakce**. Uživatel nemusí každé nové AI instanci znovu vysvětlovat základní informace o sobě, svých cílech či preferencích. Váš AI expert tak může okamžitě navázat na existující kontext a poskytovat hluboce personalizovanou podporu, což šetří čas uživatele a výrazně zlepšuje jeho zkušenost. Je to jako mít osobního asistenta, který si pamatuje důležité detaily napříč různými oblastmi vaší podpory.
- **Bezpečnost a ochrana soukromí na prvním místě:** Je zásadní zdůraznit, že tento sdílený profil a veškeré informace v něm jsou **striktně chráněny a existují pouze v rámci zabezpečeného šifrovaného profilu na serverech BuddyPro**. K těmto individuálním uživatelským datům nemá přístup žádný člověk – ani vy jako majitel instance, ani jiní majitelé, ani administrátoři platformy. Platforma BuddyPro klade maximální důraz na ochranu dat pomocí pokročilého šifrování.
- **Transparentní informování uživatele:**
  - Když uživatel poprvé osloví novou AI instanci, a v minulosti už využil jinou AI instanci na platformě BuddyPro, tato instance ho **transparentně informuje** o tom, že je součástí propojené platformy, díky čemuž o něm již může mít některé základní informace (a může zmínit, ze kterých předchozích interakcí s jinými AI na platformě BuddyPro tento kontext pochází). Současně je zdůrazněna bezpečnost dat a pozitivní účel tohoto sdílení – tedy poskytnutí co nejlepší a nejrychlejší personalizované pomoci.
- **Možnosti nastavení a ovlivnění chování AI:**
  - **Nastavení proaktivity vaší AI instance:**
    - Jako tvůrce AI experta máte **možnost kontrolovat, zda vaše instance bude uživatele oslovovat proaktivně** (tedy sama od sebe iniciovat konverzaci).
    - **Jak zjistit a použít příkaz pro vypnutí/zapnutí automatických zpráv:** Nejlepším způsobem, jak zjistit aktuální příkaz pro správu proaktivity vaší instance, je **zeptat se přímo vaší BuddyPro instance**. Zadejte například otázku jako: `Jak mohu nastavit, aby moje AI instance neposílala zprávy sama od sebe?` nebo `Jaký je příkaz pro vypnutí automatického oslovování uživatelů?`. Váš BuddyPro by vám měl poskytnout přesný příkaz a postup.
  - **Možnosti pro uživatele:**
    - Uživatelé mají také plnou kontrolu. Mohou kterékoliv AI instanci **přímo sdělit svá přání** ohledně komunikace – například, že si nepřejí být danou AI instancí oslovováni proaktivně a ať jim daná instance nepíše sama od sebe. AI na platformě BuddyPro jsou navrženy tak, aby takovéto uživatelské preference respektovaly.
- **Nepostradatelnost sdíleného profilu pro pokročilou AI:**
  - Schopnost AI pamatovat si uživatele a kontext napříč interakcemi je základním předpokladem pro poskytování skutečně inteligentní a hodnotné podpory. Uživatelé stále více očekávají, že AI, se kterými komunikují, budou "chytré" a nebudou vyžadovat neustálé opakování již řečeného. Sdílený profil je technologie, která umožňuje AI expertům na platformě BuddyPro tuto pokročilou úroveň služby nabízet a odlišit se tak od jednodušších chatbotů.
  - **V tuto chvíli ladíme optimální způsob, jakým AI instance pracují s informacemi ze sdíleného profilu**, obzvláště při prvním kontaktu nebo pokud AI sama iniciuje konverzaci. Cílem je, aby byla komunikace vždy citlivá, relevantní k zaměření dané expertní instance a aby se předcházelo jakýmkoli situacím, které by uživatel mohl vnímat jako nekomfortní – připravujeme verzi, která v tomto bude dokonalejší.

## Umí BuddyPro pracovat přímo se soubory od uživatele v chatu?

**Ano, nově je to jedna z klíčových schopností BuddyPro.**

Uživatelé mohou k telegramové zprávě jednoduše **připojit jeden nebo více souborů** (dokumenty, tabulky, obrázky, audia, videa) a s AI expertem se o nich bavit.

**Jak to funguje:**

- **Analýza obsahu:** AI si obsah souboru přečte, analyzuje a je schopen o něm vést konverzaci. U videa pracuje pouze s audio stopou.
- **Dlouhodobá paměť:** Obsah nahraných souborů se ukládá do dlouhodobé paměti. Uživatel se tak může na dříve zaslaný dokument odkázat i po delší době.
- **Kontextuální vyhledávání:** U delších dokumentů si AI vytvoří souhrn a dokáže v nich relevantně vyhledávat, i když nevidí celý obsah najednou.

**Příklady využití:**

- "Podívej se na kapitolu 4 v této knize v PDF, kterou ti posílám, a řekni mi, co bys tam napsal lépe."
- "Na základě této prezentace mi poraď, jak vylepšit marketingovou strategii."
- "Zkontroluj prosím gramatiku v tomto dokumentu."

**Aktuální limity:** Pokud uživatel pošle více souborů najednou, AI se zatím vyjádří ke každému zvlášť, nikoliv v jedné souhrnné zprávě.

## Umí BuddyPro načítat weby a odkazy?

**Ano, oběma způsoby:**

1. **Při tréninku (pro vlastníka):** Můžete zadat URL adresy (webové stránky, YouTube videa) do souboru `sources/URLs/URL SOURCES.gdoc`. Po spuštění příkazu `/update` se jejich obsah stane trvalou součástí know-how vaší AI instance.
2. **V chatu na pokyn uživatele (nová funkce):** Uživatelé mohou nyní poslat odkaz na webovou stránku nebo YouTube video přímo v konverzaci a požádat AI, aby se na obsah podívala, shrnula ho nebo ho analyzovala.

**Příklady využití:**

- "Mrkni na můj web petrnovak.cz/kampan a řekni mi, co si myslíš o tom prodejním textu."
- "Shrň mi prosím hlavní myšlenky z tohoto YouTube videa: [odkaz]."

**Aktuální limity:**

- AI analyzuje **pouze textový obsah** webové stránky, nevidí její vizuální design, rozložení prvků nebo obrázky.
- Některé dynamické webové stránky, které načítají svůj obsah postupně, mohou způsobovat problémy s načtením.

## Poslala jsem hlasovou zprávu, ale chci odpověď pouze textově, ne i audio. Je to možné? Čerpá mi duplicitní odpověď (text + audio) více zpráv?

Pokud vaší BuddyPro instanci pošlete hlasovou zprávu, platforma je aktuálně nastavena tak, že automaticky odpoví jak textovou zprávou, tak i audio zprávou (namluvenou nastaveným hlasem). Toto chování zatím nelze uživatelsky změnit – AI neumí uposlechnout žádost o poskytnutí pouze textové odpovědi v tomto případě.

Dobrá zpráva je, že i když obdržíte odpověď ve dvou formátech (text + audio), z vašeho měsíčního limitu zpráv se toto počítá stále jako **jedna spotřebovaná zpráva**.

## Jak moc si BuddyPro “vymýšlí” odpovědi a jak zajistit jeho přesnost?

Jako každá AI může i BuddyPro občas “halucinovat” (vymýšlet si). Míra, do jaké se to děje, závisí na několika faktorech:

1. **Zdroje odpovědí** (od nejvíce po nejméně spolehlivé):
   - Když má k dispozici relevantní know-how, vychází primárně z něj - nejpřesnější
   - Když nemá know-how, vychází z obecných znalostí AI modelu - méně přesné
   - Když informaci nezná vůbec, může si něco vymyslet - nejméně spolehlivé
2. **Pro zajištění přesnosti**:
   - Poskytněte kvalitní a aktuální know-how v oblastech, kde je přesnost kritická
   - V systémovém promptu definujte, jak má reagovat, když si není jistý (např. “Když si nejsi jistý, přiznej to a nenabízej nepodložené informace”)
   - Vytvořte v systémovém promptu sekci “kritické chyby” s opravami častých problémů
   - Pro citlivé obory (právo, zdraví, finance) přidejte disclaimery
   - Pravidelně testujte a laďte odpovědi
3. **Průběžné zlepšování**:
   - Sbírejte zpětnou vazbu od uživatelů
   - Když identifikujete oblast, kde BuddyPro “halucinuje”, doplňte know-how o správné informace
   - Používejte příkaz `/lastRole` pro zjištění, která role byla použita pro nepřesnou odpověď

## Jak řešit nevhodné/nesprávné odpovědi?

Pokud vaše BuddyPro instance odpovídá nevhodně nebo nepřesně, doporučený postup je následující:

### 1. Úprava systémového promptu

- V souboru `system_prompt.gdoc` (najdete v kořenové složce vašeho BuddyPro na Google Drive) můžete na konec přidat sekci **„KRITICKÉ CHYBY A JEJICH ŘEŠENÍ“**.
- Do této sekce zapisujte pouze konkrétní problémy, které zjistíte při testování vaší AI, a u každého definujte správné řešení.
- _Příklad:_
  ```
  CHYBA: AI tvrdí, že odpověď dodá později.
  ŘEŠENÍ: BuddyPro nemá možnost poslat odpověď dodatečně. Vždy odpověz kompletně v     aktuální zprávě.
  ```

### 2. Úprava rolí

- Pomocí příkazu `/lastRole` zjistíte, která role generovala problematickou odpověď.
- Otevřete tuto roli v Google Drive, upravte její definici a proveďte `/updateRole:název_role`.

### 3. Doplnění know-how

- Pokud BuddyPro používá zastaralé nebo neúplné informace, nahrajte aktuální materiály do složky `sources`.
- Po doplnění spusťte `/update`, aby se data propsala.

### 4. Testování a ladění

- Používejte příkaz `/test:ID` pro testování instance z pohledu uživatele.
- Simulujte problematické scénáře a sledujte, jak AI reaguje.
- Pokud potřebujete, smažte poslední zprávy příkazem `/del` nebo `/del2` a otestujte znovu.

### 5. Běžné chyby k řešení

- Odpověď slibovaná „později“ (AI nemůže poslat zprávu dodatečně – vždy musí odpovědět kompletně hned).
- Nabízení neexistujících funkcí (např. nahrávání souborů přímo do chatu).
- Nesprávné odkazování na staré kampaně nebo akce.
- Vymýšlení nepřesných informací v odborných tématech.

## Co když moje AI instance začne silně "halucinovat" a psát velké množství nesmyslného textu nebo opakovat stejnou informaci mnohokrát za sebou? Počítá se to jako více zpráv?

AI modely, na kterých BuddyPro běží, mohou občas generovat neočekávaný, nesmyslný nebo opakující se obsah ("halucinace"). Na toto chování mají tvůrci platformy jen omezený vliv, i když se snaží systém ladit. Pokud AI vygeneruje velmi dlouhou odpověď, která se v Telegramu vizuálně rozdělí na více samostatných zpráv (kvůli limitu znaků na jednu Telegram zprávu), nebo pokud v rámci jedné reakce pošle několik zpráv rychle za sebou tvořících jednu myšlenku, mělo by se to z hlediska vašeho tarifu stále počítat jako spotřeba **jedné zprávy**.

Pokud se halucinace opakují v určitém kontextu nebo na konkrétní typy dotazů, zkuste upravit `system prompt` (např. přidáním instrukce do sekce "KRITICKÉ CHYBY") nebo relevantní části vašeho nahraného know-how.

### Moje BuddyPro instance mi v Telegramu na telefonu náhle začala odpovídat v jiném jazyce (např. anglicky), i když na PC komunikuje správně česky. Čím to může být?

Toto chování pravděpodobně nesouvisí přímo s vaší BuddyPro instancí, ale s nastavením vaší Telegram aplikace v telefonu. Pokud máte předplatné Telegram Premium, mohla se vám (i nechtěně) aktivovat funkce "Translate Entire Chats" (Přeložit celé chaty) nebo podobná funkce pro automatický překlad. Zkontrolujte nastavení překladu přímo v Telegram aplikaci na vašem telefonu (obvykle v Nastavení -> Jazyk nebo Nastavení Chatu).

## Co vše se počítá do limitu zpráv?

**Každá zpráva** v konverzaci (tam i zpět): od uživatele, od **BuddyPro** (text i audio=1), zprávy iniciované BuddyPro.

Uživatel může BuddyPro říct, aby mu nepsal sám od sebe, čímž ušetří zprávy, které by jinak byly spotřebovány automatickými zprávami.

## Může BuddyPro automaticky psát uživatelům? Jak nastavit frekvenci?

Ano, BuddyPro může sám iniciovat konverzaci s uživateli. Toto chování je ve výchozím nastavení zapnuté, ale lze ho upravit:

**Základní nastavení**:

- `/shouldInitiateMessages:true` - zapne automatické zprávy (výchozí nastavení)
- `/shouldInitiateMessages:false` - vypne automatické zprávy

**Jak to funguje**:

- BuddyPro standardně píše uživatelům přibližně 5 hodin po poslední konverzaci
- Pokud uživatel neodpoví, napíše znovu za 10 hodin
- Při další neaktivitě píše za 2 dny, pak s delšími intervaly

**Individuální nastavení**:

- Uživatel může BuddyPro sám říct “napiš mi sám od sebe” nebo “nepiš mi sám od sebe”
- BuddyPro toto nastavení respektuje pro konkrétního uživatele

**Omezení a plány**:

- Momentálně nelze přímo nastavit frekvenci zpráv (např. jednou týdně)
- Tato funkce by mohla být přidána v budoucích aktualizacích
- Z praxe vyplývá, že některým uživatelům se líbí, když jim BuddyPro občas napíše, zatímco jiní preferují komunikovat pouze, když sami chtějí

## Jak jsou generovány zprávy, které BuddyPro iniciuje sám? Můžu je ovlivnit?

- **Generování:** AI je tvoří **sama na základě kontextu** předchozích konverzací a profilu uživatele.
- **Ovlivnění:** **Zatím nelze** specifikovat konkrétní příklady nebo témata pro tyto iniciované zprávy. Tato možnost bude pravděpodobně přidána později.

**Základní nastavení**:

- `/shouldInitiateMessages:true` - zapne automatické zprávy (výchozí nastavení)
- `/shouldInitiateMessages:false` - vypne automatické zprávy

## Nastavil/a jsem si u BuddyPro připomínku, ale teď ji chci zrušit. Jak na to?

Pokud jste si u své BuddyPro instance nastavili připomínku a chcete ji zrušit, můžete postupovat následovně:

1. **Zeptejte se AI:** Napište své instanci například: "Mám u tebe nastavené nějaké připomínky?" nebo "Jaké mám aktivní připomínky?". BuddyPro by vám měl vypsat seznam vašich aktivních připomínek.
2. **Požádejte o zrušení:** Následně ji požádejte o zrušení konkrétní připomínky (např. "Zruš mi prosím připomínku na téma X") nebo všech připomínek ("Zruš mi všechny připomínky.").

## Jak funguje kreditový systém pro provoz mé BuddyPro instance? Kdo platí za zprávy a jak se kredity doplňují?

Máte **jeden centrální kreditový účet na jehož výši se kdykoliv můžete zeptat své BuddyPro licence**. Z něj se čerpají náklady na **všechny zprávy** ve vaší instanci (vaše, testerů, klientů) a další náklady na AI spojené s provozem vaší BuddyPro licence.

**Konkrétně se z kreditu hradí:**

1. **Vaše vlastní konverzace s vaší BuddyPro instancí:** Když s ní komunikujete jako vlastník, testujete ji nebo ji nastavujete.
2. **Konverzace vašich klientů/uživatelů s vaší BuddyPro instancí:** Každá zpráva odeslaná nebo přijatá vašimi uživateli (včetně těch v rámci trialu).
3. **Zpracování nahraných souborů:**
   - Přepis audio a video souborů na text.
   - Analýza textových dokumentů a URL adres.
4. **Generování a aktualizace rolí:** Proces vytváření a úprav expertních rolí na základě vašeho know-how.
5. **Další AI operace na pozadí:** Například práce s pamětí, profilování uživatele atd.

Na začátku máte určitý počáteční AI kredit součástí své licence. Tento počáteční kredit vám umožňuje spustit a otestovat vaši instanci, aniž byste museli ihned dobíjet další prostředky. Jakmile se kredit přiblíží vyčerpání, je potřeba propojit platební kartu pro automatické dobíjení, aby byl zajištěn nepřetržitý provoz vaší AI. Svůj aktuální zůstatek kreditů si můžete zjistit dotazem u vaší BuddyPro instance.

Při prvním dobití (nebo když kredit klesne) nastavíte **automatické dobíjení**: zadáte částku pro dobití a minimální limit, při kterém se dobíjení spustí. Vy platíte náklady za AI zprávy, klientům účtujete poplatek za přístup.

## Jak BuddyPro zajišťuje kontinuitu přístupu při opakovaných platbách (např. měsíční subscription)? Musí uživatel něco potvrzovat?

Při opakovaných platbách (např. měsíčních, čtvrtletních, ročních) za subscription si BuddyPro automaticky ověřuje stav platby přes API u propojeného platebního systému (Stripe nebo FAPI). Toto ověření probíhá typicky před tím, než AI uživateli odpoví, pokud by již mělo být zaplaceno další období.

Pokud je platební metoda uživatele (např. platební karta) aktivní a platba za další období úspěšně proběhne v platebním systému, přístup k BuddyPro pokračuje bez přerušení a uživatel nemusí nic potvrzovat. Pokud platba selže, platební systém se obvykle pokusí platbu provést několikrát znovu. Pokud ani poté nedojde k úhradě, přístup k BuddyPro bude automaticky pozastaven.

## Proč mi nefunguje příkaz `/teach`?

Příkaz `/teach` není v současné verzi BuddyPro implementován a není určen k běžnému používání vlastníky instancí. Pro "učení" vaší AI instance a předávání know-how slouží mechanismus nahrávání souborů a URL adres do složky `sources` na propojeném Google Drive a následné zpracování příkazem `/update`. Osobnost a specifické chování AI pak ladíte pomocí souboru `system_prompt.gdoc` a případně úpravou definic jednotlivých rolí.

## Současná verze BuddyPro ještě nemá všechny funkce, které bych si představoval/a. Jak k tomu mám přistupovat?

Je důležité si uvědomit, že platforma BuddyPro a vaše AI instance jsou na **začátku své cesty a neustále se vyvíjejí**. Představte si ji jako "miminko" s obrovským potenciálem. Vývojářský tým BuddyPro se aktivně rozšiřuje o zkušené AI specialisty a platforma bude procházet rychlým vývojem a přidáváním nových funkcí a vylepšení.

Přistupujte k tomu s trpělivostí a soucitem, pokud AI občas neudělá přesně to, co očekáváte. Zaměřte se na její současné silné stránky a potenciál do budoucna. I vy jako tvůrce se učíte, jak s ní nejlépe pracovat a jak ji integrovat do svého portfolia.

## Umí BuddyPro generovat obrázky (např. jednoduché nákresy)?

V současné době BuddyPro **neumí aktivně generovat obrázky nebo nákresy**.

- **Rozpoznávání textu na obrázcích:** Má schopnost číst text z obrázků, které mu uživatel pošle.
- **Plány do budoucna:** Funkce pro generování obrázků/fotek je v plánu, ale přesná podoba a možnosti (např. zda to zvládne technické nákresy) ještě nejsou specifikovány. Prozatím, pokud potřebujete AI popsat nějaký nákres, musíte to udělat slovně vy.

## Umí BuddyPro instance vygenerovat na základě mého know-how a specifikace od uživatele strukturovaný dokument (např. nějaký formulář pro úřady)?

BuddyPro **neumí přímo exportovat nebo generovat soubory typu PDF**.
Nicméně, AI **může být schopna vygenerovat text**, který odpovídá struktuře a obsahu požadovaného dokumentu, pokud ji k tomu správně instruujete.

- **Řešení přes roli:** Nejlepší způsob, jak toho dosáhnout, je vytvořit si vlastní specifickou **roli**. V definici této role detailně popíšete strukturu dokumentu, jednotlivé sekce, typy informací, které mají obsahovat, a jaké otázky má AI klást uživateli, aby získala potřebné údaje.
- **Výstup:** AI pak v rámci této role může uživateli v chatu poskytnout kompletní text dokumentu, který si uživatel může zkopírovat a vložit například do Wordu.
- Název role je klíčový, aby ji AI správně aktivovala, když uživatel požádá o vytvoření daného typu dokumentu.

---

# Jazykové možnosti

## V jakých jazycích BuddyPro funguje?

BuddyPro je multilingvální a dokáže komunikovat v desítkách jazyků bez ohledu na to, v jakém jazyce bylo nahráno know-how:

**Základní vlastnosti**:

- Komunikuje v jakémkoliv hlavním světovém jazyce
- Automaticky detekuje jazyk, kterým se na něj uživatel obrátí
- Při prvním přihlášení detekuje jazyk z nastavení Telegramu
- V dalších zprávách se řídí jazykem, kterým s ním uživatel komunikuje

**Jak to funguje v praxi**:

- I když nahrajete své know-how v češtině, BuddyPro dokáže toto know-how aplikovat a komunikovat např. v angličtině, španělštině nebo němčině
- Pokud uživatel přepne jazyk, BuddyPro začne odpovídat v novém jazyce bez ztráty kontextu
- Při nesprávné detekci jazyka na straně uživatele stačí říct “mluv se mnou česky/anglicky/slovensky” atd.

**Doporučení pro vícejazyčné know-how**:

- Pokud máte mix jazyků v know-how, nenastavujte v souboru `Transcription Settings` konkrétní jazyk
- AI sama rozpozná jazyk materiálů a správně je zpracuje
- Můžete také rozdělit nahrávání podle jazyků (nejprve nahrát všechny české materiály, pak anglické)

## Jak spravovat jazykové mutace BuddyPro pro mezinárodní trh?

AI instance je vícejazyčná. Musíte zajistit vícejazyčnost okolních prvků (prodejní stránky, platební brána, onboarding materiály, support).

## Lze nastavit „trial ended message“ ve více jazycích?

V současné době nelze nastavit “trial ended message” ve více jazycích. Je to statická zpráva, která se zobrazí, když uživateli dojdou trial zprávy:

**Současná situace**:

- Trial ended message nastavíte příkazem `/setTrialEndedMessage:{message}`
- Je to statická zpráva, která není generována AI
- Zobrazuje se ve stejném jazyce všem uživatelům bez ohledu na jejich preferovaný jazyk

**Doporučení**:

- “Pokud máte anglicky mluvící uživatele, mějte ji v angličtině. Když česky mluvícímu přijde zpráva v angličtině a nerozumí, může si to dát do překladače.”
- Pro mezinárodní publikum zvažte zprávu v angličtině nebo v jazyce většiny vašich uživatelů
- Zpráva musí obsahovat tag `<LINK>`, který bude nahrazen odkazem na vaši subscription URL

**Důležité poznamenat**:

- Zprávy před tím (upozornění, že trial brzy skončí) jsou generovány AI a ty jsou přizpůsobeny jazyku uživatele
- Trial ended message je poslední zpráva, kdy už není využíván AI model, proto není přizpůsobena jazyku

---

# Obchodní model

## Mám už kurzy a konzultace. Jak vlastně zapadá BuddyPro do mého byznysu? Je to jen další věc, co budu nabízet, nebo to mění způsob, jak podnikám?

BuddyPro představuje pro expertní byznys unikátní příležitost, jak přidat novou, **stabilní "softwarovou" vrstvu** ke stávajícím produktům (kurzy, e-booky, konzultace). Můžete o něm uvažovat jako o vlastním softwaru, který ale nevyžaduje řízení vývojářského týmu a starosti o technický vývoj – to zajišťuje tým BuddyPro.

**Výhody tohoto "softwarového" modelu pro váš expertní byznys:**

- **Věrnost klientů:** Uživatelé, kteří si zvyknou na hodnotu a pomoc vaší AI instance, budou pravděpodobně dlouhodobě věrní.
- **Stabilní příjem:** Model předplatného přináší pravidelný a předvídatelnější cashflow.
- **Uvolnění rukou:** AI instance pracuje za vás 24/7, aniž by vyžadovala vaši osobní časovou investici do každé interakce.
- **Evoluce expertního podnikání:** Převádíte své know-how do interaktivní a inteligentní podoby, což je budoucnost vzdělávání.

Není to tedy jen "další produkt", ale spíše evoluční krok, který může výrazně posílit a stabilizovat vaše podnikání. Je to také produkt, který se neustále vyvíjí a jehož schopnosti porostou.

## Může BuddyPro sám propagovat mé produkty/služby?

Ano, můžete ho nastavit, aby **doporučoval nabídky v relevantním kontextu**:

- **V roli:** Upravte definici role a přidejte instrukci k doporučení.
- **V know-how:** Vložte odkazy přímo do textu materiálů v `sources`.

Do budoucna se plánují i hromadné zprávy uživatelům.

## Mohu mít více BuddyPro (AI expertů) pro různé oblasti?

**Ano**, ale každá instance vyžaduje **samostatnou licenci**, bota a nastavení. Hodí se pro velmi odlišné obory, využití či cílové skupiny.

## Jaké jsou náklady na provoz?

- **Licence BuddyPro**.
- **Náklady na AI zprávy** podle použitého modelu:
- Model Smart: ~0.08 USD za zprávu
- Model Economy: ~0.05 USD za zprávu
- Model Nano: ~0.03 USD za zprávu (tento model zatím není k dispozici).

Výnosy závisí na vámi stanovené ceně a počtu klientů. Návratnost může být rychlá.

**Příklady nákladů a výnosů z reálné praxe - při průměrném 50% využití limitu zpráv:**

1. **Smart varianta (doporučeno)**:
   - Model Smart, 1000 zpráv měsíčně
   - AI náklady: 800 Kč/uživatel/měsíc
   - Prodejní cena: 2,990 Kč/měsíc
   - Zisková marže: 2,190 Kč/měsíc/uživatel
2. **Economy varianta**:
   - Model Economy, 500 zpráv měsíčně
   - AI náklady: 385 Kč/uživatel/měsíc
   - Prodejní cena: 1,290 Kč/měsíc
   - Zisková marže: 905 Kč/měsíc/uživatel

**Jak zjistit vaše přesné náklady a statistiky:**

Nově můžete jako vlastník nebo člen týmu použít příkaz `/stats`. Ten vám zobrazí přehledný report obsahující:

- **Celkové AI náklady** (včetně nákladů na trénink).
- **Průměrnou cenu za jednu zprávu** ve vaší instanci.
- **Aktuální stav AI kreditů**.
- **Statistiky za poslední týden a měsíc** (počet zpráv a náklady).
- **Celkové tržby** z propojených platebních systémů (Stripe/FAPI).

Díky tomu už nemusíte spoléhat na odhady, ale vidíte reálná data o ziskovosti vaší instance.

## Kolik stojí zpráva v BuddyPro?

Cena za jednu zprávu v BuddyPro závisí na zvoleném AI modelu:

**Základní ceny za zprávu**:

- Model Smart: ~0.08 USD
- Model Economy: ~0.05 USD
- Model Nano: ~0.03 USD (zatím není k dispozici)

**Faktory ovlivňující cenu**:

1. **Délka systémového promptu** - delší prompt znamená vyšší cenu za zprávu
2. **Délka historie konverzace** - dlouhodobý uživatel má o něco dražší zprávy, než nováček
3. **Typ dotazu** - komplexnější dotazy mohou být dražší než jednoduché

**Jak zjistit vaši průměrnou cenu:**
Pomocí příkazu `/stats` (dostupný pro ownera a členy týmu) můžete zjistit:

- **Celkovou průměrnou cenu za zprávu (`Total average AI cost per message`)** ve vaší instanci.
- **Průměrnou cenu za zprávy za poslední týden a měsíc.**

Tato data vám poskytnou přesný přehled o reálných nákladech a pomohou vám lépe nastavit cenotvorbu.

Je důležité si uvědomit, že ceny za zprávu se postupně snižují s vývojem AI technologií, což by mělo v budoucnu snižovat náklady na provoz.

### Orientační ceny hlasových zpráv a generování obrázků

Kromě textových odpovědí může BuddyPro pracovat také s **hlasovými zprávami** a **generováním obrázků**. Tyto funkce spotřebovávají AI kredity podobně jako přepisy know-how.

Ceny se mohou mírně lišit podle použitého AI modelu a délky vstupu, ale orientačně platí:

**Hlasové zprávy (přepis + zpracování):**

- 1 minuta: přibližně **$0.07**
- 2 minuty: přibližně **$0.074**
- 5 minut: přibližně **$0.083**
- 20 minut: přibližně **$0.15**

**Generování obrázků:**

- přibližně **$0.03 – $0.15** za jeden obrázek

Tyto částky slouží **pouze jako orientační odhad**. Skutečná spotřeba se může lišit podle konkrétní konfigurace a způsobu používání.

## **Jaký je kromě ceny hlavní rozdíl ve schopnostech AI modelů Smart, Economy a Nano? Kdy který model zvolit?**

Kromě ceny se modely Smart, Economy a Nano liší především v **úrovni "inteligence", bystrosti odpovědí a schopnosti hlubší analýzy a kreativity.** Pavel Říha to přirovnává k rozdílům v IQ:

- **Smart:**
  - **Charakteristika:** Nejvyšší "IQ", nejbystřejší, nejlépe chápe nuance, poskytuje nejkreativnější a nejpropracovanější odpovědi. Je obzvláště silný v úkolech vyžadujících psaní a copywriting.
  - **Kdy zvolit:** Pokud požadujete maximální kvalitu odpovědí, vaše téma je komplexní, potřebujete generovat kvalitní texty (např. marketingové, prodejní), nebo chcete poskytnout naprosto prémiový zážitek. Pro Online Stratéga Pavla Říhy byl Smart volbou kvůli copywritingu.
- **Economy:**
  - **Charakteristika:** O něco nižší "IQ" než Smart (řekněme o 10 bodů). Stále velmi schopný model, ale může být méně "ostrý" v některých komplexních úlohách.
  - **Kdy zvolit:** Pro mnoho témat, zejména těch "měkčích" (osobní rozvoj, vztahy, coaching, kde jde více o sdílení a emoce), může Economy podávat srovnatelný výkon jako Smart. Je to dobrý kompromis mezi výkonem a cenou.
- **Nano: (zatím není k dispozici)**
  - **Charakteristika:** Nejnižší "IQ" z těchto tří (o dalších cca 10 bodů méně než Economy). Odpovědi mohou být generičtější, více povrchní a AI se méně často "trefí" s brilantním nápadem nebo hlubokým vhledem.
  - **Kdy zvolit:** Pokud je cena absolutní prioritou a vaše know-how a požadavky na AI nejsou extrémně komplexní. Může stačit pro základní informační podporu nebo jednodušší interakce.

**Doporučení:**

- **Testování:** Nejlepší je si různé modely vyzkoušet na vaší vlastní instanci a know-how, abyste posoudili, který je pro vaše potřeby nejvhodnější. Tato možnost bude dostupná (modely Economy a Nano od června).
- **Možnost změny:** Budete moci jako správce měnit model pro konkrétní tarif, i když byl původně nastaven na jiný.

Volba modelu závisí na vašem oboru, typu know-how, očekáváních vašich klientů a vaší cenové strategii.

Modely Economy a Nano budou k dispozici během června 2025.

## Jak mám kalkulovat reálné náklady na provoz mé instance vzhledem k nastaveným limitům zpráv pro uživatele? Platím vždy plnou cenu za celý limit?

Při kalkulaci reálných nákladů na provoz vaší BuddyPro instance je důležité vědět, že **obvykle nebudete platit plnou cenu za maximální možný počet zpráv** u všech vašich uživatelů.

**Klíčové faktory:**

- **Průměrné využití limitu:** Zkušenosti ukazují, že uživatelé v průměru spotřebují přibližně **50-80 %** svého měsíčního limitu zpráv. Vždy budou existovat uživatelé, kteří limit vyčerpají celý, ale i tací, kteří v daném měsíci využijí jen malou část.
  - *Příklad Pavla Říhy s Online Stratégem:* Při tarifu 1000 zpráv měsíčně (model Smart, teoretické náklady cca 0.08 USD/zpráva \* 1000 = 80 USD) jsou reálné průměrné náklady na uživatele cca 800 Kč (přibližně 35 USD), což naznačuje využití limitu hluboko pod 100 % (v tomto případě spíše kolem 50 %).
- **Neplatíte za nevyužité zprávy:** Platíte pouze za skutečně odeslané a přijaté zprávy.
- **Optimalizace nákladů:**
  - **Počet zpráv v tarifu:** Nemusíte nabízet extrémně vysoké limity (např. 1000 zpráv). Pro mnoho účelů může stačit 500 zpráv měsíčně nebo i méně.
  - **Trial verze u bonusů:** Pokud nabízíte AI jako bonus k hlavnímu produktu, můžete v trialu poskytnout menší celkový počet zpráv (např. 2000 zpráv jednorázově) místo vysokého měsíčního limitu.

Při stanovení ceny vašich tarifů tedy počítejte s tím, že vaše skutečné náklady na AI zprávy budou pravděpodobně nižší než teoretické maximum vypočtené jako (cena za zprávu _ limit zpráv _ počet uživatelů). Doporučuje se sledovat reálnou spotřebu a podle toho případně upravovat cenotvorbu nebo limity.

Jako vlastník (owner) nebo člen týmu použijte příkaz `/stats`. Tento příkaz vám poskytne podrobný report, kde uvidíte:

- **Přesné celkové AI náklady** vaší instance.
- **Celkový počet odeslaných zpráv.**
- **Průměrnou cenu za jednu zprávu.**
- **Statistiky nákladů a zpráv za poslední týden a měsíc.**

Díky tomu můžete přesně kalkulovat ziskovost, optimalizovat cenotvorbu a sledovat, jak se náklady vyvíjejí v čase.

## Jak mám přistupovat k cenotvorbě mé BuddyPro instance, když existují levné nebo zdarma dostupné obecné AI nástroje jako ChatGPT?

Je klíčové **nepouštět se do cenové války** s obecnými AI nástroji. Místo toho se zaměřte na komunikaci **unikátní hodnoty a prémiovosti** vaší specializované BuddyPro instance.

**Strategie a argumenty:**

1. **Vložili jste *své* know-how:** Vaše AI obsahuje vaše unikátní zkušenosti, metody, příběhy a ověřené postupy. To je něco, co obecné AI nemají. Je to jako mít přístup k vaší digitální knihovně s osobním průvodcem.
2. **Osobní značka a důvěra:** Lidé, kteří vás sledují, vyhledávají váš pohled a důvěřují vaší expertíze. Vaše AI je rozšířením této důvěry.
3. **Specializace vs. generalizace:**
   - Přirovnejte to k hypermarketu (ChatGPT – má všechno, ale povrchně) vs. specializovanému butiku nebo komorní kavárně (vaše AI – hluboké znalosti v konkrétní oblasti, specifická atmosféra a přístup).
   - Obecné AI jsou jako švýcarský nůž, vaše AI je specializovaný nástroj pro konkrétní úkol.
4. **Učit klienty používat *váš* nástroj:** Mnoho lidí sice zná ChatGPT, ale neumí ho efektivně využít pro specifické úkoly ve vašem oboru. Vy je můžete naučit (prostřednictvím vaší AI instance a onboardingu), jak dosáhnout výsledků s nástrojem přesně přizpůsobeným jejich potřebám.
5. **Hlubší funkce BuddyPro:** BuddyPro nabízí funkce jako dlouhodobá paměť, budování vztahu s uživatelem, propracovaný systém rolí, které obecné platformy v základní verzi často nemají tak rozvinuté pro specifické účely.
6. **Komunita a kontext:** Vaše AI je určena pro vaši komunitu a řeší její specifické potřeby.
7. **Nemusíte mít miliony uživatelů:** Na rozdíl od ChatGPT nepotřebujete masové množství uživatelů. I 100 platících klientů může generovat zajímavý příjem.
8. **Oddělte se od "chatbota zdarma":** Prezentujte svou AI jako sofistikovaného expertního asistenta, digitálního kolegu, nikoliv jen dalšího chatbota. Valorizujte své vložené know-how.

Nebojte se stanovit prémiovou cenu, která odpovídá hodnotě, kterou poskytujete. Dovolte klientům používat i jiné AI nástroje – vaše instance může být jedním z několika nástrojů, které používají, ale pro vaši specializaci bude tou nejlepší volbou.

## Mám poradenský byznys pokrývající více odlišných, i když souvisejících oblastí Je lepší všechna témata integrovat do jedné BuddyPro instance, nebo vytvořit pro každou oblast samostatnou instanci? Jaký je doporučený postup?

Toto je častá otázka a finální rozhodnutí závisí na specifikách vašeho byznysu a cílů. Zde je doporučený postup a úvahy:

**Doporučený postup:**

1. **Začněte s jednou instancí:** Obecně se doporučuje začít s integrací veškerého vašeho relevantního know-how do jedné hlavní instance. To zjednodušuje správu, marketing a uživatelskou zkušenost na začátku.
2. **Postupné přidávání know-how:** Pokud máte v jedné oblasti know-how již připravené a v dalších zatím ne, můžete začít s propagací instance zaměřené na tuto jednu oblast a postupně ji "doučovat" další témata.
3. **Testujte a vyhodnocujte:** Sledujte, jak se instance chová, když má k dispozici širší spektrum znalostí. Pokud klient řeší jen jednu oblast, AI by o ostatních neměla aktivně mluvit, pokud se na ně nezeptá.

**Kdy zvážit více instancí:**

- **Výrazně odlišné `System Prompty`:** Pokud pro každou oblast potřebujete, aby AI měla dramaticky odlišnou osobnost, styl komunikace, specifická pravidla nebo disclaimery, které by se v jednom `System Promptu` těžko kombinovaly nebo by ho činily příliš komplexním.
- **Velmi odlišné cílové skupiny:** Pokud jsou cílové skupiny pro jednotlivé oblasti natolik odlišné, že by společná komunikace a nabídka nedávaly smysl.
- **Odlišná cenová politika:** Pokud chcete pro každou oblast nastavit výrazně jinou cenu přístupu.
- **Přehlednost a specializace:** Pokud jsou jednotlivé oblasti velmi rozsáhlé a obáváte se, že by jedna instance "vědoucí všechno" mohla být pro uživatele nebo pro vás méně přehledná.
- **Marketingové účely:** Pokud chcete každou "expertní AI" budovat jako samostatnou značku.

**Úvahy:**

- **Komplexita:** Více instancí znamená více práce s nastavováním, tréninkem a marketingem každé z nich. Snažte se vyhnout zbytečné komplexitě, která může brzdit realizaci.
- **Překryv témat:** Pokud se témata často překrývají a jeden klient může potřebovat poradenství napříč oblastmi, jedna instance může být výhodnější.
- **Náklady:** Každá další instance BuddyPro vyžaduje samostatnou licenci (i když pro více instancí mohou existovat zvýhodněné podmínky – informujte se u podpory).

**Závěr:** Začněte s jednou instancí. Pokud se po pečlivém zvážení a testování ukáže, že oddělené instance dávají větší smysl pro vaši strategii a cíle, můžete je vytvořit později.

## Jaký je očekávaný vývoj cen AI technologií a jak to může ovlivnit cenotvorbu mé BuddyPro instance v budoucnu?

Očekává se dvojí trend ve vývoji cen AI technologií:

1. **Snižování cen za stávající výkon:** Cena za stejnou úroveň "inteligence" a výpočetního výkonu AI modelů bude pravděpodobně postupně klesat. To znamená, že provozní náklady na AI, která poskytuje určitý standard odpovědí (např. současný model "Smart" nebo "Economy"), by se měly časem snižovat.
2. **Vznik nových, výkonnějších (a dražších) modelů:** Současně budou přicházet na trh nové, ještě pokročilejší a "chytřejší" AI modely, schopné řešit komplexnější úkoly. Tyto špičkové modely budou pravděpodobně zpočátku dražší. Již nyní vidíme, že OpenAI a Google nabízejí prémiové tarify pro své nejlepší modely v řádu stovek dolarů měsíčně.

**Pro vaši BuddyPro instanci to znamená:**

- **Flexibilita v nabídce:** Budete moci nabízet různé tarify postavené na různých AI modelech (např. základní tarif s modelem Nano/Economy, prémiový tarif s modelem Smart nebo budoucími ještě pokročilejšími modely).
- **Možnost optimalizace nákladů:** Pokud se rozhodnete, že pro vaši cílovou skupinu a typ know-how je dostačující méně nákladný model (např. Economy), můžete snížit své provozní náklady.
- **Prémiové pozicování:** Stále bude prostor pro prémiové AI služby, zvláště pokud budou využívat nejnovější a nejvýkonnější technologie. Nebojte se vaši specializovanou AI instanci prezentovat jako profesionální nástroj, jehož cena odpovídá tržním standardům pro pokročilé AI.

Celkově by se měla zvyšovat dostupnost AI, ale současně se bude rozšiřovat i nabídka high-end AI řešení pro náročné uživatele a specifické účely.

## Když od Buddyho dostanu velmi dlouhou odpověď (několik odstavců), počítá se to jako 1 zpráva? Obdobně, když nahrávám hlasovku o délce třeba 2 minuty, je to jedna zpráva, nebo více?

I dlouhá odpověď, hodně odstavců, je jedna zpráva. Stejně tak hlasovka.

## Je lepší prodávat BuddyPro samostatně nebo jako součást většího balíčku služeb?

Obojí má své výhody. Neexistuje univerzální odpověď - záleží na vaší cílové skupině, typu know-how a obchodním modelu. Z našich zkušeností vyplývají tři hlavní obchodní modely:

1. **Samostatný produkt**:
   - Měsíční/roční předplatné
   - Jasná hodnotová nabídka
   - Vhodné pro experty s dobře definovaným know-how
   - Výhoda: jednoduchý prodej, jasné měření úspěchu
2. **VIP členství kombinující AI s osobními konzultacemi**:
   - Vyšší cenová kategorie (např. 15 konzultací + přístup k AI)
   - Kombinace škálovatelnosti AI a osobního přístupu
   - Vhodné pro prémiové služby a koučink
   - Výhoda: vysoká hodnota, kombinace osobního kontaktu s nepřetržitou podporou
3. **Podpůrný nástroj k existujícím kurzům a službám**:
   - AI jako bonus pro platící klienty
   - Zvýšení hodnoty existujících produktů
   - Vhodné pro experty s existujícím portfoliem
   - Výhoda: zvýšení retence, lepší výsledky klientů

## Je platební brána FAPI použitelná pouze pro český trh, nebo ji mohu využít i pro prodej mé BuddyPro instance zákazníkům v zahraničí?

FAPI není omezeno pouze na Českou republiku. Podle informací by mělo FAPI podporovat:

- **Více jazyků pro formuláře:** Minimálně angličtinu a němčinu.
- **Platby v různých měnách.** Pro specifické země mimo EU (jako je Švýcarsko) je však vhodnější počkat na integraci se **Stripe** (plánováno do konce června 2025), který je pro mezinárodní platby obecně lépe uzpůsoben a známější. Ověřte si aktuální možnosti vícejazyčnosti a podpory měn přímo u FAPI.

---

# Tvorba tarifů

## Jak nastavit tarify a ceny pro můj BuddyPro?

Při nastavování tarifů pro BuddyPro je potřeba zvážit několik klíčových aspektů:

**1. Technické parametry tarifu**:

- **Délka předplatného** - měsíční, čtvrtletní, roční
- **Preferovaný AI model** - Smart (nejlepší), Economy nebo Nano
- **Limit zpráv** - např. 500, 1000 nebo 2000 zpráv měsíčně
- **Možnost dokoupení balíčků zpráv** - pro situace, kdy uživatel vyčerpá měsíční limit

**2. Cenová strategie**:

- Doporučuje se nastavit BuddyPro na model Smart a prodávat jako prémiový produkt (cca 2,000-3,000 Kč měsíčně), ale možné jsou i jiné varianty specifické pro vaše publikum a byznys model
- Vytvořte různé cenové úrovně pro různé typy klientů (základní, střední, prémiový)

**3. Proces nastavení v systému**:

1. Vytvořte produkty v platebním systému Stripe/FAPI
2. Propojte FAPI formuláře s BuddyPro pomocí `/connectForm:{id}:{productId}:{type}:{messages}`
   - toto není potřeba dělat pokud máte integraci se Stripe
3. Nastavte URL pro nákup subscription `/setDefaultSubscriptionUrl:{url}`
4. Nastavte URL pro upgrade nebo dokoupení zpráv `/setUpgradeSubscriptionUrl:{url}`

**4. Praktické příklady tarifů**:

- **Prémiový**: 2,990 Kč/měsíc, 1000 zpráv, model Smart
- **Standardní**: 1,290 Kč/měsíc, 500 zpráv, model Economy
- **Základní**: 490 Kč/měsíc, 350 zpráv, model Nano (zaítm není k dispozici)

Tyto příklady počítají s tím, že většina uživatelů nevyčerpá plný měsíční limit zpráv, což snižuje skutečné náklady oproti teoretickému maximu.

## Když má klient tarif např. 1000 zpráv měsíčně, znamená to 1000 jeho zpráv, nebo celkem?

Jedná se o **obousměrný počet**, tedy 1000 zpráv v konverzaci (500 od klienta a 500 od AI)

## Je cena za AI zprávu konečná, nebo se k ní ještě připočítává DPH?

Cena za AI zprávu, která se obvykle uvádí, je základní cena bez DPH. Při nákupu (dobíjení) AI kreditů pro provoz vaší BuddyPro instance vám bude k ceně kreditů připočteno DPH dle platné legislativy a vaší územní příslušnosti. Faktura za dobití kreditů by měla DPH jasně specifikovat.

## Jakou cenovou strategii (výše poplatku, délka tarifu) zvolit pro AI experta?

**Cena:** Zvažte prémiové pozicování (Pavel Říha doporučuje 2000-3000 Kč/měsíc).

**Startovací nabídka:** Např. Prodej zahajte nabídkou ročního či půlročního balíčku, až později nabídněte měsíční variantu.

**Půlroční tarif:** Často efektivnější než roční. Může mít opticky nižší cenu na webináři, i když přepočtená měsíční sazba je vyšší. Lidé méně řeší rozdíl 6 vs. 12 měsíců.

**Optimalizace:** S příchodem levnějšího AI modelu "Economy" a obecným zlevňováním AI se budou náklady snižovat.

## Jaký je vztah mezi měsíčním limitem zpráv a periodou placení (měsíc/rok)?

Limit zpráv (např. 500) je **vždy měsíční**, bez ohledu na to, zda klient platí měsíčně nebo ročně. Počet zpráv se **resetuje každý měsíc**, nevyčerpané zprávy se nepřevádějí (kromě dokoupených balíčků). Při nastavování tarifu (metadata → messages na produktu pro Stripe integraci, nebo parametr
`{zprávy}` v `/connectForm` pro FAPI integraci) tedy zadáváte vždy _měsíční_ limit zpráv, i když propojujete roční FAPI formulář.

## Jde nastavit různé podmínky pro první a následující období předplatného? Například zvýhodněné předplatné na první měsíc, nebo půlroční předplatné s navazujícími měsíčními platbami?

Ano, **toto jde nastavit pokud máte integraci s FAPI - různé podmínky pro první a následující období předplatného.** To je jedna z velkých výhod, kterou umožňuje integrace s prodejním systémem FAPI (který je s BuddyPro kompatibilní). Integrace se Stripe toto zatím neumožňuje.

**Můžete tak s FAPI integrací vytvořit například následující scénáře:**

1. **Zvýhodněné první období (např. první měsíc):**
   - Můžete nabídnout první měsíc předplatného za nižší, "zaváděcí" cenu, aby si klienti mohli službu vyzkoušet s menší počáteční investicí.
   - Po uplynutí tohoto prvního měsíce se předplatné automaticky přepne na standardní měsíční cenu.
   - **Příklad:** První měsíc za symbolických 490 Kč, poté každý další měsíc za 2990 Kč.
2. **Delší první období s navazujícími kratšími platbami:**
   - Můžete nabídnout první předplatné na delší dobu (např. čtvrtletí nebo půlrok) za určitou cenu, a po jeho skončení se platby automaticky změní na pravidelné měsíční platby.
   - Toto se hodí například pro úvodní kampaně, kde chcete získat větší počáteční závazek, ale zároveň pak klientům nabídnout flexibilitu měsíčních plateb.
   - **Příklad:** První půlrok za jednorázovou platbu 17960 Kč, poté automaticky měsíční platby ve výši 2990 Kč.

**Jak to funguje (pouze s FAPI):**

- Ve FAPI můžete nastavit "první platbu" (nebo "zahajovací poplatek") s jinou částkou a/nebo délkou období než "následné opakované platby".

* Ve FAPI hledejte tuto funkcionalitu v nastavení prodejního formuláře, v části "Pravidelná fakturace", kde stačí zaškrtnout "Nahradit položku v 2. a další pravidelné faktuře" a následně vybrat a následně vybrat jednu položku pro první platbu, a jinou pro následné opakované platby.

- Systém pak automaticky řídí, kdy a jaká částka se má strhnout.

**Výhody této flexibility:**

- **Marketingové akce:** Umožňuje vytvářet atraktivní zahajovací nabídky.
- **Snížení vstupní bariéry:** Nižší první platba může přesvědčit více váhajících zákazníků.
- **Optimalizace cashflow:** Delší první období může přinést vyšší počáteční příjem.
- **Budování závazku:** Klienti, kteří zaplatí za delší období, mají větší motivaci službu aktivně využívat.

Je to tedy velmi užitečný nástroj pro strategickou cenotvorbu a prodej vaší BuddyPro instance.

## Pokud uživatel koupí přímo z mého webu (ne přes odkaz z Telegramu), jak se nákup spojí s jeho účtem?

Pro FAPI integraci je klíčové je mít správně nastavený **aktivační odkaz** na **děkovací stránce FAPI** a v **potvrzovacím emailu FAPI**:

1. Uživatel koupí tarif/balíček přes váš webový formulář.
2. Po úspěšné platbě se mu zobrazí děkovací stránka a přijde email – obojí musí obsahovat speciální aktivační odkaz (ten získáte při `/connectForm`).
3. Uživatel **klikne na tento odkaz**. Tím je přesměrován do Telegramu a jeho nákup se automaticky spojí s jeho účtem v BuddyPro.

Pro Stripe integraci není potřeba nic nastavovat, uživateli automaticky přijde email s aktivačním odkazem nebo se mu nákup propojí a aktivuje automaticky.

## Mám klienty, kteří mi již platí pravidelnou platbu za jinou službu. Mohu na tuto existující platbu "navázat" BuddyPro subscription, aby nemuseli zadávat novou?

Ne, toto bohužel není možné. Každá BuddyPro subscription (předplatné) vyžaduje svůj vlastní, samostatně vytvořený produkt a prodejní formulář v platebním systému (Stripe/FAPI), který je následně specificky propojen s vaší BuddyPro instancí. Systém BuddyPro nedokáže "připojit" subscription k již existující, nepřiřazené opakované platbě, která byla vytvořena pro jiný účel. Klient bude muset projít procesem objednávky a platby přes formulář určený pro danou BuddyPro subscription. K této subscription zároveň můžete přidat zpřístupnění jiného produktu či služby.

## Podporuje BuddyPro integraci s prodejním formulářem, na který je uplatněn slevový kód?

Ano, integrace BuddyPro by měla správně fungovat i v případě, že na prodejní formulář je uplatněn slevový kód. Systém BuddyPro registruje úspěšnou platbu (bez ohledu na to, zda byla plná cena nebo cena po slevě) a na jejím základě aktivuje příslušný tarif nebo balíček zpráv. Přesto doporučujeme tuto funkcionalitu vždy důkladně otestovat na zkušebním nákupu, abyste si ověřili, že vše probíhá podle očekávání.

## K čemu fungují kredity a jak je nastavím?

Kredity v BuddyPro slouží k pokrytí nákladů na AI zpracování:

**Co jsou kredity a jak fungují**:

- Jako majitel BuddyPro dostanete výchozí kredit
- Kredit se odečítá podle počtu a typu zpracovaných zpráv
- Kreditový systém je oddělený od plateb vašich klientů - vy platíte platformě za AI zpracování, klienti platí vám za přístup
- Když kredit klesne pod vámi stanovenou částku, automaticky se dobije

**Nastavení kreditů**:

- Nastavení kreditů se provádí příkazem `/setupCredits`
- Musíte zadat platební kartu, která bude použita pro automatické dobíjení
- Stanovíte limit, na který se mají kredity doplnit (např. $500)
- Určíte minimální hranici, při které dojde k dobití (např. $250)

**Kontrola stavu kreditů**:

- Zeptat se přímo BuddyPro: “Jaká je výše mého BuddyPro kreditu?”
- V případě, že kredit klesne pod nastavenou hranici a platba neprojde, BuddyPro vás upozorní zprávou

**Doporučení**:

- Nastavte automatické dobíjení, abyste předešli přerušení funkčnosti
- Průběžně sledujte spotřebu kreditů, abyste měli přehled o nákladech
- Zohledněte náklady na kredity při stanovování cen pro vaše klienty

## Jak zjistím svůj aktuální zůstatek AI kreditů?

Jednoduše se **zeptejte své BuddyPro instance konverzačně**, například:

- "Kolik mám AI kreditů?"
- "Jaký je stav mých kreditů?"

BuddyPro by vám měl odpovědět aktuálním zůstatkem v USD (1 kredit = 1 USD).

Alternativně použijte příkaz `/stats`.

Tento příkaz vám zobrazí komplexní statistický report, kde najdete řádek **`Credits`**. Tento údaj ukazuje váš aktuální zůstatek AI kreditů v USD.

Příkaz `/stats` je nejpřesnější a nejrychlejší způsob, jak zjistit nejen stav kreditů, ale i další klíčové metriky vaší instance.

## Co se stane, když klient vyčerpá měsíční limit zpráv a jak funguje dokupování zpráv?

Když klient vyčerpá měsíční limit zpráv, dojde k následujícímu procesu:

**Co se stane při vyčerpání limitu**:

1. BuddyPro uživateli oznámí, že se blíží k vyčerpání limitu (několik zpráv předem)
2. Po vyčerpání limitů nabídne možnost dokoupit si balíček extra zpráv nebo přejít na vyšší tarif
3. Klient je přesměrován na URL, kterou jste nastavili příkazem `/setUpgradeSubscriptionUrl:{url}`

**Jak fungují balíčky zpráv**:

- Jsou jednorázové platby za určitý počet zpráv
- Na rozdíl od měsíčního limitu se nepřepisují s novým měsícem, ale přenášejí se do dalších období
- Čerpají se až po vyčerpání měsíčního limitu
- Pro každý balíček (pokud nabízíte více variant) je potřeba vytvořit samostatný prodejní formulář
- Spojují se s uživatelem pomocí parametru v URL

**Nastavení systému dokupování zpráv (FAPI integrace)**:

1. Vytvořte produkty vašich balíčků zpráv ve FAPI
2. Propojte je s BuddyPro pomocí `/connectForm:{id}:{productId}:package:{messages}`
3. Nastavte URL pro upgrade pomocí `/setUpgradeSubscriptionUrl:{url}`
4. Zajistěte, že se parametr userId přenáší z odkazu na formulář

**Nastavení systému dokupování zpráv (Stripe integrace)**:

1. Vytvořte produkty vašich balíčků zpráv ve Stripe
2. Nastavte správně metadata produktu `case: buddy_pro` a `messages: 500` (příklad)
3. Nastavte URL pro upgrade pomocí `/setUpgradeSubscriptionUrl:{url}`
4. Pokud odkaz není přímo Stripe formulář, zajistěte, že se parametr `client_reference_id` přenáší z rozcestníku na formulář

**Doporučení pro efektivní nastavení**:

- Nabídněte 2-3 různé balíčky zpráv (např. 200, 500, 1000 zpráv)
- Stanovte cenu tak, aby byla o něco vyšší než poměrná část měsíčního tarifu
- U ročních tarifů je vhodné řešit navýšení primárně přes balíčky, ne přes upgrade tarifu

## Lze nastavit platby v různých měnách?

Ano, **ve Stripe i FAPI** můžete nastavit více měn. V **BuddyPro** (`/setDefaultCost:{defaultCost}:{defaultCostCurrency}:{defaultCostPeriod}:{defaultCostPeriodCount}:{discountedCost}`) informujete jen o jedné hlavní měně.

## Může uživatel využívat balíček zpráv po zrušení nebo skončení předplatného?

Ne.

Pokud je předplatné ukončeno (například pomocí příkazu `/stop`), předplatné zůstává aktivní až do konce aktuálního fakturačního období.

To znamená:

- Uživatel může Buddyho využívat až do data, kdy by došlo k dalšímu obnovení a platbě.
- Po uplynutí tohoto období se přístup automaticky deaktivuje.

Jakmile předplatné definitivně skončí (nedojde k obnovení platby), uživatel:

- ztratí přístup k BuddyPro instanci,
- a nemůže využívat ani zbývající balíček zpráv.

Balíček zpráv je tedy vždy podmíněn aktivním předplatným.

## Proč nejsou moje platby ze Stripe v BuddyPro rozpoznány?

Ve většině případů je důvodem to, že **není správně nastavená metadata na úrovni produktu (Product) ve Stripe**.

I když máte metadata vyplněná na Payment Linku nebo u konkrétní ceny (Price), BuddyPro vyžaduje, aby byla metadata nastavena přímo na samotném produktu.

Pokud metadata chybí nebo jsou vyplněna nesprávně, BuddyPro nedokáže platbu přiřadit k vaší AI instanci a uživateli nebude automaticky udělen přístup.

## Proč moji uživatelé nedostávají potvrzovací e-mail po zakoupení předplatného přes Stripe?

Nejčastější příčiny jsou:

- Stripe nemá aktivní odesílání zákaznických e-mailů
- Metadata na produktu nejsou správně nastavena
- Platba proběhla, ale BuddyPro ji nedokázal přiřadit kvůli chybějícím nebo nesprávným metadatům

## Mohu svým klientům nabídnout platbu za BuddyPro tarify bankovním převodem místo platební kartou?

Ano, obecně je možné nabídnout platbu bankovním převodem, pokud to váš integrovaný platební systém podporuje a dokáže spolehlivě spárovat příchozí platbu s objednávkou a následně informovat BuddyPro.

Tento způsob je vhodnější pro:

- **Jednorázové platby:** Například za balíčky zpráv (packages) nebo za delší období, např. roční platbu u subscription tarifu.
- **Problémy s pravidelnými platbami:** U opakovaných plateb (typických pro subscription tarify) je bankovní převod problematický, protože neumožňuje automatické strhávání částky. To by vyžadovalo manuální sledování plateb a případně manuální prodlužování přístupu, což není škálovatelné. Pro pravidelné subscription tarify je důrazně doporučeno využívat platby kartou s automatickým obnovováním. Ověřte si konkrétní možnosti a omezení u svého poskytovatele platební brány.

## Co se stane, když uživateli skončí roční tarif?

Pokud je nastaven jako **subscription**, Stripe/FAPI se **automaticky pokusí strhnout platbu** na další rok. Pokud projde, pokračuje. Pokud ne, přístup se zablokuje.

**Proces při konci ročního tarifu**:

1. Předplatné se automaticky obnoví a bude účtováno znovu
2. Uživatel může předplatné zrušit před koncem období, pokud nechce pokračovat
3. V případě automatického obnovení pokračuje služba bez přerušení

**Co byste měli udělat jako majitel BuddyPro**:

- Je na vás, abyste hlídali blížící se konce ročních tarifů
- Doporučuje se kontaktovat klienty před obnovením a připomenout jim, že se blíží automatické prodloužení
- U ročních tarifů s dodatečnými službami (např. osobní konzultace) si dejte do kalendáře upozornění

**Technický aspekt**:

- Formuláře ve FAPI by měly být nastaveny jako “vystavovat pravidelné faktury” s automatickým strhávání z karty
- Nastavení ve FAPI by mělo být “subscription”, ne pevně stanovená doba

Pokud by klient chtěl svůj tarif ukončit, může to udělat sám ve svém účtu nebo kontaktovat podporu, případně napsat “stop” přímo BuddyPro, který ho navede, jak subscription zrušit.

## Co se stane, když uživatel nezaplatí?

Když uživatel nezaplatí nebo zablokuje platbu, dojde k následujícímu procesu:

**Technický proces**:

1. Systém se pokusí o opakovanou platbu
2. Pokud platba opakovaně selže, informace se přenese do BuddyPro
3. BuddyPro přestane uživateli odpovídat a bude ho informovat o problému s platbou
4. Uživatel bude mít možnost aktualizovat platební údaje nebo kontaktovat podporu

**Řešení z vaší strany**:

- Jako majitel BuddyPro nemusíte nic aktivně řešit - systém automaticky zablokuje přístup
- BuddyPro má vestavěnou logiku pro rozpoznání neplatičů a automatické omezení služby
- V případě, že klient vyřeší problém s platbou, přístup se automaticky obnoví

**V případě reklamace nebo vrácení peněz**:

- Pokud vracíte peníze ve Stripe nebo FAPI, je nutné také použít příkaz `/disableUser:{subscriptionId}` v BuddyPro
- Tímto příkazem deaktivujete přístup uživateli manuálně
- Bez tohoto kroku by uživatel mohl službu dále používat i po vrácení peněz

## Co se stane s nevyčerpanými zprávami z měsíčního limitu předplatného? Převádějí se?

Nevyčerpané zprávy z pravidelného měsíčního limitu se **nepřevádějí**. Limit se každý měsíc obnovuje. Dokoupené extra balíčky zpráv expiraci nemají a přenáší se až do vyčerpání.

## Lze nabízet samostatné balíčky zpráv, aniž by měl uživatel zakoupené předplatné?

Nabízet jen balíčky zpráv bez předplatného aktuálně není možné. Balíčky zpráv slouží jako rozšíření při vyčerpání měsíčního limitu zpráv v rámci předplatného.

## Jak funguje kombinace měsíčního předplatného a dokoupených balíčků zpráv? Převádějí se nevyčerpané zprávy?

Pokud má uživatel aktivní měsíční předplatné (subscription) a zároveň si dokoupí extra balíček zpráv (package):

- **Měsíční limit:** Zprávy z měsíčního limitu předplatného se na konci fakturačního období (typicky měsíce) **nepřevádějí** do dalšího období. Limit se každý měsíc obnovuje na plný počet zpráv daného tarifu.
- **Dokoupené balíčky:** Zprávy z dokoupených extra balíčků **nemají časovou expiraci** a přenášejí se do dalších období, dokud nejsou zcela vyčerpány.
- **Pořadí čerpání:** Nejprve se vždy čerpají zprávy z aktivního měsíčního limitu předplatného. Teprve po jejich úplném vyčerpání se začnou čerpat zprávy z dokoupených balíčků.

## Jaká je průměrná reálná spotřeba zpráv uživateli ve srovnání s jejich měsíčním limitem?

Uživatelé v průměru obvykle spotřebují **50-80 %** svého limitu. S tím je dobré počítat při cenotvorbě.

Nově si však můžete udělat přesnější obrázek o chování vašich vlastních uživatelů. Pomocí příkazu `/stats` získáte data o **celkovém počtu zpráv** a **počtu aktivních předplatitelů** za dané období. Vydělením těchto čísel získáte průměrnou spotřebu na uživatele ve vaší instanci a můžete si tak ověřit, jak se vaši uživatelé chovají v porovnání s obecným průměrem.

## Jak získám fakturu za licenci BuddyPro nebo za dobití AI kreditů?

Faktury by měly být zasílány **automaticky e-mailem** po provedení platby (jak za licenci, tak za dobití kreditu přes Stripe). Pokud vám faktura nepřišla (zkontrolujte i spam), kontaktujte podporu na `support@buddy.fm` a požádejte o její zaslání.

## Jak nastavit „trial“ pro neomezený počet lidí?

Pro nastavení zkušebního období (trialu) pro neomezený počet zákazníků postupujte takto:

**Vytvoření neomezené pozvánky**:

1. Použijte příkaz `/generateBuddyProInvite:{početZpráv}:{7místnýKód}`
2. Vynechejte třetí parametr (počet uživatelů) nebo nastavte na 0
3. Sdílejte vygenerovaný odkaz s potenciálními zákazníky

**Příklad příkazu**:

- `/generateBuddyProInvite:50:ABC1234` vytvoří pozvánku s 50 trial zprávami a kódem ABC1234 bez omezení počtu uživatelů

**Další možnosti nastavení**:

- Pomocí `/setInviteTrialMessages:{count}` můžete změnit výchozí počet trial zpráv pro všechny pozvánky
- Pomocí `/checkInvite:{code}` můžete sledovat, kolik lidí využilo konkrétní pozvánku
- Pro různé marketingové kampaně vytvořte různé pozvánkové kódy, abyste mohli měřit jejich úspěšnost

Do příkazu `/generateBuddyProInvite` přibyl 4. volitelný parametr: počet dní pro platnost trialu.

Trial končí, když uživatel vyčerpá zprávy nebo vyprší časový limit.

Formát:

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

Příklad trialu na 100 zpráv pro 5 uživatelů s platností 30 dní od aktivace:

`/generateBuddyProInvite:100:ABCDEFG:5:30`

## Může uživatel aktivovat zkušební období (trial) pomocí stejného pozvánkového odkazu vícekrát?

**Ne, nemělo by to být možné.** Systém je navržen tak, aby jeden uživatel (identifikovaný svým Telegram účtem) mohl využít konkrétní pozvánkový kód pouze jednou.

## Mohu uživateli, kterému došel trial, manuálně navýšit počet zpráv, aby mohl pokračovat se stejnou historií konverzace?

Ano, to je možné. Pokud chcete uživateli, který vyčerpal svůj původní trial limit, přidat další zprávy zdarma (aniž by musel kupovat předplatné), použijte příkaz:

```bash
/addTrialMessages:{userId}:{count}
```

Nahraďte `{userId}` jeho správným ID a `{count}` počtem zpráv, které chcete přidat. Tímto způsobem uživatel pokračuje se stejným účtem a historií.

## Jak můžu nabídnout BuddyPro svým spolupracovníkům bez účtování standardního paušálu?

Pro nabídnutí BuddyPro spolupracovníkům bez standardního paušálu existují dva hlavní přístupy:

**1. Pro spolupracovníky, kteří mají platit jen za zprávy**:

- Vytvořte speciální tarif s minimální cenou, která pokrývá pouze náklady na zprávy
- Můžete kalkulovat cenu podle průměrné ceny za zprávu (~0.08 USD)
- Vytvořte speciální prodejní formulář s touto cenou a sdílejte ho pouze s vašimi spolupracovníky

**2. Pro členy týmu, kteří neplatí vůbec**:

- Vygenerujte pozvánku s určitým počtem trial zpráv
- Používejte příkaz `/addTrialMessages:{userId}:{count}` k průběžnému přidávání zpráv
- Příklad: `/addTrialMessages:1234567890:300` přidá 300 zpráv uživateli s ID 1234567890
- Uživatel své ID zjistí příkazem `/myid`

**Další možnosti**:

- Můžete také využít příkaz `/setTrialMessages:{userId}:{count}` k nastavení přesného počtu zpráv
- Pro členy týmu, kteří pomáhají spravovat instanci, použijte `/addUserToTeam:{userId}#{telegram_username_vasi_buddypro_instance}`
- Tým může zahrnovat více lidí, kteří vám pomáhají s administrací a podporou

Tyto metody vám umožní flexibilně poskytovat přístup k vašemu BuddyPro interním týmům a spolupracovníkům bez nutnosti standardních plateb.

## Jaký počet zpráv by měla obsahovat zkušební (trial) verze a s jakými náklady počítat?

**Pro "studené" kontakty:** Trial na cca **50-100 zpráv** může být efektivní a vést cca k 3-10 % konverzi na placený tarif, který bude nabídnut po vyčerpání zpráv.

**Pro existující klienty (bonus k placenému produktu):** Můžete nabídnout štědřejší trial (např. 50-1000 zpráv zdarma s nabídkou placené verze po vyčerpání zpráv).

**Náklady:** Pamatujte, že každá zpráva zdarma vás něco stojí. Počet trial zpráv lze nastavit různě pro různé pozvánkové odkazy.

## Jak sledovat uživatele/trialy?

Pro sledování uživatelů, tarifů a využití trialu máte několik nástrojů:

1.  **Celkové statistiky a analytika (doporučený hlavní nástroj)**
    Nově můžete 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.
2.  **Kontrola využití pozvánkových kódů**:

- Příkaz `/checkInvite:{code}` vám ukáže:
- Kolik lidí použilo konkrétní pozvánku
- Kolik z nich si koupilo předplatné
- Kolik zpráv bylo v rámci trialu využito
- Tento příkaz je užitečný pro sledování konverzí z různých marketingových kanálů

3. **Získání informací o konkrétních uživatelích**:

- Příkaz `/getInfoAboutUser:{subscriptionId}` poskytne detailní informace:
- Stav předplatného
- Datum další obnovy
- Zbývající počet zpráv (z měsíčního limitu i z balíčků)
- Použitý tarif
- Historie plateb

4. **Vytvoření systému pro sledování**:

- Pro každou kampaň vytvořte unikátní pozvánkový kód
- Používejte různé prodejní formuláře pro různé tarify
- Díky tomu budete moci sledovat, ze kterých zdrojů přicházejí klienti a který tarif preferují

5.  **Možnosti v prodejním systému**:

- V samotném Stripe/FAPI můžete také sledovat počet prodaných tarifů a jejich typy
- Stripe/FAPI poskytuje přehled o aktivních předplatných a platbách

Kombinací těchto nástrojů získáte komplexní přehled o využívání vašeho BuddyPro a efektivitě různých marketingových kanálů.

Detailnější **analytika** v BuddyPro je ve vývoji.

## Chci u některých tarifů nastavit minimální dobu trvání členství (např. 4 měsíce) s měsíčními platbami. Jak zajistím, aby uživatel nemohl členství zrušit dříve přes BuddyPro?

BuddyPro samo o sobě nemá funkci pro vynucení minimální doby trvání předplatného, pokud platby probíhají opakovaně (např. měsíčně). Uživatel může standardně své aktivní předplatné zrušit několika způsoby:

1. **Příkazem `/stop`** v chatu se svou BuddyPro instancí.
2. Prostřednictvím odkazu pro **správu předplatného**, který obvykle obdrží v potvrzovacím emailu od platební brány (Stripe/FAPI) po zakoupení. Platební systém FAPI sice umožňuje u produktu nastavit "Fixní počet zaslání pravidelné faktury" (např. na 4 pro 4 měsíce), ale to primárně znamená, že po těchto 4 platbách se předplatné automaticky neobnoví, nikoliv že by bylo po tuto dobu nezrušitelné ze strany uživatele, pokud jsou platby měsíční. 

**Možná (ale ne zcela spolehlivá) řešení:**

- **Komunikace a VOP:** Jasně v obchodních podmínkách a při prodeji komunikovat závazek na minimální období.
- **Jednorázová platba za celé období:** Nejbezpečnější způsob, jak zajistit platbu za celé minimální období, je nabídnout tarif s jednorázovou platbou za toto období (např. "Tarif na 4 měsíce" s platbou celé částky najednou).

Je důležité si uvědomit, že i přes tato opatření může uživatel stále technicky zrušit platby u své banky nebo platební karty, což je mimo vaši přímou kontrolu.

---

# Marketing a prodej

## Jak mám svého Buddyho pojmenovat, aby to lidi zaujalo a chápali, co to je? Mám tam dát svoje jméno, nebo něco jiného?

Název vaší AI instance je důležitým prvkem jejího pozicování. Zvažte následující tři základní strategie:

1. **"Vaše Jméno/Značka + AI"** (např. "Pavel Říha AI", "Firma XYZ AI")
   - **Výhody:** Velmi efektivní, pokud máte silnou osobní značku nebo zavedenou firmu. Propojení je okamžitě jasné.
   - **Nevýhody/Úvahy:** AI nikdy nebude 100% vy, i když bude vycházet z vašeho know-how. Je třeba toto komunikovat.
   - **Vhodné pro:** Experti se silnou osobní značkou, firmy chtějící "digitalizovat" svou expertízu.
2. **"Expertní Role + AI"** (např. "Online Stratég AI", "Kouč Prosperitní Mysli AI")
   - **Výhody:** Jasně komunikuje zaměření AI. Přitahuje lidi, kteří řeší konkrétní oblast. Dobré pro trhy, kde je tento typ produktu nový.
   - **Nevýhody/Úvahy:** Může být méně osobní než první varianta.
   - **Vhodné pro:** Specializované oblasti, kde chcete zdůraznit odbornost a cílení.
3. **"Unikátní Osobní Jméno pro AI"** (např. "Mentor Max", "Asistentka Klára")
   - **Výhody:** Umožňuje vytvořit samostatnou "AI entitu" nebo "AI influencera". Může to být jméno z kalendáře nebo vymyšlené jméno. Dobré pro budování značky kolem samotné AI.
   - **Nevýhody/Úvahy:** Vyžaduje více úsilí pro vybudování známosti jména.
   - **Vhodné pro:** Dlouhodobou vizi AI jako samostatné "osobnosti", která může mít vlastní kanály, obsah atd. Zkontrolujte dostupnost domény (např. `.ai`).

Uživatelské jméno bota v Telegramu (username) nelze měnit, ale **zobrazovaný název bota lze kdykoliv změnit** přes `@BotFather`.

## Jakou doménu zvolit pro můj AI produkt? Musí to být `.ai`?

Nemusí. Zvažte dostupnost, cenu a působení na mezinárodním trhu. Pro český trh není `.ai` nutností. Pokud je váš název s `.ai` volný a cenově dostupný, může to být dobrá volba, zvláště pokud chcete jednu doménu pro český i zahraniční trh.

## Má smysl řešit, jak můj Buddy vypadá? Nějakou fotku nebo obrázek?

Ano, přemýšlet o vizuální podobě vaší AI instance je **velmi doporučené, zejména s ohledem na budoucnost**. I když současná interakce probíhá primárně textově a hlasově v Telegramu, platforma se bude vyvíjet.

**Proč je vizuální podoba důležitá:**

- **Budoucí formy komunikace:** Plánuje se, že s AI bude možné komunikovat přes Zoom nebo telefonicky. Vizuální podoba (avatar) bude při videohovorech klíčová.
- **AI Influencer:** Pokud plánujete využít koncept "AI Influencera", který má vlastní sociální sítě, tvoří videa nebo jiný multimediální obsah, vizuální podoba je nezbytná.
- **Vdechnutí života:** Pokud má mít AI avatar ústa a oči, lze jej snadněji animovat a "oživit" ve videích (např. pomocí AI nástrojů pro animaci).
- **Branding a zapamatovatelnost:** Unikátní vizuál pomáhá budovat značku vaší AI a zvyšuje její zapamatovatelnost.

Vizuální podoba může být animovaná, fotorealistická, může se podobat vám (jako AI verze vás) nebo být zcela unikátní. Pokud zatím nemáte ideální vizuál, můžete jej později změnit (rebranding), až přijde čas pro intenzivnější video prezentace.

## Jakou strategii zvolit pro první uvedení (launch) mého AI experta na trh? Samostatně, nebo jako bonus?

Pro první uvedení (launch) vašeho AI experta na trh se obecně **doporučuje strategie jeho uvedení jako samostatného, hlavního produktu.**

**Důvody pro tuto strategii:**

1. **Budování vysoké vnímané hodnoty:**
   - Když AI experta představíte jako hlavní nabídku, máte příležitost detailně vysvětlit jeho unikátní hodnotu, přínosy a to, jak řeší klíčové problémy vaší cílové skupiny.
   - Můžete vytvořit cenové kotvy srovnáním s cenou vašich osobních konzultací, rozsáhlých kurzů nebo mentoringu. Tím zdůrazníte, že AI expert nabízí srovnatelnou hodnotu (nebo její významnou část) za dostupnější cenu.
   - Pavel Říha s tímto přístupem dosáhl výrazného úspěchu při launchi Online Stratéga AI, který byl prezentován jako hlavní nabídka a generoval významné příjmy.
2. **Využití trendu AI:**
   - AI je aktuálně velkým trendem. Prezentace vaší AI instance jako inovativního, prémiového řešení může přitáhnout velkou pozornost.
3. **Jasná komunikace:**
   - Zaměření na jeden hlavní produkt usnadňuje marketingovou komunikaci a pomáhá potenciálním klientům lépe pochopit, co kupují.
4. **Vyhnutí se devalvaci:**
   - Pokud byste AI od začátku nabízeli pouze jako vedlejší bonus k jinému produktu, hrozí, že její hodnota nebude v očích klientů dostatečně vnímána. Bude těžší ji později prodávat jako samostatný prémiový produkt.

**Jak na to při prvním launchi:**

- **Prodejní webinář:** Je to velmi efektivní formát pro představení takto inovativního produktu. Na webináři můžete ukázat praktické využití, vysvětlit hodnotu a odpovědět na dotazy.
- **Zahajovací nabídka:** Zvažte nabídku na delší období (např. půlroční nebo roční tarif), abyste získali první platící zákazníky a potvrdili tržní hodnotu produktu. Můžete využít i strategii první delší (a cenově výhodnější) periody s automatickým přechodem na kratší (např. měsíční) platby.
- **Případová studie:** Inspirujte se případovou studií launch kampaně "Online stratég Swipe Files", která je k dispozici v Telegram skupině BuddyPro Owners.

**Kdy zvážit AI jako bonus (později nebo ve specifickém kontextu):**

- Strategie nabízet AI jako **hlavní bonus** k jinému prémiovému produktu (např. online kurzu) může být také velmi efektivní, *zejména pokud tento hlavní produkt učí klienty, jak AI experta efektivně využívat* (jak tomu bylo u Pavla Říhy s kurzem Expertní Éra a FutureBotem).
- Po úspěšném úvodním launchi, kdy je hodnota vaší AI již na trhu etablována, můžete samozřejmě AI experta využívat i jako hodnotný bonus k dalším produktům, v rámci upsellů nebo v tzv. "neviditelných funnelech" pro kontinuální přivádění nových uživatelů.

**Závěr:** Pro **první uvedení na trh** je strategie **samostatného produktu** obecně doporučovanější pro vybudování silné vnímané hodnoty, která vám pak usnadní i všechny další prodejní aktivity a strategie, včetně pozdějšího nabízení jako bonusu.

## Jakou strategii zvolit, pokud chci svou AI instanci prodávat jako hlavní produkt? Na co se zaměřit v zahajovací nabídce?

Pokud se rozhodnete prodávat svou AI instanci jako **hlavní nabídku (samostatný produkt)**, zde je několik doporučení:

1. **Webinář jako klíčový prodejní nástroj:** Webinář je stále jedním z nejefektivnějších způsobů, jak představit inovativní produkt jako je AI expert, vysvětlit jeho hodnotu a vytvořit zájem. Detailní případovou studii úspěšného launche ("Online stratég Swipe Files") najdete v telegramové skupině BuddyPro Owners.
2. **Zahajovací nabídka – delší tarify:** Při prvním uvedení na trh zvažte nabídku delších tarifů (např. roční, půlroční, čtvrtletní) namísto okamžitého nabízení měsíčního tarifu nebo trialu. Tím získáte první platící zákazníky s vyšší počáteční investicí.
3. **Optický trik s cenou a délkou tarifu:**
   - **Příklad:** Místo ročního tarifu za 24 000 Kč (2 000 Kč/měsíc) můžete později nabídnout půlroční tarif za 18 000 Kč (3 000 Kč/měsíc). Pro mnoho lidí bude 18 000 Kč opticky přijatelnější než 24 000 Kč, i když měsíční cena je vyšší.
   - **Flexibilita FAPI:** Integrace s FAPI umožňuje nastavit první období předplatného s jinou délkou a cenou než následující období (např. první půlrok za zvýhodněnou cenu, poté automatický přechod na měsíční platby).
4. **Zaměření na revoluční hodnotu:** Komunikujte AI experta jako revoluční nástroj pro váš trh, který řeší klíčové problémy vaší cílové skupiny inovativním způsobem.
5. **Budování vnímané hodnoty:** Od začátku komunikujte vysokou hodnotu produktu. Porovnávejte jeho přínos s cenou vašich kurzů, konzultací, mentoringu. Vysvětlete, že AI obsahuje esenci vašeho know-how.

Klíčem je vytvořit silný první dojem a ukázat, že vaše AI instance je prémiový a hodnotný produkt.

## Jak efektivně využít svou AI instanci jako hlavní bonus k jinému expertnímu produktu (např. kurzu)?

Nabízení vaší AI instance jako **hlavního bonusu** k vašemu stávajícímu prémiovému produktu (např. online kurzu, skupinovému koučinku) je velmi efektivní strategie.

**Klíčové principy:**

1. **AI jako diferenciační prvek:** Ve světě přesyceném online kurzy může AI expert sloužit jako inovativní "třešnička na dortu", která váš produkt odliší.
2. **Obsah webináře/prezentace:** Již v obsahové části prodejní prezentace mluvte o AI, ukažte její praktické využití a vytvořte touhu ji vyzkoušet.
3. **AI jako *hlavní* bonus:** Prezentujte AI jako klíčový bonus, ne jen jeden z mnoha. Zdůrazněte jeho unikátní hodnotu pro dosažení výsledků.
4. **Propojení s obsahem kurzu:** Vysvětlete, jak AI pomůže klientům lépe aplikovat znalosti z kurzu na jejich konkrétní situace.
5. **Naučte klienty AI používat:** Ideální je, pokud váš hlavní produkt (kurz) zároveň učí klienty, jak efektivně využívat AI, kterou dostávají jako bonus. To zvyšuje její vnímanou hodnotu a pravděpodobnost, že si po vyčerpání bonusových zpráv zakoupí placený tarif.
   - **Příklad:** Kurz "Expertní éra" s FutureBotem jako bonusem – kurz učil, jak AI využívat, a FutureBot byl nástrojem. Míra prodloužení placeného tarifu po skončení bonusu byla vysoká.
6. **Střídmější limity zpráv:** Jelikož AI není jediným produktem v nabídce, můžete jako bonus nabídnout menší počet zpráv (např. 1500-3000 zpráv celkem v rámci trialu) než u samostatně prodávané AI. Po jejich vyčerpání systém nabídne přechod na placené předplatné.

Tento model může výrazně zvýšit atraktivitu vašich stávajících produktů a zároveň generovat nové předplatitele pro vaši AI instanci.

## Jak můžu svého Buddyho nabízet lidem průběžně, aniž bych musel/a dělat velké kampaně? Třeba když si koupí můj levnější produkt nebo se přihlásí k newsletteru?

Tato strategie se nazývá "opakovaný, neviditelný funnel" a jde o kontinuální, nenápadné přivádění uživatelů k vaší AI instanci z veškerého vašeho obsahu a aktivit.

**Jak funguje:**

1. **Vytvořte jednoduchou URL adresu pro trial:** Nastavte pozvánkový odkaz (např. přes `/generateBuddyProInvite`) na zkušební verzi vaší AI instance s určitým počtem zpráv zdarma (např. 50-100).
2. **Odkazujte z veškerého obsahu:**
   - **Bezplatný obsah:** V YouTube videích, článcích na blogu, příspěvcích na sociálních sítích můžete na konci relevantního tématu odkázat na vaši AI s výzvou typu: "Chcete si toto téma probrat individuálněji? Promluvte si s mým AI expertem, máte prvních X zpráv zdarma zde: [vaše URL]." Můžete i ukázat, jak s AI dané téma řešíte.
   - **Placený obsah:** Ke každému vašemu produktu (kurz, e-book, členství) přidejte jako bonus přístup k trial verzi vaší AI. Udržujte tak povědomí o její existenci a naučte klienty ji používat.
3. **Děkovací stránky:** Na děkovacích stránkách po zakoupení produktu nebo registraci k lead magnetu nabídněte trial AI jako dárek: "Děkuji! Jako bonus vám dávám přístup k mému AI expertovi, který vám pomůže s [téma]..."
4. **Upsell:** Po prodeji jednoho produktu nabídněte jako upsell přístup k vaší AI na určité období (např. 3 měsíce), která zná obsah zakoupeného kurzu a pomůže s jeho aplikací.
5. **Automatizovaný přechod na placený tarif:** Po vyčerpání trial zpráv systém uživatele automaticky informuje a odkáže na stránku, kde si může zakoupit placené předplatné vaší AI.

**Důležité:** Aby tento funnel fungoval co nejlépe, je vhodné nejprve vybudovat vnímanou hodnotu vaší AI instance (např. úvodním launchem). Když vaše komunita vnímá AI jako hodnotný nástroj, budou trialy a následné konverze efektivnější.

## Proč je důležité vzdělávat mé klienty o AI a jak k tomu přistoupit v marketingu mé BuddyPro instance?

Vzdělávání klientů o AI a jejím využití ve vašem specifickém oboru je **zásadní pro úspěch vaší BuddyPro instance**. Mnoho vašich klientů může mít jen omezené nebo žádné zkušenosti s praktickým využitím AI nad rámec obecných nástrojů jako ChatGPT pro jednoduché dotazy.

**Proč vzdělávat:**

- **Klienti nevidí všechny možnosti:** Vy jako expert vidíte, jak AI může pomoci s cíli vašich klientů, ale oni sami nemusí tento potenciál rozpoznat.
- **Role lídra:** Vaším úkolem je ukázat jim nové cesty k výsledkům pomocí AI.
- **Hodnota produktu:** Klienti pochopí hodnotu vaší AI instance, až když uvidí, jak konkrétně jim může pomoci.
- **Součást vaší expertízy:** Schopnost využít a učit AI ve vašem oboru se stává novou součástí vaší expertízy.

**Jak k tomu přistoupit:**

- **Nestačí jen představit produkt:** Aktivně ukazujte konkrétní způsoby využití vaší AI instance.
- **Infomarketingový přístup:** Nejprve vysvětlete hodnotu a možnosti, teprve pak nabídněte produkt.
- **Praktické ukázky:** Vytvářejte obsah (videa, články, webináře), kde demonstrujete, jak s vaší AI řešit typické problémy klientů.
- **Onboarding:** V rámci onboardingu nových uživatelů jim poskytněte návody a inspiraci, jak AI co nejlépe využít.

Nepředpokládejte, že klienti budou automaticky vědět, k čemu jim vaše AI může být. Aktivní edukace je klíčem k jejich zapojení a vnímání hodnoty.

## Jaké jsou konkrétní nápady a strategie pro využití mé AI instance jako "AI Influencera" v marketingu?

Koncept "AI Influencera" spočívá ve vytvoření a prezentaci vaší AI instance jako samostatné osobnosti či entity, která aktivně působí v marketingu a přitahuje uživatele.

**Nápady a strategie:**

1. **Vytvořte AI osobnost a vizuál:** Dejte své AI jméno (pokud ještě nemá), definujte její styl komunikace a vytvořte jí vizuální podobu (avatar), kterou lze použít pro multimediální obsah.
2. **Sociální sítě pro AI:** Vytvořte pro vaši AI vlastní profily na relevantních sociálních sítích (Facebook, Instagram, TikTok, LinkedIn, YouTube).
3. **Obsah tvořený (s pomocí) AI:**
   - **Textový obsah:** AI může (s vaší nebo týmovou supervizí) psát příspěvky na sociální sítě, články na blog, nebo dokonce části e-booků.
   - **Video obsah:** Váš AI avatar může "moderovat" videa na YouTube nebo TikTok, prezentovat tipy a know-how. Hlas může být generovaný AI (váš klonovaný hlas nebo jiný).
   - **Audio obsah:** AI může mít vlastní podcast nebo audio newsletter.
4. **Aktivní zapojení v komunitách:**
   - **Facebook skupiny/fóra:** Vytvořte profil pro vaši AI a nechte ji (prostřednictvím člena vašeho týmu, který kopíruje odpovědi z vaší BuddyPro instance) odpovídat na dotazy členů komunity. Na konci odpovědi může být odkaz na trial verzi pro individuální konzultaci.
5. **Výzva k interakci:** Veškerý obsah AI Influencera by měl obsahovat výzvu k akci – typicky pozvánku k osobní konverzaci s AI v Telegramu (trial verze).
6. **Méně závislosti na vás:** AI Influencer může postupně převzít část marketingové komunikace, čímž se váš byznys stane méně závislým na vaší osobní tváři a čase. To může být výhodné i pro případný budoucí prodej firmy.
7. **Delegace:** Tvorbu obsahu jménem AI Influencera je často snazší delegovat na tým než tvorbu obsahu přímo pod vaší osobní značkou.

Tato cesta vyžaduje určitou míru lidské asistence (alespoň zpočátku), ale potenciál pro budování značky a škálování marketingu je značný. Platforma BuddyPro bude směřovat k větší automatizaci těchto procesů.

## Jakou strukturu a obsah by měl mít prodejní webinář pro AI experta?

Zaměřte se na **klíčové uvědomění** (problém, který AI řeší). Tématem webináře by měl být **výsledek** pro klienta. Představte AI jako řešení. **Srovnejte hodnotu** s online kurzy (obecné) a osobními konzultacemi (drahé). To vytváří cenovou kotvu a představuje AI experta, jako cenově dostupné a velmi efektivní řešení.

## Jak efektivně komunikovat přínosy mého specializovaného AI experta oproti obecným nástrojům jako ChatGPT?

Efektivní komunikace přínosů vašeho specializovaného AI experta oproti obecným nástrojům jako ChatGPT je zásadní pro jeho úspěch. Lidé ChatGPT znají, často ho používají zdarma, a proto musíte jasně ukázat, proč by měli investovat do vašeho řešení.

**1. Hloubka, relevance a unikátnost know-how:**

- **ChatGPT:** Má přístup k obrovskému množství obecných informací z internetu. Je to "všeobecný znalec", ale jeho znalosti jsou široké a často povrchní pro specifické oblasti. Nemá vaše unikátní know-how, vaše metody, váš jazyk, vaše příběhy a případové studie.
- **Váš AI Expert:**
  - **Co komunikovat:** Je natrénován **přesně na vašem obsahu**: vašich kurzech, knihách, webinářích, článcích, interních materiálech, osvědčených postupech. Toto know-how je **vytvořeno vámi** – obsahuje jen to, co považujete za relevantní a kvalitní.
  - **Přínos pro klienta:** Dostává rady, které jsou **vysoce relevantní** pro jeho problém v kontextu vaší expertízy. Nemusí filtrovat šum obecných informací. AI používá vaši terminologii, rozumí nuancím vašeho oboru a může odkazovat na konkrétní moduly vašich kurzů nebo techniky, které učíte. Je to, jako by měl přístup k vaší kompletní digitální knihovně, ale s průvodcem, který mu najde přesně to, co potřebuje.
  - **Jak to říct:**
    - "Na rozdíl od obecných AI, které čerpají z celého internetu, můj AI expert je vyškolen výhradně na [X] letech mých zkušeností, [Y] úspěšně odvedených projektech a obsahu mých [Z] placených programů. Získáte tak esenci toho nejlepšího z mé praxe."
    - "Představte si, že máte k dispozici veškeré mé know-how připravené k okamžitému použití pro vaši konkrétní situaci – bez nutnosti procházet hodiny videí nebo stovky stran textu."

**2. Definovaná osobnost, styl komunikace a hodnoty:**

- **ChatGPT:** Může napodobit různé styly, ale ve výchozím stavu je spíše neutrální, "robotický". Nemá konzistentní osobnost ani vaše specifické hodnoty.
- **Váš AI Expert:**
  - **Co komunikovat:** Vy jste definovali jeho osobnost, tón hlasu, hodnoty a etický rámec v `system promptu`. Může být empatický, energický, analytický, vtipný – přesně tak, jak si přejete a jak to odpovídá vaší značce.
  - **Přínos pro klienta:** Interakce je příjemnější, autentičtější a vytváří větší důvěru. Klient má pocit, že komunikuje s někým, kdo mu rozumí nejen informačně, ale i lidsky. Je to jako mít parťáka, který sdílí vaše hodnoty.
  - **Jak to říct:**
    - "Můj AI průvodce s vámi nemluví jako stroj. Nastavil jsem ho tak, aby komunikoval [empaticky/s nadhledem/přímo k věci – doplňte váš styl], přesně jako byste mluvili se mnou nebo s mým ideálním zástupcem."
    - "Nejde jen o informace, ale i o způsob, jakým jsou podány. Můj AI je naprogramován na [hodnota 1, hodnota 2], což se odráží v každé jeho radě."

**3. Dlouhodobá paměť, personalizace a kontext v rámci instance:**

- **Váš AI Expert (BuddyPro):**
  - **Co komunikovat:** Díky funkci "Profil uživatele" a "Dlouhodobá paměť" si instance BuddyPro postupně buduje obrázek o klientovi, jeho cílech, preferencích, minulých výzvách a úspěších.
  - **Přínos pro klienta:** Nemusí AI pokaždé vysvětlovat vše od začátku. AI může navazovat na předchozí konverzace, přizpůsobit rady jeho specifické situaci a historii. Tím se stává skutečným osobním průvodcem, který se s klientem "vyvíjí".
  - **Jak to říct:**
    - "Váš AI expert si vás pamatuje. S každou další konverzací lépe rozumí vašim potřebám a cílům, takže jeho podpora je stále personalizovanější a efektivnější."
    - "Už žádné opakování se. Můj AI si vede záznamy o vašem pokroku (samozřejmě diskrétně a bezpečně) a pomáhá vám stavět na tom, čeho jste již dosáhli."

**4. Specializace, úzké zaměření a efektivita:**

- **ChatGPT:** Je jako švýcarský nůž – umí od všeho trochu, ale na specializované úkoly není ideální. Může vyžadovat složité a přesné "promptování", aby uživatel dostal požadovaný výsledek.
- **Váš AI Expert:**
  - **Co komunikovat:** Je navržen a optimalizován pro konkrétní účel nebo sadu problémů. Systém rolí v BuddyPro zajišťuje, že AI automaticky zvolí nejvhodnější "expertní mód".
  - **Přínos pro klienta:** Dostává rychleji a efektivněji relevantní a prakticky použitelné rady. Uživatel nemusí být expert na "prompt engineering". AI ho vede a často sama navrhuje další kroky nebo témata.
  - **Jak to říct:**
    - "Nemusíte se stát expertem na zadávání příkazů AI. Můj AI průvodce je navržen tak, aby vás intuitivně vedl k řešení vašeho problému v oblasti [váš obor]."
    - "Místo abyste trávili hodiny hledáním a filtrováním obecných rad, které stejně musíte přizpůsobit, můj AI expert vám poskytne cílenou podporu šitou na míru výzvám, jako je ta vaše."
    - **Analogie:** "Představte si rozdíl: ChatGPT je jako obrovská veřejná knihovna, kde si musíte sami najít tu správnou knihu a v ní tu správnou kapitolu. Můj AI expert je jako váš osobní knihovník-specialista, který zná vaše potřeby a rovnou vám podá přesně tu informaci, kterou hledáte, i s vysvětlením, jak ji použít."

**5. Uživatelská zkušenost – vedení a onboarding:**

- **ChatGPT:** Poskytuje platformu, ale nevede uživatele specificky k řešení jeho problému v dané oblasti.
- **Váš AI Expert:**
  - **Co komunikovat:** Můžete navrhnout propracovaný onboarding proces, úvodní zprávy, které uživatele nasměrují, nabídnout mu předdefinované cesty nebo témata k prozkoumání.
  - **Přínos pro klienta:** Získává nejen nástroj, ale i "návod k použití" a inspiraci, jak z něj vytěžit maximum pro své potřeby. Cítí se lépe veden a podporován.
  - **Jak to říct:**
    - "Od první interakce vás můj AI expert povede tak, abyste co nejrychleji dosáhli prvních výsledků a pochopili jeho potenciál pro vaši situaci."
    - "Připravil jsem pro vás úvodní tipy a témata, abyste nemuseli přemýšlet, kde začít. Stačí si vybrat a pustit se do toho."

**6. Schopnost interaktivní práce s dodanými podklady:**

- **Co komunikovat:** Na rozdíl od mnoha obecných AI nástrojů může váš AI expert pracovat přímo se soubory a odkazy, které mu klient pošle v konverzaci. Může zrevidovat dokument, analyzovat data z tabulky, okomentovat návrh z obrázku nebo shrnout obsah webové stránky.
- **Přínos pro klienta:** Klient nezískává jen obecné rady, ale konkrétní zpětnou vazbu na svou vlastní práci a materiály. Interakce je tak mnohem praktičtější a zaměřená na konkrétní výstupy.
- **Jak to říct:**
  - "Nemusíte mi nic složitě popisovat. Jednoduše pošlete mému AI expertovi svůj dokument, odkaz na web nebo obrázek a on vám poskytne okamžitou zpětnou vazbu."
  - "Proměňte teoretické rady v praxi. Nechte si od AI zkontrolovat váš prodejní text, zanalyzovat report nebo navrhnout vylepšení vaší prezentace."

**Souhrnné tipy pro komunikaci:**

- **Používejte analogie:** Pomáhají lidem lépe pochopit abstraktní koncepty.
- **Zaměřte se na benefity, ne jen na vlastnosti:** Místo "má dlouhodobou paměť" řekněte "pamatuje si vás, takže nemusíte nic opakovat a rady jsou osobnější".
- **Ukažte, ne jen říkejte:** Připravte demo, krátká videa s ukázkami, jak AI řeší konkrétní problémy lépe/rychleji než obecný nástroj.
- **Využijte reference:** Pokud máte první uživatele, jejich pozitivní zkušenosti jsou nejlepším argumentem.
- **Vzdělávejte trh:** Webináře, články, příspěvky na sociálních sítích, kde vysvětlujete rozdíly a výhody specializované AI. Buďte připraveni na otázku "Proč bych neměl/a použít ChatGPT zdarma?" a mějte jasnou, sebevědomou odpověď.
- **Zdůrazněte jedinečnost "vás" v AI:** "Je to nejblíže tomu, mít mě jako osobního konzultanta 24/7, za zlomek ceny."

Tím, že budete konzistentně a jasně komunikovat tyto rozdíly, pomůžete potenciálním klientům pochopit unikátní hodnotu vašeho specializovaného AI experta a ospravedlnit investici do něj.

## Po úspěšném launchi, jak dál pracovat s AI expertem v rámci mého produktového portfolia?

Trial verze AI experta můžete nabízet jako **hodnotný doplněk k vašim dalším produktům** (kurzům, členstvím). Klienti si tak AI vyzkouší, naučí se ji používat, a po vyčerpání trialu je vyšší šance na konverzi na placenou verzi. Může to být také způsob, jak převést jednorázové klienty na opakované platby.

## Co je koncept "AI Influencer" a jak ho mohu využít?

Jde o myšlenku "vdechnout život" vaší AI instanci. Mohla by mít vlastní sociální profily, tvořit obsah (texty, videa s AI animací a vaším hlasem) na základě vašeho know-how a lákat lidi do trial verze s výzvou "pojďme si o tom popovídat osobně". Zatím vyžaduje lidskou asistenci, do budoucna se zvažuje větší automatizace.

## Jakou prodejní strategii zvolit pro AI experta v oboru, kde klienti typicky řeší problém jen krátkodobě a pak už službu nepotřebují (např. založení provozovny)?

Pokud očekáváte, že klienti nebudou mít potřebu dlouhodobého měsíčního předplatného:

- **Nenabízejte měsíční tarif:** Místo toho se zaměřte na tarify s delším časovým závazkem, ale s jednorázovou platbou za celé období.
- **Ideální délka:** Zvažte 90denní nebo půlroční přístup. Lidé jsou u těchto délek méně citliví na přepočtenou měsíční cenu. Často vnímají cenu za 6 měsíců podobně jako za 12 měsíců, i když měsíční sazba může být u 6měsíčního tarifu vyšší.
- **Příklad cenotvorby:** Můžete nabídnout půlroční přístup za cenu, která je opticky nižší než by byla roční (např. 18 000 Kč za půlrok vs. 24 000 Kč původně za rok), i když efektivní měsíční cena je ve skutečnosti vyšší.
- **Výhoda:** Získáte vyšší jednorázovou platbu a klient má dostatek času na vyřešení svého problému. Tento model eliminuje obavy z nízké retence u měsíčních plateb.

---

# Dostupnost

## Pro které platformy je BuddyPro?

V současnosti je BuddyPro dostupný výhradně přes [Telegram](https://telegram.org/), což má několik výhod:

**Současná dostupnost**:

- Telegram je multiplatformní aplikace dostupná na všech zařízeních (PC, mobil)
- Funguje na všech operačních systémech (Windows, Mac, iOS, Android)
- Komunikace je jednoduchá, intuitivní a zabezpečená
- Není potřeba vytvářet nové účty nebo učit se nové rozhraní

**Plány pro budoucnost** zahrnují vizi:

1. **Všudypřítomný AI parťák** integrovaný do:
   - Webů
   - Členských sekcí a kurzových platforem
   - Online komunit
   - Různých komunikačních kanálů
2. **Živá komunikace**:
   - Možnost spojení přes Zoom
   - Telefonní hovory
   - Video konference
3. **AI agenti**:
   - Schopnost vykonávat úkoly na internetu
   - Automatické akce podle požadavků uživatele

Cílem je, aby váš BuddyPro byl “připravený všude, všude, kde ho budou potřebovat” vaši klienti - dostupný v přirozeném prostředí, kde jsou zvyklí komunikovat.

## Jaké AI modely BuddyPro používá?

BuddyPro nabízí různé AI modely, které se liší poměrem výkonu a ceny:

Volba modelu závisí na vašich prioritách - zda preferujete nejvyšší kvalitu nebo nižší náklady. Pro mnoho aplikací může být model Economy ideálním kompromisem mezi výkonem a cenou.

**Hlavní modely a jejich charakteristiky**:

- **Model Smart**: nejvýkonnější, ~0.08 USD za zprávu
- **Model Economy**: dobrý poměr výkon/cena, ~0.05 USD za zprávu
- **Model Nano**: cenově nejdostupnější, ~0.03 USD za zprávu (zatím není k dispozic

**Technologie na pozadí**:
BuddyPro není závislý na jednom konkrétním AI modelu, ale využívá kombinaci všech velkých hráčů na trhu:

- OpenAI (GPT modely)
- Anthropic (Claude modely)
- Google (Gemini modely)
- Další specializované modely

AI velkých hráčů na trhu šikovně kombinujeme a využíváme každý model k tomu, k čemu je v danou chvíli nejlepší. Z toho vzniká finální výstup BuddyPro.

---

# Bezpečnost

## Jak BuddyPro chrání data a GDPR?

BuddyPro byl navržen s důrazem na soukromí a bezpečnost uživatelských dat:

**Klíčové bezpečnostní prvky**:

- Konverzace jsou šifrované
- Nikdo nemá přístup k obsahu konverzací (ani tým BuddyPro, ani majitel instance)
- Data nejsou spojena s konkrétním člověkem v rámci technických možností
- Jsou využívány pouze AI modely, které garantují, že se na datech neučí

**GDPR compliance**:

- Existuje možnost úplného smazání uživatele a jeho dat
- Implementované postupy pro ochranu osobních údajů

**Sdílený profil uživatele**:

- Šifrovaný profil uživatele je sdílený mezi instancemi BuddyPro
- To ale neznamená, že by kdokoliv měl přístup k tomuto profilu
- Ani my ani majitelé instancí BuddyPro nemohou tento profil vidět

## Mohu jako majitel BuddyPro vidět, o čem si moji klienti s AI povídají?

Ne, jako majitel BuddyPro nemáte přístup k konverzacím svých klientů. Toto je záměrný bezpečnostní prvek platformy.

**Proč je to takto nastaveno**:

1. Ochrana soukromí koncových uživatelů
2. Budování důvěry - uživatelé vědí, že jejich konverzace jsou skutečně soukromé
3. Soulad s GDPR a dalšími předpisy na ochranu osobních údajů

**Co když potřebujete vědět, co váš klient s vaším BuddyPro řešil**:

- V budoucnu by mohly být k dispozici anonymizované statistiky
- Můžete požádat klienta, aby vám sdělil, o čem se s BuddyPro bavil
- Můžete instruovat klienta, aby požádal BuddyPro o shrnutí jejich konverzací, které vám pak může přeposlat

## Jak je ošetřeno nahrávání obsahu do BuddyPro z hlediska autorských práv?

Nahrávání obsahu do BuddyPro podléhá pravidlům týkajícím se autorských práv:

**Základní pravidla**:

- Majitel BuddyPro by měl nahrávat pouze obsah, ke kterému má autorská práva nebo souhlas autora
- Nahrávání copyrightovaného obsahu bez souhlasu držitele autorských práv je v rozporu s podmínkami služby
- Použití cizího obsahu jako vlastního know-how je eticky problematické

**Alternativní přístupy**:

- Pokud potřebujete doplnit know-how v oblasti, kterou nemáte pokrytou, můžete použít ChatGPT pro vytvoření hloubkového průzkumu na dané téma
- Pro vytváření obsahu v oblastech, které nejsou pokryty vaším know-how, můžete využít různé otevřené zdroje s odpovídajícím typem licence

---

# Testování, správa

## Jak mohu testovat a ladit svého BuddyPro před spuštěním pro klienty?

Pro důkladné testování a ladění BuddyPro před spuštěním:

**1. Použití testovacího režimu**:

- Příkazem `/test:ID` přepněte do role testovacího uživatele
- Např. `/test:test_account1`
- Tímto se stanete “novým uživatelem” s čistou historií konverzace
- Pro návrat k vlastnickému účtu použijte `/untest`

**2. Testování různých scénářů**:

- Vyzkoušejte typické otázky, které budou klienti klást
- Testujte hraniční případy a potenciálně problematické oblasti
- Sledujte, zda BuddyPro správně chápe kontext a udržuje konzistenci

**3. Ladění odpovědí**:

- Pomocí `/lastRole` zjistěte, která role byla použita pro odpověď
- Upravte systémový prompt nebo konkrétní roli podle potřeby
- Použijte `/update` nebo `/updateRole:název_role` pro aktualizaci změn
- Pomocí příkazů `/del`, `/del2` nebo `/del10` smažte poslední zprávy a vyzkoušejte znovu

**4. Zapojení dalších testerů**:

- Generujte testovací pozvánky pro kolegy nebo blízké přátele
- Sbírejte zpětnou vazbu z různých perspektiv
- Identifikujte problémy, které sami nemusíte zpozorovat

Pro testování a ladění můžete generovat pozvánkový odkaz příkazem `/generateBuddyProInvite`.

## Jak mohu otestovat celý proces prodeje a aktivace tarifů/balíčků přes Stripe/FAPI (včetně dokupování zpráv), aniž bych musel/a zapojovat reálné externí testery?

Pro otestování celého prodejního cyklu můžete využít svůj **testovací účet** ve vaší BuddyPro instanci (aktivovaný příkazem `/test:{ID_testovaciho_uctu}`). Na tomto testovacím účtu můžete:

1. Provést zkušební nákup vámi vytvořeného tarifu (subscription) nebo balíčku zpráv (package) přes váš prodejní formulář. Doporučuje se pro testovací účely vytvořit produkt s velmi nízkou cenou (např. 10 Kč).
2. Ověřit, že po úspěšné "platbě" se tarif nebo balíček správně aktivuje pro váš testovací účet (AI by měla přestat hlásit konec trialu, případně se navýší počet zpráv).
3. Otestovat i případné dokupování zpráv nebo upgrade tarifu.
4. Následně můžete pro testovací účet zrušit předplatné (pokud jste testovali subscription) pomocí příkazu `/disableUser:{subscriptionId_testovaciho_uctu}` (Subscription ID získáte ze Stripe/FAPI) a zrušením opakované platby v platebním systému. Tímto způsobem si můžete ověřit funkčnost celého prodejního flow, aniž byste potřebovali reálné platby od externích osob.

## Jaké příkazy mohu použít pro správu a nastavení BuddyPro?

BuddyPro nabízí rozsáhlou sadu příkazů pro správu a nastavení. Zde jsou ty nejdůležitější:

**Základní příkazy**:

- `/help` - zobrazí kompletní seznam příkazů
- `/setup` - průvodce základním nastavením
- `/update` - zpracuje nové soubory a aktualizuje systémový prompt
- `/updateRoles` - generuje/aktualizuje role

**Nastavení parametrů**:

- `/setVoice:{voice}` - nastaví hlas pro audio odpovědi
- `/setDefaultSubscriptionUrl:{url}` - URL pro nákup předplatného
- `/setUpgradeSubscriptionUrl:{url}` - URL pro upgrade nebo dokoupení zpráv
- `/setSupportEmail:{email}` - kontaktní email pro podporu
- `/setTrialEndedMessage:{message}` - zpráva po vyčerpání trialu
- `/setInviteTrialMessages:{count}` - počet zpráv v trialu pro nové uživatele
- `/setDefaultCost:{defaultCost}:{defaultCostCurrency}:{defaultCostPeriod}:{defaultCostPeriodCount}:{discountedCost}` - informace o ceně
- `/shouldInitiateMessages:true/false` - nastavení automatických zpráv

**Správa uživatelů**:

- `/generateBuddyProInvite:{trialMessages}:{code}:{usersLimit}` - vytvoření pozvánky
- `/checkInvite:{code}` - statistiky využití pozvánky
- `/getInfoAboutUser:{subscriptionId}` - informace o uživateli
- `/setTrialMessages:{userId}:{count}` - nastavení počtu trial zpráv
- `/addTrialMessages:{userId}:{count}` - přidání trial zpráv
- `/disableUser:{subscriptionId}` - deaktivace uživatele
- `/giveExtraMessages:{subscriptionId}:{extraMessages}` - přidání extra zpráv

- `/deleteInvite:{kodPozvánky}` - tento příkaz **okamžitě zneplatní danou pozvánku**, takže ji už **nelze využít** pro přístup do instance, ani pokud ji někdo má uloženou.

**Testování**:

- `/test:ID` a `/untest` - přepínání mezi testovacím a normálním režimem
- `/lastRole` - zjištění role použité pro poslední odpověď

**Stripe integrace**:

- `/setupStripe` - propojení se Stripe

**FAPI integrace (alternativa)**:

- `/setupFapi:{username}:{apikey}` - propojení s FAPI
- `/connectForm:{id}:{productId}:{type}:{messages}` - propojení formuláře

**Nastavení automatického psaní zpráv:**

**-**`/shouldInitiateMessages:true / false` – globální nastavení, zda může BuddyPro **sám iniciovat zprávy** všem uživatelům v instanci (např. onboarding, follow-upy).

_Nastavuje majitel instance, platí pro všechny uživatele._

**-**`/shouldMessageMe:true / false` – individuální nastavení uživatele, zda chce, aby mu BuddyPro **aktivně psal**.

_Funguje pouze pokud je globální iniciování zpráv povoleno._

Pro zobrazení všech dostupných příkazů použijte `/help` přímo ve vaší BuddyPro instanci.

Další:

- `/listUnassignedSubscriptions` který umožňuje vypsat předplatné které si uživatelé zatím neaktivovali
- `/messageAllUsers` příkaz na rozeslání hromadných zpráv - může používat jen BuddyPro owner, na konkrétní parametry se zeptejte vašeho Buddyho a nebo použijte /help .. zprávy stojí kredity pokud použijete dynamické zprávy (“řekni uživateli že”), cca $0.16 za zprávu / uživatele

## Jak můžu změnit jazyk seznamu příkazů /help?

Pomocí příkazů `/setLanguage:cs` a `/setLanguage:en` můžete přepnout jazyk odpovědí na příkazy a systémových hlášek pro vás jako vlastníka.

## Jsem přidaný/á jako člen týmu k BuddyPro instanci (pomocí `/addUserToTeam`), ale instance mi hlásí, že mi skončil trial / vypršelo předplatné. Proč?

Přidání vašeho Telegram účtu do týmu BuddyPro instance pomocí příkazu `/addUserToTeam:{userId}` vám uděluje **administrátorská práva** k této instanci. To znamená, že můžete používat většinu příkazů pro nastavení a správu, stejně jako vlastník (owner).

Nicméně, toto oprávnění automaticky **neznamená neomezený počet zpráv** pro vaši osobní konverzaci s danou AI instancí. Z hlediska počtu zpráv jste stále považováni za uživatele na "trialu" (pokud jste si nezakoupili vlastní předplatné k této instanci).

Aby vám jako členu týmu nedošly zprávy, musí vám vlastník (owner) instance navýšit počet trial zpráv pomocí příkazu `/addTrialMessages:{vaše_userId}:{počet_zpráv}`. (Vaše Telegram User ID zjistíte zadáním `/myid` v chatu s jakýmkoliv BuddyPro botem). Alternativně, pokud vám byla udělena i tato pravomoc, můžete si zkusit počet zpráv navýšit sami.

## Lze změnit hlas AI?

Ano, hlas vaší BuddyPro instance můžete změnit pomocí příkazu: `/setVoice:{voice}`

Tento příkaz nastaví hlas vašeho BuddyPro pro všechny uživatele. Dostupné hlasy můžete najít [na stránce OpenAI zde](https://platform.openai.com/docs/guides/text-to-speech#voice-options)

Mezi dostupné hlasy patří různé mužské a ženské hlasy s různými charakteristikami, akcentem a stylem řeči. Výběr vhodného hlasu může významně přispět k osobnosti vašeho AI experta a pomoci vytvořit konzistentní identitu, která odpovídá zamýšlenému charakteru.

Hlas se používá pro audio odpovědi, které BuddyPro poskytuje, když uživatel pošle hlasovou zprávu nebo když BuddyPro z nějakého důvodu odpovídá hlasem místo textem.

## Když si klient koupil tarif, ale chce ho zrušit a objednat si nový, jak to udělat?

Vrátit peníze, zrušit předplatné ve Stripe/FAPI, a zavolat příkaz /disableUser s id jejího předplatného.

Pak si může koupit jiný.

Historii jejího profilu si AI bude pamatovat i po přechodu na nový tarif.

## Mohu ručně upravovat faktury nebo předplatná mých klientů přímo ve Stripe/FAPI (např. měnit cenu, periodu)?

**Důrazně se nedoporučuje** provádět manuální úpravy v již vystavených fakturách nebo v nastavení aktivních pravidelných plateb (předplatných) poté, co si klient vaši BuddyPro službu zakoupil a došlo k propojení.

Systém BuddyPro nemá přehled o takovýchto manuálních změnách provedených přímo v platebním systému. To znamená, že pokud například ručně změníte cenu nebo periodu fakturace, BuddyPro o tom nebude vědět a bude se stále řídit původními parametry, se kterými bylo předplatné propojeno. To může vést k nesrovnalostem, problémům s přístupem klienta nebo chybnému účtování zpráv.

Pokud potřebujete změnit podmínky předplatného pro klienta (např. převést ho na jiný tarif), je obecně bezpečnější postup nechat klienta zrušit stávající předplatné a zakoupit si nové s požadovanými parametry přes odpovídající prodejní formulář.

## Mohu jako owner zjistit, kolik zpráv zbývá konkrétnímu uživateli, který je na trial verzi (použil pozvánkový odkaz)?

V současné chvíli neexistuje přímý příkaz pro vlastníka (ownera) instance, kterým by mohl zjistit zbývající počet trial zpráv pro konkrétního individuálního uživatele.

Uživatel sám se může své instance zeptat konverzačně (např. "Kolik mi zbývá zpráv?" nebo "Mám ještě nějaké zprávy zdarma?") a AI by mu měla být schopna odpovědět.

Pro přehled o využití pozvánkových kódů jako celku slouží příkaz `/checkInvite:{code}`, který zobrazí agregované statistiky pro daný kód (kolik lidí jej využilo, kolik z nich přešlo na placený tarif, průměrná spotřeba zpráv na trialu atd.), ale ne informace o jednotlivých uživatelích.

## Mohu stávajícím uživatelům (na placeném tarifu nebo po trialu) přidat zprávy zdarma jako bonus? Jak se tyto zprávy chovají a mají platnost?

Ano, můžete svým uživatelům přidat zprávy zdarma. Postup se liší podle toho, v jakém stavu je účet uživatele:

- **Pro uživatele na trialu nebo po jeho vyčerpání (bez aktivního placeného tarifu):** Použijte příkaz `/addTrialMessages:{userId}:{count}`. `{userId}` je Telegram User ID daného uživatele (získá ho zadáním `/myid` v chatu s jakýmkoliv BuddyPro botem) a `{count}` je počet zpráv, které chcete přidat.
- **Pro uživatele s aktivním placeným předplatným (subscription):** Použijte příkaz `/giveExtraMessages:{subscriptionId}:{extraMessages}`. `{subscriptionId}` je ID jeho předplatného (např. číslo subscription ze Stripe nebo číslo periodické faktury z FAPI) a `{extraMessages}` je počet zpráv k přidání. Tyto přidané zprávy se chovají jako dokoupený balíček – nemají časovou expiraci a čerpají se až po vyčerpání případného měsíčního limitu z předplatného.

## Mohu sám deaktivovat nebo změnit parametry (počet zpráv/uživatelů) již vygenerovaného pozvánkového odkazu (`/generateBuddyProInvite`)?

V současné chvíli nemůžete jako vlastník instance sami deaktivovat nebo přímo měnit parametry (jako je počet trial zpráv nebo maximální počet uživatelů) u již jednou vygenerovaného pozvánkového odkazu.
Pokud jste omylem vytvořili pozvánkový odkaz s nesprávnými parametry (např. příliš vysoký počet zpráv zdarma nebo neomezený počet uživatelů, kde jste chtěli limit), doporučuje se:

1. **Tento odkaz dále nešířit.**
2. **Vygenerovat nový pozvánkový odkaz** se správnými parametry a unikátním kódem.
3. V případě, že potřebujete urgentně upravit parametry již existujícího a rozšířeného odkazu, kontaktujte podporu `support@buddy.fm` s vaší žádostí. Mohou mít možnost provést úpravu přímo v databázi. Do budoucna se zvažuje zavedení pokročilejší správy pozvánkových kódů přímo vlastníkem instance.

## Jak správně postupovat, pokud chci klientovi vrátit peníze za BuddyPro a zrušit mu přístup?

Pokud se rozhodnete klientovi vrátit peníze za jeho předplatné nebo balíček zpráv:

1. **Proveďte refundaci v platebním systému:** Nejprve proveďte vrácení peněz standardním postupem ve vašem platebním systému (Stripe nebo FAPI).
2. **Zrušte pravidelnou platbu (pokud jde o subscription):** Pokud se jednalo o opakované předplatné, zrušte také jeho budoucí pravidelné platby ve Stripe/FAPI, aby nedocházelo k dalším strháváním.
3. **Deaktivujte přístup v BuddyPro:** Následně je **nezbytné** manuálně deaktivovat přístup tohoto klienta i ve vaší BuddyPro instanci. To provedete pomocí příkazu `/disableUser:{subscriptionId}`. Jako `{subscriptionId}` zadejte identifikátor předplatného (ID subscription ve Stripe nebo číslo periodické faktury ve FAPI). Pokud byste neprovedli krok 3, klient by mohl vaši BuddyPro službu nadále neoprávněně využívat i po vrácení peněz.

## Kde najdu fakturu za doplnění AI kreditů?

Fakturu za doplnění kreditů obdržíte po stržení z vaší paltební karty automaticky na email ve zprávě s předmětem “Vaše potvrzení od [Buddy.fm](http://Buddy.fm)”. Faktura (invoice) je přiložena v PDF jako příloha. V případě otázek ohledně fakturace kontaktujte zákaznickou podporu na support@buddy.fm

## Můj BuddyPro AI expert byl původně založen někým jiným. Nyní ho mohu nastavovat, ale když chci změnit jeho název, obrázek nebo popis přes `@BotFather`, hlásí mi to, že žádného bota nevlastním. Co s tím?

To znamená, že samotný technický Telegram bot (který je "tělem" vaší AI instance) byl vytvořen pod jiným Telegram účtem, než je ten váš. I když máte administrátorská práva k BuddyPro instanci (můžete zadávat příkazy jako `/update`, `/setFolder` atd.), nemáte vlastnictví Telegram bota jako takového.

Abyste mohli upravovat jeho základní vlastnosti v Telegramu (jméno viditelné v chatu, profilový obrázek, popis bota) přes oficiálního správce botů `@BotFather`, musí vám osoba, která bota původně vytvořila, **převést vlastnictví tohoto Telegram bota** na váš Telegram účet.

Požádejte tedy původního tvůrce, aby v chatu s `@BotFather` našel daného bota, zvolil možnost "Transfer ownership" a zadal váš Telegram @username. Vy pak ve svém chatu s `@BotFather` budete muset převod potvrdit. Poté budete moci bota plně spravovat.

---

# Technické integrace

## Jak propojit instanci s FAPI?

Propojení BuddyPro s platebním systémem FAPI (alternativou Stripe) se provádí v těchto krocích:

**1. Příprava na straně FAPI**:

- Založte si účet na FAPI (fapi.cz)
- Vytvořte produkty (subscription a package)
- Ujistěte se, že u subscription je zatrženo “Vystavovat pravidelné faktury” a “Zapnout automatické strhávání karty”

**2. Propojení s BuddyPro**:

```
/setupFapi:{username}:{apikey}
```

- `username` najdete v sekci Můj účet > API klíče
- `apikey` vytvoříte nebo najdete ve stejné sekci

**3. Propojení formulářů**:

```
/connectForm:{id}:{productId}:{type}:{messages}
```

- `id` - ID formuláře (z URL adresy formuláře)
- `productId` - ID produktu (najdete v templates/items)
- `type` - “subscription” nebo “package”
- `messages` - počet zpráv měsíčně (subscription) nebo celkem (package)

**4. Nastavení děkovací stránky a emailu**:

- Upravte děkovací stránku přímo ve FAPI (nikoliv na vašem webu)
- Do sekce `{IF_PAID}` vložte text a aktivační odkaz, který vám BuddyPro sdělí
- Vytvořte speciální emailovou šablonu s aktivačním odkazem

**5. Ověření propojení**:

- Pomocí `/checkSetup` zkontrolujte, zda je vše správně nastaveno
- Pro testování můžete vytvořit formulář za nízkou cenu (např. 10 Kč)

**Důležité poznámky**:

- Pro každý produkt (tarif nebo balíček) potřebujete samostatný FAPI formulář
- Nedoporučuje se dělat ruční úpravy v automaticky vystavených fakturách
- Při vrácení peněz je nutné kromě zrušení předplatného ve FAPI také použít příkaz `/disableUser`

Detailní návod: [oficiální dokumentace](https://www.notion.so/19-Technick-integrace-s-platebn-m-syst-mem-FAPI-nebo-Stripe-Jak-p-ij-mat-platby-od-z-kazn-k-1fc10e1465e280a9ab21ea4ad365a6ff?pvs=21).

## Jak propojit instanci se Stripe?

**1. Napojte svůj Stripe účet na Buddy Pro:**

- Použíjte příkaz:
  ```bash
  /setupStripe
  ```
- Buddy vám napíše odkaz, na kterém můžete provést propojení, klikněte na něj a postupujte podle pokynů na webu Stripe.

**2. Buddy vám vygeneruje příklady produktů a prodejních formulářů**

- Produkty najdete zde: [https://dashboard.stripe.com/products](https://dashboard.stripe.com/products)
- Prodejní formuláře najdete zde: [https://dashboard.stripe.com/payment-links](https://dashboard.stripe.com/payment-links)

**3. Můžete produkty upravit nebo vytvořit vlastní**

- Produkty které chcete napojit na Buddy Pro musí vždy obsahovat tato metadata:
  ```
  case: buddy_pro
  messages: 200 (libovolné číslo)
  ```

**Důležité poznámky**:

- Pro každý produkt (tarif nebo balíček) potřebujete samostatný prodejní formulář
- Nedoporučuje se dělat ruční úpravy v automaticky vystavených fakturách
- Při vrácení peněz je nutné kromě zrušení předplatného ve Stripu také použít příkaz `/disableUser`

Detailní návod: [oficiální dokumentace](https://www.notion.so/19-Technical-integration-with-Stripe-payment-system-how-to-accept-payments-from-customers-22210e1465e280cda5d0ecb6b4970cd4?pvs=21).

## Mohu použít jiné platební systémy než FAPI nebo Stripe (např. Kartra, ThriveCart)?

**Aktuálně ne.** BuddyPro podporuje **pouze Stripe a FAPI**. Integrace s jinými specifickými platformami jako Kartra nebo ThriveCart **není v plánu**.

## Jak nastavit rozcestník s více tarify a přenášet userId/client_reference_id?

Pokud stránka s upgradem na vyšší tarif nebo stránka po skončení trialu nabízí výběr různých tarifů je důležité zachovat parametr `client_reference_id` v URL až k objednávkové stránce se Stripe formulářem (v případě integrace se Stripe). V případě integrace s FAPI se tento parametr jmenuje jinak - `userId`.

**1. Technický popis**:

- Když uživatel klikne na odkaz z BuddyPro, v URL se objeví parametr například `?client_reference_id=12345` pro případ integrace se Stripe nebo `?userId=12345` pro případ integrace s FAPI.
- Tento parametr musí být přenesen do URL podejních formulářů při kliknutí na tlačítka tarifů
- Toho dosáhnete jednoduchým kódem, který vložíte do svého webu - viz. dále

1. **Kód pro váš web a jeho vložení**

Vložte na svůj web tento kód/script (do hlavičky nebo kamkoliv do stránky jako HTML prvek):

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

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

1. **Testování funkčnosti**:

- Otevřete URL vašeho rozcestníku s přidaným parametrem (např. [`https://vašweb.cz/tarify?client_reference_id=12345`](https://vašweb.cz/tarify?client_reference_id=12345) nebo `https://vašweb.cz/tarify?userId=12345`)
- Klikněte na libovolné tlačítko tarifu
- Ověřte, že v nové URL adrese zůstal parametr `client_reference_id=12345`, respektive `userId=12345`

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

- Odkazovat přímo na Stripe/FAPI formuláře místo na rozcestník
- Vytvořit samostatné stránky pro každou pozvánku s předem nastavenými odkazy

Detailní návod: [oficiální dokumentace](https://www.notion.so/Propojen-BuddyPro-s-platebn-m-syst-mem-FAPI-1ce10e1465e2803e9f8dcae55e0d35c7?pvs=21).

## Je potřeba samostatný Stripe formulář pro každý tarif/balíček?

Stripe umožňuje vytvořit prodejní formulář, kde je na výběr z různých produktů. Toto můžete použít. Musí to ale být výběr “buď a nebo”, ne možnost koupit více Buddy Pro produktů najednou.

## Je potřeba samostatný FAPI formulář pro každý tarif/balíček?

Ano, pro každý produkt (ať už měsíční tarif nebo balíček zpráv) je potřeba vytvořit samostatný FAPI formulář. Toto je technické omezení vycházející z architektury propojení BuddyPro a FAPI.

**Důvody pro samostatné formuláře**:

1. Příkaz `/connectForm:{id}:{productId}:{type}:{messages}` umožňuje specifikovat pouze jeden produkt, typ a počet zpráv
2. BuddyPro potřebuje jasně rozlišit, jaký produkt uživatel kupuje a kolik zpráv má dostat
3. Každý formulář má vlastní děkovací stránku a emailové šablony

**Prakticky to znamená**:

- Pro každou cenovou variantu měsíčního předplatného potřebujete samostatný formulář
- Pro každý balíček extra zpráv potřebujete samostatný formulář
- Nemůžete v jednom formuláři nabídnout více tarifů na výběr

**Postup pro správné nastavení**:

1. Vytvořte ve FAPI produkt pro každý tarif
2. Vytvořte ve FAPI formulář pro každý produkt
3. Propojte každý formulář s BuddyPro pomocí příkazu `/connectForm`
4. Nastavte pro každý formulář správnou děkovací stránku a email

Při plánování obchodního modelu a uživatelské cesty je potřeba toto omezení brát v úvahu a buď vytvořit více samostatných formulářů, nebo použít rozcestník, který uživatele nasměruje na správný formulář.

## Potřebuji mít vlastní děkovací stránku na svém webu (kvůli FB pixelu a dalším informacím), nikoliv jen přesměrování na Telegram nebo standardní FAPI děkovačku. Jak to vyřešit s aktivačním odkazem?

Pokud používáte FAPI integraci, zajištění spolehlivého předání aktivačních údajů do BuddyPro a zároveň použití zcela vlastní děkovací stránky na vašem webu je technicky náročnější a vyžaduje práci programátora na vaší straně. Standardní a doporučený postup je: **Použít děkovací stránku *uvnitř FAPI***: FAPI umožňuje do určité míry upravit vzhled a obsah své děkovací stránky.

Pokud trváte na vlastní děkovací stránce na vašem webu, i přes složitější technické řešení, kontaktujte zákaznickou podporu.

## Budou moci BuddyPro platit klienti z Ruska nebo zemí bývalého Sovětského svazu, například kartou Mir?

Platební možnosti pro vaše klienty závisí primárně na platební bráně, kterou propojíte s BuddyPro (standardně FAPI nebo Stripe). Tyto mezinárodní platební brány obvykle **nepodporují** ruské platební systémy jako je karta Mir, a to zejména z důvodu mezinárodních sankcí a omezení.
Pro aktuální informace o podporovaných zemích a platebních metodách se prosím informujte přímo u vašeho poskytovatele platební brány (FAPI nebo Stripe). Je velmi pravděpodobné, že platby z Ruska nebo s použitím specificky ruských platebních nástrojů nebudou možné.

## Jsem technicky méně zdatný/á a nastavení BuddyPro instance je pro mě příliš složité. Nabízí tým BuddyPro placenou službu kompletního nastavení instance na klíč, nebo mohu celé nastavení na někoho delegovat?

Ačkoliv z technického hlediska je možné, aby vám vaší BuddyPro instanci nastavil někdo jiný, tým BuddyPro v současné době z kapacitních důvodů **nenabízí** placenou službu kompletního nastavení instance na klíč. Cílem platformy je, aby bylo nastavení co nejvíce intuitivní a zvládnutelné i pro běžné uživatele s pomocí detailních návodů a nově i s interaktivním vedením přímo od vaší BuddyPro instance (sama vás provede jednotlivými kroky).

Pokud si přesto na kompletní technické nastavení netroufáte, doporučujeme:

1. **Požádat o pomoc technicky zdatnějšího kolegu, asistenta nebo freelancera.** K dispozici je podrobný postup, jak může technickou část vytvoření instance provést někdo jiný než finální vlastník.
2. **Využít maximálně dostupné návody a podporu komunity.** Mnoho kroků je detailně popsáno a v Telegram skupině BuddyPro Owners si uživatelé navzájem radí. S postupným vývojem platformy se bude proces nastavení dále zjednodušovat.
3. **Poptat v komunitě BuddyPro Owners někoho, kdo vám s nastavením pomůže.** Komunita BuddyPro Owners se neustále rozrůstá a mnoho technicky zdatnějších členů má již s nastavováním BuddyPro dostatečné zkušenosti, aby pro vás dokázali BuddyPro instanci nastavit.

---

# Budoucnost a vize

## Jak BuddyPro pomáhá k lepšímu vztahu s klienty?

BuddyPro nabízí unikátní možnosti pro budování vztahu s klienty:

**1. Neustálá dostupnost a podpora**:

- BuddyPro je k dispozici 24/7, takže klienti mohou získat pomoc kdykoliv potřebují
- Tento pocit nepřetržité podpory výrazně zvyšuje hodnotu vašich služeb
- Klienti nejsou omezeni vaším časem nebo dostupností

**2. Personalizovaná interakce**:

- BuddyPro si pamatuje všechny minulé konverzace a preference klienta
- S každou další interakcí se personalizace prohlubuje
- Klient se cítí pochopen a vnímá, že se mu dostává individuální pozornosti

**3. Konzistentní komunikace**:

- BuddyPro vždy komunikuje v souladu s vašimi hodnotami a stylem
- Poskytuje konzistentní zkušenost, která odpovídá vaší značce
- Klienti se mohou spolehnout na stabilní kvalitu interakcí

**4. Budování důvěry**:

- Klienti získávají důvěru, když vidí, že BuddyPro poskytuje skutečnou hodnotu
- Schopnost správně aplikovat vaše know-how posiluje vaši pozici experta
- Transparentnost ohledně možností a limitů AI vytváří autentický vztah

## Někteří moji klienti nedůvěřují Telegramu nebo ho neznají. Plánuje se podpora BuddyPro i na jiných platformách (např. Signal, WhatsApp) nebo vlastní aplikace? Jaké jsou hlavní výhody Telegramu?

V současné době je platforma BuddyPro dostupná výhradně prostřednictvím aplikace Telegram. Chápeme, že někteří uživatelé mohou mít k Telegramu výhrady nebo preferují jiné komunikační kanály.

**Budoucí plány:** Do budoucna se zvažuje rozšíření dostupnosti BuddyPro i na další platformy a případně i vývoj vlastní aplikace.

**Proč byl Telegram zvolen jako výchozí platforma:**

- **Multiplatformní dostupnost:** Telegram funguje na všech hlavních operačních systémech (Windows, MacOS, Linux, Android, iOS) a má i webovou verzi.
- **Pokročilé funkce pro boty:** Telegram nabízí robustní API pro vývoj botů, které umožňuje bohatou interakci (text, hlasové zprávy, tlačítka, sdílení souborů atd.).
- **Bezpečnost:** Telegram je známý svým důrazem na soukromí a šifrování (i když ne všechny chaty jsou end-to-end šifrované defaultně, komunikace s boty je zabezpečená).
- **Uživatelská základna:** Má velkou a rostoucí uživatelskou základnu po celém světě.
- **Jednoduchost pro uživatele:** Pokud již uživatelé Telegram mají, nemusí si vytvářet nové účty ani se učit nové rozhraní. Mohou mít všechny své AI asistenty na jednom místě.
- **Náklady na vývoj:** Využití existující platformy snižuje náklady a čas potřebný na vývoj vlastního rozhraní, což umožňuje rychlejší rozvoj klíčových AI funkcí a schopností platformy BuddyPro.

## Plánuje se nějaký administrátorský dashboard, kde bych jako vlastník instance viděl/a statistiky o využití tarifů mými zákazníky, náklady, ziskovost apod.?

Ano, vytvoření pokročilejšího analytického dashboardu pro vlastníky BuddyPro instancí je součástí dlouhodobější vize platformy. Cílem je poskytnout vám lepší přehled o tom, jak jsou vaše AI instance využívány, jaké jsou náklady na jejich provoz a jaká je jejich ziskovost.

První verze analytického přehledu je zatím k dispozici přímo v Telegramu.

Jako vlastník (owner) nebo člen týmu můžete použít příkaz `/stats`. Po jeho zadání obdržíte komplexní report s klíčovými statistikami vaší instance, jako jsou:

- **Finanční přehled:** Celkové tržby, náklady na AI (celkové i provozní), aktuální stav kreditů.
- **Statistiky zpráv:** Celkový počet zpráv a průměrná cena za zprávu.
- **Uživatelská analytika:** Celkový počet uživatelů, počet aktivních předplatitelů a počet uživatelů na trialu.
- **Trendy:** Statistiky nákladů a zpráv za poslední týden a měsíc.

Tento příkaz představuje první krok k plnohodnotnému administrátorskému dashboardu a poskytuje vám klíčová data pro řízení a optimalizaci vaší BuddyPro instance.

Sledujte oznámení v komunitní Telegram skupině BuddyPro Owners pro aktuální informace o nových funkcích.

## Nahradí AI experti lidské experty?

**AI je partner.** Úspěšní budou experti **kombinující AI se svou autenticitou**. Spíše než kompletní nahrazení jde o transformaci role expertů:

**Proměna expertního podnikání**:
David Kirš: “BuddyPro je nejen evolučním produktem, na který podle mě přejde celý expert byznys (e-booky, online kurzy, online vzdělávání přejde do interaktivní, inteligentní podoby ve formě těchto nových produktů), ale zároveň nám pomůže šířit poznatky, aniž bychom museli sedět u počítačů.”

**Klíčová perspektiva**:
Pavel Říha: “Nejde o to, jestli AI nahradí experty, jde o to, čí AI to bude.” A dodává: “Pokud mě má nahradit AI, chci, aby to bylo moje AI. AI, která mě připraví o práci, ale ne o příjem, která naopak mi svým způsobem uvolní ruce a pomůže mi podnikat efektivněji.”

**Lidský kontakt zůstává důležitý**:

- Prémiové služby budou pravděpodobně vždy zahrnovat určitou míru lidského kontaktu
- AI experti mohou převzít rutinní aspekty, zatímco lidští experti se zaměří na složitější problémy
- VIP balíčky často kombinují AI s osobními konzultacemi

**Nová rovnováha**:

- AI může poskytovat každodenní podporu a základní poradenství
- Lidští experti mohou nabídnout hluboký vhled, empatie a tvůrčí řešení
- Optimální model může být kombinací obou přístupů

Celkově se zdá, že AI nenahradí lidské experty zcela, ale vytvoří novou dynamiku, kde experti budou fungovat efektivněji a v některých případech na vyšší úrovni díky podpoře AI.

## Jaká je vize budoucnosti BuddyPro?

Cílem je **všudypřítomný, inteligentní digitální kolega**, dostupný na webu i v dalších aplikacích, schopný komunikovat hlasem, pomáhat s byznysem (marketing, prodej) a výhledově i vykonávat úkoly (AI agent).

---

# Časté chyby a řešení

## Co dělat, když mi příkaz s parametry nefunguje nebo hlásí chybu?

Pokud vám příkaz, který vyžaduje parametry, nefunguje:

1. **Pečlivě zkontrolujte syntaxi:** Ujistěte se, že jste příkaz napsali přesně, včetně počátečního lomítka `/`, názvu příkazu (pozor na velká a malá písmena) a všech oddělovačů (typicky dvojtečky `:` mezi parametry).
2. **Zástupné symboly:** Nahraďte zástupné symboly (jako `{userId}`, `{count}`, `{URL_složky}`) skutečnými hodnotami **bez složených závorek `{}`**. Např. `/addTrialMessages:123456789:100`.
3. **Pořadí parametrů:** Dodržte správné pořadí parametrů, jak je uvedeno v nápovědě (`/help`) nebo dokumentaci.
4. **Skryté znaky:** Pokud kopírujete příkaz nebo jeho části odjinud, pozor na možné skryté znaky nebo nesprávné typy znaků (např. jiný typ pomlčky, uvozovek). Raději příkaz přepište ručně.
5. **Oprávnění:** Ověřte, že máte pro daný příkaz potřebná oprávnění (většinu administrátorských příkazů může volat pouze vlastník instance). Pokud chyba přetrvává, zkontrolujte si přesný formát příkazu v nápovědě (`/help`) nebo kontaktujte podporu.

## Zobrazuje se mi "Commands not allowed" při zadávání příkazu, kde je chyba?

Nejčastěji je to **překlep nebo nesprávná velikost písmen**. Příkazy jsou citlivé na velikost písmen (case-sensitive). Pečlivě zkontrolujte formát podle výpisu z `/help` nebo dokumentace. Např. správný formát je `/generateBuddyProInvite:{trialMessages}:{code}:{usersLimit}`, **nikoli** `/generateBuddyProinvite:...`. Ověřte také, zda zadáváte příkaz ve správné instanci Buddyho a zda máte potřebná oprávnění.

## Při nastavování Google Drive složky pomocí `/setFolder` se mi opakovaně zobrazují chyby jako "Failed to prepare your folder with error: prepareBuddyProStructure failed, Cannot read properties of undefined (reading 'driveSemaphore')" nebo "Folder is not empty", i když postupuji podle návodu. Co s tím?

Tyto chyby mohou být způsobeny dočasnými problémy na straně serverů, drobnými nekonzistencemi v nastavení, nebo chybou při předchozím pokusu o vytvoření struktury. Zkuste následující kroky:

1. **Přesnost URL:** Ujistěte se, že jste URL adresu vaší Google Drive složky zadali do příkazu `/setFolder:{URL_složky}` naprosto přesně, bez mezer navíc na začátku či na konci.
2. **Vyprázdnění složky:** Pokud chyba hlásí, že složka není prázdná ("Folder is not empty"), otevřete danou složku na vašem Google Drive a **vymažte veškerý její obsah**. To zahrnuje i případné podsložky (`sources`, `ROLES` atd.), které tam BuddyPro mohl částečně vytvořit při předchozím neúspěšném pokusu. Složka musí být pro úspěšné nastavení zcela prázdná. Poté zkuste příkaz `/setFolder` znovu.
3. **Nová složka:** Pokud problémy přetrvávají, vytvořte na svém Google Drive zcela **novou, prázdnou složku**, nasdílejte ji emailové adrese, kterou vám BuddyPro sdělil (s právy Editora), a zkuste tuto novou složku propojit pomocí `/setFolder` s její novou URL.
4. **Vyčkejte a zkuste znovu:** Někdy může jít o dočasný problém. Vyčkejte několik minut a zkuste příkaz znovu.
5. **Kontaktujte podporu:** Pokud ani jeden z výše uvedených kroků nepomůže, kontaktujte podporu na `support@buddy.fm`. Uveďte přesné znění chybové hlášky, název vašeho bota (username) a čas, kdy k chybě došlo. Tým BuddyPro mohl mezitím identifikovat a opravit případnou chybu na platformě.

## Proč dostávám chybu "The user does not have sufficient permissions for this file" při `/update`?

Tato chyba pravděpodobně znamená, že BuddyPro se během procesu `/update` snaží upravit nebo smazat soubor, ke kterému nemá oprávnění, protože **vlastníkem souboru jste vy**, nikoli BuddyPro. K tomu může dojít, pokud jste **omylem vytvořili nebo upravili soubor přímo ve složce `TRANSCRIPTIONS`**. Tato složka je určena pouze pro soubory generované BuddyPro.

**Řešení:** Projděte si složky `TRANSCRIPTIONS` (v `sources/Files` a `sources/URLs`) a **smažte veškeré soubory, které jste tam vytvořili vy ručně**. Poté zkuste příkaz `/update` znovu.

## Příkaz `/update` hlásí chybu "subfolders not allowed". Co to znamená a jak to opravit?

Tato chyba znamená, že ve složce `sources/Files` (nebo případně `sources/Texts` či `sources/URLs`, i když tam je to méně pravděpodobné) **máte kromě nahraných souborů i nějaké podsložky**. Struktura je navržena tak, aby v těchto složkách byly přímo soubory, nikoli další adresáře.

**Jak to opravit:**

1. Otevřete složku `sources/Files` (a případně další podsložky `sources`) na vašem Google Drive.
2. **Přesuňte všechny soubory** z jakýchkoli podsložek přímo do složky `Files`.
3. **Smažte všechny prázdné podsložky**, které jste tam vytvořili.
4. Spusťte příkaz `/update` znovu.

## Co dělat, když mi `/update` hlásí chybu ohledně `language code` v `Transcription settings`?

Pokud vám příkaz `/update` hlásí chybu související s `language code` (kódem jazyka), zkontrolujte soubor `transcription_settings.gdoc` ve vaší BuddyPro složce na Google Drive. Ujistěte se, že v poli `LANGUAGE` máte buď platný ISO 639-1 kód jazyka (např. `cs` pro češtinu, `en` pro angličtinu), nebo je pole prázdné, pokud máte materiály ve více jazycích. Vaše BuddyPro instance by vás měla při použití příkazu `/update` na případnou chybu v kódu jazyka upozornit.

## Mám problém s nahráním souboru obsahujícího URL odkazy na mé produkty (např. z e-shopu) přes `/update`, hlásí to chybu transkripce. Co s tím?

Ujistěte se, že soubor s URL adresami je ve správném formátu:

- Adresy by měly být uložené v Google Dokumentu `URL SOURCES.gdoc` umístěném ve složce `SOURCES/URLs/`.
- Každá URL adresa by měla být na samostatném řádku.
- URL adresy by měly být kompletní (včetně `http://` nebo `https://`).
- Zkontrolujte, zda za URL adresami nejsou žádné nadbytečné znaky, mezery nebo komentáře.
- Všechny URL musí být veřejně přístupné, aby je BuddyPro mohl navštívit a zpracovat jejich obsah. Pokud problém přetrvává i po kontrole formátu a dostupnosti URL, kontaktujte podporu a poskytněte problematickou URL k analýze.

## Moje BuddyPro instance přestala komunikovat a příkazy jako `/update` nebo `/updateRoles` hlásí chybu (např. "Cannot read properties of undefined (reading 'id')") nebo se proces zasekne. Co se děje?

Tento stav může nastat z několika důvodů:

1. **Překročení nákladového limitu při `/update`:** Při zpracování velkého množství dat (zejména audio/video) může dojít k překročení interního bezpečnostního limitu nákladů na jednu operaci (např. $50). Instance vás o tom informuje zprávou "Updating Buddy Pro exceeded a $XX cost limit...". V takovém případě spusťte příkaz `/update` (nebo `/updateRoles`) znovu, aby se pokračovalo ve zpracování. Zvažte vypnutí `IMPROVED_TRANSCRIPTIONS` v  `transcription_settings.gdoc` pro snížení nákladů na přepisy.
2. **Problém se strukturou složek na Google Drive:** Mohli jste omylem smazat nebo přesunout klíčový soubor nebo složku, kterou BuddyPro potřebuje (např. celou složku `ROLES` nebo soubor `ROLES/LIST OF ROLES.gdoc`). Ačkoliv systém by měl být schopen některé tyto soubory znovu vytvořit, závažnější zásah může vést k chybě.
3. **Dočasná chyba platformy:** Může se jednat o dočasný výpadek nebo chybu v systému BuddyPro, na jejíž opravě tým pracuje. Zkuste to později.
4. **Vyčerpané AI kredity:** Ujistěte se, že máte dostatek AI kreditů pro provoz instance. Zkontrolujte jejich stav dotazem u své instance (pokud reaguje) nebo kontaktujte podporu.

Pokud problém přetrvává, kontaktujte podporu `support@buddy.fm` s přesným popisem chyby, časem, kdy k ní došlo, a názvem vaší BuddyPro instance (username bota).

## Když jsem dala `/update` po nahrání onboardingových zpráv, napsal mi Buddy toto: `Error: Failed to parse <ONBOARDING-MESSAGES> tag content in ONBOARDING document, JSON is invalid`. Kde může být problém?

Tato chyba signalizuje, že struktura obsahu v tagu `<ONBOARDING-MESSAGES>` (nebo případně `<FIRST-MESSAGES-EXAMPLES>`) ve vašem souboru `onboarding.gdoc` není platný JSON. Nejčastěji jde o drobnou syntaktickou chybu, jako je:

- Čárka navíc za posledním prvkem v seznamu (za poslední složenou závorkou `}` před uzavíracím tagem `]`).
- Chybějící uvozovky kolem klíčů nebo textových hodnot.
- Nesprávně zapsané závorky (`{`, `}`, `[`, `]`). Pečlivě zkontrolujte syntaxi obsahu mezi tagy. Můžete celý obsah tagu `<ONBOARDING-MESSAGES> [...] </ONBOARDING-MESSAGES>` zkopírovat do online JSON validátoru, který vám pomůže chybu najít. Případně můžete zkusit požádat AI (např. ChatGPT) o opravu vašeho JSON kódu s tím, že mu ukážete strukturu, kterou potřebujete dodržet.
- Nejsnazší způsob jak chybu odstranit je dát do ChatGPT s prosbou “Níže přiložený JSON kód není validní, prosím oprav překlepy a předělej do validního JSON formátu.”

## Proč selhává `/connectForm` s chybou "Form does not exist...", i když `/setupFapi` proběhlo?

Tato chyba může mít několik příčin:

1. **Chyba v `/setupFapi`:** I když příkaz zahlásil úspěch, možná jste zadali `{apikey}` **včetně složených závorek `{}`**. Ověřte, že jste zadali klíč bez nich, a pro jistotu spusťte `/setupFapi:{username}:{apikey}` znovu správně.
2. **Nesprávné ID:** Dvakrát zkontrolujte, zda zadáváte **správné ID formuláře (`{id}`)** a **správné ID produktu (`{productId}`)** v příkazu `/connectForm`. Najdete je ve FAPI v sekcích `Forms` a `Templates/Items`.
3. **Chyba v syntaxi odkazu v emailu/děkovačce:** Ujistěte se, že odkaz pro aktivaci obsahuje **přesně** `{invoiceNumber}` (pro FAPI), nikoli `{{number}}` nebo jiný formát proměnné. BuddyPro kontroluje i toto nastavení ve FAPI formuláři.

Pokud chyba přetrvává, kontaktujte podporu a uveďte přesný příkaz, který zadáváte, a ID formuláře/produktu.

## Příkaz `/connectForm` mi hlásí chybu "Form does not contain product with id [číslo]" nebo nereaguje, i když si myslím, že mám vše nastaveno správně. Co může být příčinou?

Pokud máte problémy s příkazem `/connectForm` a propojením FAPI formuláře, zkontrolujte následující:

1. **Jeden BuddyPro produkt na formuláři:** Ujistěte se, že FAPI prodejní formulář, který se snažíte propojit, obsahuje **pouze jeden produkt** (položku) typu BuddyPro (ať už je to subscription nebo package). Ve FAPI formuláři **nelze mít na výběr z více různých BuddyPro produktů/tarifů/balíčků zároveň**. Pro každý samostatný tarif nebo balíček musíte mít samostatný FAPI formulář.
2. **Správné ID produktu a formuláře:** Důkladně ověřte, že do příkazu `/connectForm:{id_formuláře}:{id_produktu}:{typ}:{zprávy}` zadáváte:
   - Správné **ID formuláře** (získáte ho z URL adresy daného FAPI formuláře – je to číselná nebo textová hodnota za `/form/` nebo `?id=`).
   - Správné **ID produktu** (té konkrétní položky, kterou uživatel kupuje – najdete ho ve FAPI v sekci `Šablony -> Položky`, je to číselná hodnota).
   - Překlepy jsou velmi časté.
3. **Správné nastavení události ve FAPI:** Pro úspěšné automatické aktivace je klíčové mít ve FAPI u daného prodejního formuláře správně nastavenou "Událost" (webhook), která informuje BuddyPro o zaplacení objednávky. Použijte ve své BuddyPro instanci příkaz `/checkSetup`. Ten prověří vaše propojení s FAPI a pokud zjistí chybějící nebo nesprávně nastavenou událost, navede vás, jaké jsou další kroky.
4. **Dočasná chyba platformy:** Vzácně se může jednat o dočasný problém na straně BuddyPro nebo FAPI. Pokud jste si jisti správností všech ID a nastavení, zkuste to provést znovu s malým časovým odstupem.

Pokud problémy přetrvávají, kontaktujte podporu `support@buddy.fm` s přesným zněním příkazu, který zadáváte, a ID formuláře a produktu z FAPI.

## Co dělat, když mi BuddyPro instance hlásí nedostatek AI kreditů a přestane fungovat, ani mi jako ownerovi neumožní dobít kredity (např. neposílá odkaz na `/setupCredits`)?

Pokud vaše BuddyPro instance hlásí nedostatek AI kreditů a v důsledku toho přestane reagovat i na vaše příkazy jakožto vlastníka (ownera), včetně příkazů pro dobití kreditů (např. `/setupCredits` nebo vás na něj nenavede), jedná se o nestandardní a kritickou situaci.
Platforma by měla i v případě nedostatku kreditů umožnit ownerovi přístup k administrátorským funkcím pro správu kreditů. Pokud se tak neděje:

1. **Vyčkejte několik minut:** Může se jednat o dočasné přetížení systému. Zkuste za několik minut znovu.
2. **Kontaktujte ihned podporu:** Napište na `support@buddy.fm` s urgentním popisem problému, uveďte username vašeho bota a čas, kdy problém nastal. Aby k této situaci nedocházelo, je klíčové mít správně nastavené **automatické dobíjení AI kreditů** pomocí propojené platební karty a dostatečně vysoký limit pro dobití i **dostatečně vysokou hranici, při které se dobíjení spustí**.

## Příkaz `/checkSetup` mi na konci vypisuje: "NOTE: Your Buddy Pro is NOT publicly available through t.me/USERNAME_BOTA - it needs to contain an invite code...". Znamená to, že je něco špatně?

Ne, toto hlášení na konci výpisu příkazu `/checkSetup` neznamená, že je ve vašem nastavení chyba. Je to pouze **informativní poznámka**, která připomíná důležitý princip fungování přístupu k BuddyPro instancím:

- Aby nový uživatel mohl začít konverzaci s vaší BuddyPro instancí a získat trial zprávy (pokud je nabízíte), musí použít **speciální pozvánkový odkaz**. Tento odkaz typicky vypadá jako `https://t.me/USERNAME_BOTA?start=KOD_POZVANKY` a obsahuje unikátní kód vaší pozvánky.
- Alternativně, pokud si uživatel zakoupí předplatné přes váš prodejní formulář (Stripe/FAPI), aktivační odkaz z děkovací stránky nebo emailu také obsahuje potřebné parametry pro spojení platby s jeho Telegram účtem a aktivaci přístupu. Samotné uživatelské jméno vašeho bota (např. `t.me/USERNAME_BOTA`) bez těchto speciálních parametrů (jako `start=KOD`) neumožní novému uživateli automaticky zahájit konverzaci s trial zprávami nebo s již aktivovaným předplatným. Hláška tedy pouze zdůrazňuje nutnost používání korektních pozvánkových/aktivačních linků.

## Klient zaplatil tarif přes FAPI, ale přístup se mu neaktivoval. Co mám zkontrolovat?

Pokud se klientovi po zaplacení tarifu neaktivoval přístup k vaší BuddyPro instanci:

1. **Ověřte nastavení FAPI propojení:** Spusťte ve své BuddyPro instanci příkaz `/checkSetup`. Tento příkaz zkontroluje klíčová nastavení, zejména zda máte u daného FAPI prodejního formuláře správně nastavenou "Událost" pro "Zaplacení objednávky", která informuje BuddyPro o úspěšné platbě. Pokud `/checkSetup` odhalí problém, navede vás, jak jej ve FAPI opravit.
2. **Klient kliknul na aktivační odkaz:** Ujistěte se, že klient kliknul na aktivační odkaz, který by mu měl přijít v potvrzovacím emailu z FAPI a zobrazit se na děkovací stránce FAPI. Tento odkaz obsahuje unikátní kód, který propojí platbu s jeho Telegram účtem.
3. **Časové zpoždění:** Někdy může dojít k malému zpoždění (v řádu minut) mezi provedením platby a odesláním informace z FAPI do systému BuddyPro. Pokud klient kliknul na aktivační odkaz ihned po platbě, mohlo se stát, že systém BuddyPro ještě neměl informaci o zaplacení. V takovém případě by mělo pomoci, pokud klient klikne na aktivační odkaz znovu s malým časovým odstupem.
4. **Správný přenos `userId` (u rozcestníků):** Pokud používáte vlastní stránku (rozcestník) s více tarify, odkud teprve odkazujete na FAPI formuláře, ujistěte se, že parametr `userId` (který je součástí URL, když BuddyPro přesměruje uživatele na vaši stránku např. po vyčerpání trialu) je správně přenesen až na finální FAPI formulář. Pokud se `userId` ztratí "po cestě", automatické spárování platby s uživatelem selže. _(Poznámka: Pro Stripe integraci se na rozdíl od FAPI nepoužívá parametr `userId` ale `client_reference_id`)_

Pokud problém přetrvává, kontaktujte podporu.

## Klient zaplatil tarif přes Stripe, ale přístup se mu neaktivoval. Co mám zkontrolovat?

Pokud se klientovi po zaplacení tarifu neaktivoval přístup k vaší BuddyPro instanci:

1. **Ověřte nastavení Stripe produktu:** Váš Stripe produkt musí obsahovat správná metadata (`case: buddy_pro, messages: číslo`)
2. **Klient kliknul na aktivační odkaz:** Ujistěte se, že klient kliknul na aktivační odkaz, který by mu měl přijít v potvrzovacím emailu. Tento odkaz obsahuje unikátní kód, který propojí platbu s jeho Telegram účtem.
3. **Správný přenos** `*client_reference_id`* **(u rozcestníků):** Pokud používáte vlastní stránku (rozcestník) s více tarify, odkud teprve odkazujete na Stripe formuláře, ujistěte se, že parametr `*client_reference_id*` (který je součástí URL, když BuddyPro přesměruje uživatele na vaši stránku např. po vyčerpání trialu) je správně přenesen až na finální Stripe formulář. Pokud se `*client_reference_id`* ztratí "po cestě", automatické spárování platby s uživatelem selže. *(Poznámka: Pro FAPI integraci se na rozdíl od FAPI nepoužívá parametr `client_reference_id`ale`userId`)\*

Pokud problém přetrvává, kontaktujte podporu.

## Mým klientům se někdy nepřipíší zakoupené balíčky zpráv (nebo se neaktivuje subscription) ihned po platbě, i když kliknou na aktivační odkaz z FAPI emailu. Kde může být problém?

Toto může být způsobeno časovým prodlením mezi okamžikem úspěšné platby ve FAPI a okamžikem, kdy FAPI odešle notifikaci (event/webhook) o této platbě systému BuddyPro. Pokud klient klikne na aktivační odkaz (z emailu nebo děkovací stránky FAPI) dříve, než BuddyPro tuto notifikaci obdrží a zpracuje, systém nemusí být schopen platbu ihned spárovat s uživatelem.
**Řešení:**

- Požádejte klienta, aby na aktivační odkaz kliknul **znovu s malým časovým odstupem** (např. po 5-10 minutách). V té době by již informace o platbě měla být v BuddyPro systému k dispozici.
- Tým BuddyPro pracuje na optimalizaci tohoto procesu, aby byl co nejrychlejší a nejspolehlivější. Dále se ujistěte, že pokud používáte vlastní webovou stránku jako rozcestník pro různé tarify, je správně implementováno přenášení parametru `userId` z URL (kterou Buddy generuje při odkazu na vaši stránku) až na finální FAPI formulář. Bez správného `userId` na FAPI formuláři (pokud uživatel nejde přes odkaz z emailu) nemůže dojít k automatickému spárování. _(Poznámka: Pro Stripe integraci se na rozdíl od FAPI nepoužívá parametr `userId` ale `client_reference_id`)_

## Můžu změnit nebo přidat Stripe/FAPI účet, se kterým je moje Buddy Pro propojené?

Nemůžete, jakmile svoje Buddy Pro propojíte se svým FAPI nebo Stripe účtem a začnete prodávat, už nesmíte Stripe/FAPI účet změnit, protože by přestalo fungovat propojení s existujícími předplatnými. Znamená to, že nemůžete znovu zavolat příkaz /setupFapi nebo /setupStripe, jakmile už jste integraci dokončili a začali jste prodávat. Tuto změnu můžete udělat pouze pokud jste ještě nezačali prodávat. Pokud potřebujete své Buddy Pro které se již prodává převést na jiný Stripe/FAPI účet, kontaktujte podporu.