Navigácia
ELOWEN · Dokumentácia

Posledná aktualizácia: 20. októbra 2026

Prechádzať dokumentáciu · Telegram
Komunikačné kanály

Telegram

Pripojte Elowen k Telegramu pomocou bota. Plugin sa pripája dlhým dopytovaním, takže nemusíte vystavovať verejný webhook. O zdieľanej identite a pravidlách prístupu sa dočítate v článku Kanály.

Vytvorenie a pripojenie bota

  1. V Telegrame otvorte @BotFather, pošlite /newbot a skopírujte token.
  2. Ak má bot dostávať všetky správy v skupine, otvorte BotFather → Bot Settings → Group Privacy a súkromie skupín vypnite. Inak Telegram obmedzuje, ktoré správy zo skupín bot dostane.
  3. V Elowen otvorte Nastavenia → Dostupné pluginy, nainštalujte Telegram a potom zadajte token v Nastavenia → Prístupy → Telegram → Token bota.
  4. Pridajte pravidlo roly a plugin zapnite. Bot sa pri štarte pripojí a zverejní svoju ponuku príkazov.

Kto smie bota používať

Otvorte Nastavenia → Pluginy → Telegram → Pravidlá rolí. Do poľa ID roly pridajte číselné ID používateľa Telegramu, @username alebo ID chatu, čím vpustíte človeka alebo celú skupinu. ID skupín môžu byť záporné, napríklad -1001234567890. Použije sa prvé zodpovedajúce pravidlo; odosielatelia bez zhody sa ignorujú. Pravidlo * pre všetkých dajte za konkrétne pravidlá.

Odosielateľ tiež musí prepojiť svoju identitu v Telegrame s účtom Elowen. Oprávnenia k Projektom a nástrojom dodáva prepojený účet; zodpovedajúce pravidlo v Telegrame ich samo neudeľuje. Voľbou Prístup administrátora pri pravidle povolíte spoločné ovládanie ako /model, /reasoning, /context a /display aj operátorské príkazy ako /stop, /stats, /compact a /restart.

Obmedzenie odpovedí a oznámení

V Nastavenia → Pluginy → Telegram:

  • Odpovedať bez zmienky je v predvolenom nastavení zapnuté. V skupinách ho vypnite, ak chcete vynútiť @zmienku alebo odpoveď botovi. Priame chaty dostávajú odpovede ďalej.
  • Povolené chaty je doplnkový zoznam číselných ID používateľov alebo chatov. Ak ho necháte prázdny, rozhodujú len pravidlá rolí.
  • ID oznamovacieho chatu určuje, kam sa posielajú proaktívne správy. Použite číselné ID používateľa, skupiny alebo kanála, prípadne verejný @channelusername. Ak ho necháte prázdne, proaktívne správy sa vypnú.

Príkazy a zobrazenie

Telegram zobrazuje dostupné príkazy vo svojej ponuke a pre voľby používa inline klávesnice. Ponuka obsahuje /new, /stop, /stats, /compact, /fast, /project, /display a /help a ďalej výberové a režimové príkazy /model, /reasoning, /context, /plan, /build a /workflow; pluginy môžu pridať ďalšie. Príkazy, ktoré vyžadujú administrátora, ostatným odpovedia odmietnutím. /restart administrátorom funguje, ale v ponuke sa nezobrazuje.

Spoločné ovládanie /model, /reasoning, /context a /display vyžaduje pravidlo administrátora.

Voľby modelu, konverzácie a Projektu fungujú len pri poslednej ponuke v danom chate. Otvorenie ďalšej ponuky nahradí predchádzajúcu; staršie tlačidlá konverzáciu nezmenia ani novšiu ponuku nezavrú. Ak ponuka vypršala, otvorte príkaz znova.

Predvolené zobrazenie nastavte v Nastavenia → Pluginy → Telegram alebo použite /display v chate, kde máte oprávnenie:

  • Aktivita nástrojov: Vypnuté, Živý stav, alebo Živý výstup.
  • Doručenie odpovede: Len finálna odpoveď, alebo Živo streamovať odpoveď.
  • Detail výstupu nástrojov: Len stav, Krátke zhrnutie, alebo Posledná časť výstupu.
  • Rozloženie správ nástrojov: Jedna živá správa, alebo Jedna správa na nástroj.

Reakcie počas spracovania a Stavový riadok (riadok s modelom a kontextom pod odpoveďou) sú v predvolenom nastavení zapnuté. Reakcie počas spracovania ukazujú stav bota na Vašej správe: 👀, keď ju uvidel, 👍, keď je hotový, a 👎, keď zlyhal. Zobraziť uvažovanie je v predvolenom nastavení vypnuté a vyžaduje model, ktorý podporuje rozšírené uvažovanie. Jazyk služobných správ ovláda vlastné správy bota a ponúka angličtinu, češtinu a slovenčinu.

Otázky, obrázky, súbory a hlas

Otázky sa zobrazujú ako inline tlačidlá. Kliknutie odpovie na otázku s jednou voľbou; prompty s viacerými voľbami alebo s viacerými otázkami potrebujú Odoslať. Kde otázka povoľuje vlastnú odpoveď, zvoľte Iné a pošlite textovú odpoveď. Odpovedať môže len oslovený odosielateľ alebo administrátor. Odpovede na otázky zostávajú dostupné, kým ich Elowen neprijme alebo čakajúcu otázku nevyrieši. Interaktívne ponuky príkazov, napríklad /model, v predvolenom nastavení vypršia po šiestich minútach; ich časový limit nastavíte v nastavení pluginu v rozsahu 30 sekúnd až 30 minút. Toto nastavenie neurčuje inú lehotu pre otázky.

Na spracovanie obrázkov je potrebný model s podporou zraku. Voliteľný Model pre obrázky vyberie model; ak je prázdny, Elowen použije obvyklý model chatu. Predvolené hodnoty sú 5 MiB na obrázok (Max. veľkosť prichádzajúceho obrázka) a štyri obrázky na správu (Max. obrázkov na správu). K jednej odpovedi možno pripojiť až štyri obrázky zdieľané nástrojom ShareImage (Max. obrázkov na odpoveď). V odpovedi možno poslať aj až štyri zdieľané súbory. Telegram dlhé správy rozdelí podľa svojich limitov. Prepis zvuku je samostatný a podporuje klipy do 25 MiB.

Hlasové správy používajú hlasový režim core, ktorý sa nastavuje v Nastavenia → Hlasový režim. Pre prepojený účet s oprávnením na hlas Elowen správu prepíše a odpovie textom a hlasovou správou v OGG/Opus. Hlasový režim musí byť zapnutý a účet musí mať priestor v rámci limitu útraty. Ak je prepis odmietnutý alebo zlyhá, Elowen ponechá namiesto prepisu poznámku o prílohe, napríklad [Attachment: voice.ogg (audio/ogg)], a textová odpoveď napriek tomu odíde.

Plugin Telegram obsahuje nástroje na odosielanie správ a správu chatov, členov, správ a tém. Tieto nástroje používajú oprávnenia prepojeného účtu a stále potrebujú príslušné práva bota v Telegrame. Samostatný nástroj TelegramApi volá surové metódy Telegram Bot API bez ďalšieho potvrdenia, takže ho používajte len vtedy, keď špecializované nástroje nestačia.

Ďalej: Microsoft Teams