Блог CZ
2026-10-11 17:06 Telegram a automatizace

Technické zadání Telegram bota: scénáře, role a kritéria dokončení

Technické zadání Telegram bota má vysvětlovat, jaký úkol systém plní, kdo ho používá a co se považuje za úspěšný výsledek. Samotný seznam tlačítek nestačí: je třeba popsat přechody, data, integrace a chování při chybách.

Začněte procesem, který chce firma automatizovat. Poté ho rozdělte na ověřitelné scénáře. Usnadníte tím dohodu o rozsahu vývoje i převzetí hotové práce.

Určete úkol a hranice první verze

Popište současný proces: odkud přicházejí poptávky, co zaměstnanec upřesňuje, kde se ukládají data a jaký další krok dostane zákazník.

Formulujte výsledek první verze, například: „Získat žádost o konzultaci, uložit ji a předat odpovědnému obchodníkovi.“ Samostatně vypište funkce, které zatím nejsou součástí práce: platby, rezervace termínu, věrnostní program nebo složitá doporučení.

U každé funkce určete prioritu a závislost. Pokud online rezervace vyžaduje aktuální kalendář, přístup k němu a pravidla změn termínů musí být dohodnuty před vývojem.

Pokud rozhraní ještě není vybrané, nejprve zvažte, kdy se hodí bot, Mini App nebo web. V zadání zaznamenejte zvolenou variantu a místa přechodu mezi rozhraními.

Popište role a oprávnění

Obvykle je vhodné rozlišit:

  • Zákazníka: prohlížení informací, odeslání poptávky a změna vlastních údajů v povoleném rozsahu.
  • Obchodníka: příjem přidělených poptávek, odpovědi a změna pracovních stavů.
  • Administrátora: správa přístupů, číselníků a nastavení.

Pro každou akci určete, kdo ji smí provést a které záznamy vidí. Upřesněte udělování a odebírání přístupu, změnu odpovědné osoby i postup při odchodu zaměstnance.

Skryté tlačítko nenahrazuje kontrolu oprávnění. Systém musí nepovolenou akci odmítnout, i když uživatel odešle příkaz přímo. Zobrazované jméno ani znalost názvu příkazu nepoužívejte jako potvrzení role.

Zapište scénáře od vstupu po výsledek

Karta scénáře může obsahovat:

  1. Název a cíl: jaký úkol uživatel plní.
  2. Vstupní bod: příkaz, tlačítko nebo odkaz z webu či reklamy.
  3. Výchozí podmínky: role, jazyk, existující poptávka nebo jiné údaje.
  4. Kroky: co bot zobrazuje, co člověk vybírá a co se ukládá.
  5. Přechody: další krok, návrat, úprava a zrušení.
  6. Výjimky: chybný vstup, nedostupná služba nebo opakovaná akce.
  7. Výsledek: záznam v systému, oznámení a další krok zákazníka.
  8. Kritérium ověření: jak potvrdit, že scénář proběhl správně.

Přiložte texty zpráv a názvy tlačítek v potřebných jazycích. Popište, co se stane, když člověk napíše volný text, vrátí se později nebo bota spustí znovu. Nenuťte uživatele hádat jediný povolený příkaz.

Zohledněte možnosti Telegramu

Pro běžnou konverzaci s botem počítejte s akcí uživatele, která komunikaci zahájí. Bot nemůže sám otevřít konverzaci s libovolným člověkem: ten mu musí nejprve napsat nebo ho přidat do skupiny. Toto omezení popisuje dokumentace Telegramu.

Pokud potřebujete telefonní číslo, nepočítejte s tím, že ho získáte z uživatelského jména. Tlačítko pro vyžádání kontaktu v Bot API předá číslo po stisknutí uživatelem a je dostupné v soukromém chatu. Popis KeyboardButton.

Pokud scénář funguje ve skupině, samostatně prověřte potřebná oprávnění a režim soukromí: přístup bota ke zprávám ve skupině je ve výchozím nastavení omezený. Možnosti botů v Telegramu.

Popište chování při zablokování bota uživatelem a při nemožnosti odeslat oznámení. Náhradní kanál zvolte pouze tehdy, když máte údaje a odpovídající důvod pro takovou komunikaci.

Určete data a fungování integrací

