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.
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.
Obvykle je vhodné rozlišit:
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.
Karta scénáře může obsahovat:
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.
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.
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:
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.
Firma přijímá žádosti o konzultaci. V první verzi bot shromáždí poptávku a termín projedná obchodník.
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.
Místo „bot funguje správně“ sestavte seznam kontrol:
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.
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ů.