Správa vašich botů — připojte a provozujte vlastního telegramového bota

1Provoz Telm pod vaším vlastním botem

Ve výchozím stavu jsou vaše skupiny chráněny sdíleným botem Telm. Doplněk vlastní bot vám umožní provozovat stejnou ochranu pod botem, kterého vlastníte a značíte, takže členové vidí ve skupině vašeho bota místo našeho.

Obrazovka botů ve vašem účtu vypisuje každého vlastního bota připojeného k vašemu účtu, ukazuje jeho aktuální stav a umožňuje připojovat nové a přiřazovat je ke skupinám.

2Proč provozovat vlastního bota

Pro agentury, prodejce a značkové komunity je bot ve skupině součástí zážitku. Provoz vlastního bota znamená, že členové komunikují s vaším jménem a avatarem, uvítací a moderační zprávy přicházejí od vašeho bota a ochrana pod tím je stále kompletní engine Telm.

Je to rozdíl mezi používáním nástroje a nabízením služby: vaši členové nikdy nemusejí vědět, že je v tom Telm.

• Členové vidí vašeho bota, ne sdíleného bota Telm.
• Moderační engine, pravidla a reputace jsou beze změny — jen tvář je vaše.
• Ideální pro agentury spravující komunity klientů a pro značky, které chtějí konzistentní identitu.

3Co potřebujete nejdřív

Než můžete ve skupině použít vlastního bota, musí být pro tuto skupinu aktivní doplněk vlastní bot, navrch plánu Pro nebo Business. Pokud doplněk aktivní není, přiřazení bota je zablokováno s jasnou zprávou, která vám sdělí, že je doplněk vyžadován.

Potřebujete také vlastního bota, vytvořeného v Telegram BotFather, a jeho API token.

• Doplněk vlastní bot je dostupný v Pro a Business.
• Doplněk musí být aktivní na konkrétní skupině, kde chcete svého bota provozovat.
• Potřebujete bota z BotFather a jeho token.

4Připojení bota

Vytvořte bota v BotFather a zkopírujte token, který vám dá. Na obrazovce botů zvolte přidat nového bota a vložte token. Telm token ověří živým voláním do Telegramu, takže špatný nebo již zrušený token je okamžitě odmítnut, a poté bota zaregistruje k vašemu účtu pod jménem a uživatelským jménem, které Telegram hlásí.

Token je uložen zašifrovaně a každý bot dostane vlastní tajemství pro bezpečný provoz webhooků. Pro bezpečnost je registrace omezena rychlostí — můžete zaregistrovat až pět botů za hodinu — takže pokud vložíte několik tokenů rychle za sebou, můžete být požádáni o čekání.

• Token je před registrací bota živě prověřen vůči Telegramu.
• Tokeny jsou uloženy zašifrované silným šifrováním; surový token se po registraci už nikdy neodhalí.
• Registrace je omezena na pět pokusů za hodinu, aby se zabránilo zneužití.

5Pochopení stavů bota

Každý připojený bot ukazuje stav, takže na první pohled víte, zda funguje. Jsou jich celkem pět:

• Pending (čeká) — bot je zaregistrovaný a uvádí se do provozu.
• Active (aktivní) — bot běží a obsluhuje vaši skupinu (to je funkční stav).
• Stopped (zastaveno) — bot je připojený, ale momentálně neběží, protože jste ho zastavili.
• Suspended (pozastaveno) — bot byl pozastaven, protože vypršelo placení (doplněk nebo plán momentálně není aktivní); jeho token a nastavení jsou zachovány.
• Error (chyba) — něco se pokazilo, nejčastěji zrušený token; skupina se vrátí ke sdílenému botovi, dokud to nespravíte.

6Spouštění, zastavování a výměna botů

Z obrazovky botů můžete kdykoli spustit zastaveného bota nebo zastavit běžícího a přiřadit bota ke skupině (či ho z ní odebrat), která má doplněk aktivní. Pokud vyprší placení, dotčení boti přejdou do stavu Suspended; jakmile je plán opět aktivní, můžete je jedním kliknutím znovu zapnout a vrátí se do Active.

Pokud je váš token v BotFather zrušen, bot přejde do Error a skupina se dočasně vrátí ke sdílenému botovi Telm, aby ochrana nikdy nevypadla. K výměně tokenu bota zaregistrujte znovu s novým tokenem — neexistuje samostatný krok úpravy tokenu.

• Spouštějte, zastavujte a přiřazujte boty z jedné obrazovky.
• Pozastavený bot se jedním kliknutím obnoví, jakmile je plán opět aktivní.
• Zrušený token nahradíte tak, že bota znovu zaregistrujete s novým.
• Dokud je bot v Error, skupina dál běží na sdíleném botovi Telm.

7Udržení tokenu bota v bezpečí

Váš token bota je stejně citlivý jako heslo: kdokoli ho má, může vašeho bota ovládat. Telm token šifruje v úložišti a po připojení bota ho už nikdy nezobrazí, ale i tak byste ho měli chránit na své straně.

Pokud máte podezření, že token unikl, zrušte ho v BotFather a bota zaregistrujte znovu s čerstvým tokenem. Starý token přestane fungovat ve chvíli, kdy ho zrušíte.

8Řešení bota ve stavu Error

Pokud bot ukazuje Error, projděte obvyklé příčiny v pořadí.

• Token byl zrušen nebo je špatný — zaregistrujte bota znovu s platným tokenem z BotFather.
• Bot není ve skupině správcem, nebo mu chybí práva mazat či omezovat — opravte jeho práva správce a spusťte ho znovu.
• Doplněk vypršel — bot pak ukáže Suspended, ne Error; znovu ho zapněte, jakmile je plán opět aktivní.
• Po odstranění příčiny bota spusťte; měl by se vrátit do Active.