U každého pole určete účel, povinnost vyplnění, formát a místo uložení. Poptávka může například potřebovat zvolenou službu, popis úkolu, jazyk, kontakt pro odpověď a identifikátor poptávky.

Sbírejte údaje, které proces potřebuje. Určete přístup zaměstnanců, dobu uchování a postup mazání dat. Informování uživatele a potřebná potvrzení dohodněte podle zvolených trhů a scénářů.

Pro CRM nebo kalendář určete:

  • který systém je zdrojem aktuálního stavu;
  • jaká data se předávají a kdy;
  • jak se propojují záznamy různých systémů;
  • jak se řeší chyby, opakované události a zpoždění;
  • kdo dostane upozornění na problém a odstraní ho.

Poptávka uložená v botovi a poptávka vytvořená v CRM mohou být dva různé stavy. Potvrzovací text musí odpovídat skutečné fázi. Stisknutí tlačítka pro odeslání nelze prezentovat jako potvrzenou rezervaci konkrétního termínu.

Modelový příklad scénáře poptávky

Firma přijímá žádosti o konzultaci. V první verzi bot shromáždí poptávku a termín projedná obchodník.

  1. Uživatel spustí bota a vybere jazyk.
  2. Vybere službu a zadá popis úkolu.
  3. Uvede stanovený kontakt pro odpověď.
  4. Prohlédne si souhrn, upraví údaje nebo odešle poptávku.
  5. Systém uloží poptávku s identifikátorem a předá ji do CRM.
  6. Po potvrzení vytvoření záznamu bot oznámí předání poptávky a obchodník dostane upozornění.

Pokud CRM není dostupné, poptávka zůstane uložená a čeká na předání. Zákazník dostane zprávu o aktuálním stavu bez slibu potvrzeného času schůzky. Odpovědný zaměstnanec obdrží upozornění na chybu.

Opakovaný stisk tlačítka ani opakované doručení události nesmí vytvořit duplicitu téže poptávky. Události v Telegramu mají identifikátor aktualizace, který pomáhá rozpoznat opakované zpracování; konkrétní ochranu při přenosu do CRM musí implementovat vývojář. Popis Update v Bot API.

Samostatně určete, jak člověk vytvoří novou žádost po dokončení předchozí. Ochrana proti duplicitám nesmí zakázat všechny budoucí poptávky.

Udělejte kritéria dokončení ověřitelná

Místo „bot funguje správně“ sestavte seznam kontrol:

  • Všechny dohodnuté cesty vedou od vstupu po výsledek.
  • Chybný vstup je vysvětlen a již zadané údaje se uchovávají podle pravidel scénáře.
  • Návrat, zrušení a opětovný vstup dávají očekávaný výsledek.
  • Obchodník vidí pouze povolené záznamy a odebrání přístupu funguje.
  • Opakovaná událost nevytvoří duplicitu, zatímco nová žádost je přijata.
  • Chyba integrace je viditelná odpovědné osobě a řeší se dohodnutým postupem.
  • Jazyky, oznámení a texty odpovídají schválené verzi.
  • Jsou prověřeny dohodnuté aplikace a zařízení, která budou uživatelé používat.

Pro dobu odezvy a očekávanou zátěž stanovte měřitelné podmínky: počet současných uživatelů, typ akce, čas ověřování a přijatelné zpoždění. Hodnoty dohodněte podle skutečného procesu bez svévolného slibu stejné rychlosti při jakékoli zátěži.

Zaznamenejte předání a následnou podporu

Uveďte, komu patří bot, hosting aplikace a používané účty. V rámci předání dohodněte zdrojový kód nebo smluvně stanovený přístup k řešení, popis integrací, návod pro administrátora a postup zálohování.

Token bota nevkládejte do veřejně přístupného zadání. Telegram upozorňuje, že držitel tokenu získává kontrolu nad botem; předávejte ho pouze lidem, kteří přístup potřebují, dohodnutým bezpečným způsobem. Doporučení Telegramu.

Oddělte opravy nesouladu se zadáním, nové funkce a pravidelnou podporu. Určete, kdo po spuštění sleduje chyby a aktualizace integrací a jak se schvalují změny požadavků.

Pro jednání o vývoji Telegram bota a Mini App připravte popis procesu, role, karty scénářů a příklady dat. Obchodní nabídka pomůže dohodnout rozsah práce; složitost a omezení integrací upřesněte podle konkrétních systémů.