Hogyan hozd létre az első Telegram botodat a BotFatherrel

A MyAgenst a saját tulajdonú botodon keresztül irányítod Telegramból. Ezt a botot a BotFatherrel hozod létre, a Telegram hivatalos bot-készítő eszközével, és nagyjából egy percbe telik. A legegyszerűbb út a BotFather Mini App-ja: egy kis, végigvezetett képernyő a Telegramon belül, gombokkal és űrlapokkal, semmilyen parancsot nem kell megjegyezned. Ez az útmutató végigvisz rajta, plusz megmutat egy beállítást, amit érdemes bekapcsolni, hogy rajtad kívül senki ne tudjon írni a botodnak.

Mi az a BotFather?

A BotFather a Telegram hivatalos botja, ami más botokat hoz létre és kezel. Ad neked egy bot tokent: egy titkos kulcsot, amit a MyAgens arra használ, hogy üzeneteket küldjön és fogadjon a botod nevében. A BotFathert kétféleképp irányíthatod: a Mini App-ján keresztül (ajánlott, lásd lentebb), vagy parancsok begépelésével a csevegésben (a klasszikus mód, lentebb részletezve).

Hozd létre a botodat a Mini App-ban

1. Nyisd meg a Telegramot, és keress rá, hogy botfather. Válaszd ki a hitelesített fiókot (kék pipa), és nyomd meg az OPEN gombot a Mini App elindításához.

2. A My bots alatt koppints a Create a New Bot gombra.

3. Töltsd ki az űrlapot. A Bot Name a megjelenített név, bármi lehet, például MyAgens. A username-nek egyedinek kell lennie, és bot-ra kell végződnie, például my_agens_bot. Koppints a Create Bot gombra.

4. Megnyílik az új botod oldala, a tetején rögtön ott a token. Koppints a Copy gombra. Ezt a karakterláncot kéri majd a MyAgens beállítása.

Zárd le a botot a fiókodra

Ezt érdemes megtenni, amíg még a bot oldalán vagy: nyisd meg a Bot Settings menüt, görgess az Access részhez, és kapcsold be a Restrict bot usage opciót. Az Allowed users alapból You-ra van állítva, ami pont megfelelő a MyAgens számára: a kapcsoló bekapcsolt állapotában maga a Telegram utasít el mindenki mást, így az idegenek, akik ráakadnak a botodra, még csevegést sem tudnak vele kezdeni.

A MyAgens ezen felül saját engedélyezési listát is vezet (csak azoknak a Telegram felhasználói azonosítóknak válaszol, amelyeket te jóváhagytál), így két független zárad lesz: a Telegram már a kapunál kizárja a kívülállókat, a MyAgens pedig figyelmen kívül hagy mindenkit, aki nincs a listáján.

A klasszikus mód, parancsok

Inkább gépelnél? A parancsokkal is működik, és ugyanoda vezet:

1. Nyisd meg a csevegést a @BotFather-rel, és küldd el a /newbot parancsot.
2. Add meg a bot nevét, amikor kéri.
3. Válassz egy bot-ra végződő usernevet.
4. A BotFather válaszol a bot tokeneddel. Valahogy így néz ki: 123456789:AAExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.

Tartsd titokban a tokenedet

A bot tokened olyan, mint egy jelszó. Aki megszerzi, irányíthatja a botodat. Ne illeszd be nyilvános csevegésekbe, képernyőképekre vagy issue-kba. Ha valaha kiszivárogna, nyisd meg a botodat a BotFatherben, és koppints a token melletti Revoke gombra (vagy küldd el a /revoke parancsot a csevegésben), hogy újat generálj.

Kösd össze a MyAgensszel

A böngészős beállító oldal (macOS, Linux és Windows) elkéri a tokent, és élőben ellenőrzi, majd megnyomod a START gombot az új botod csevegésében, és az oldal felismer téged, így semmilyen azonosítót nem kell kikeresned. A csak terminálos varázsló (fejnélküli gépek, SSH) helyben kéri a tokent és a numerikus felhasználói azonosítódat, a felhasználói azonosító útmutató megmutatja, hol találod meg.

A bot kezelése később

Nyisd meg a BotFather Mini App-ját, és a botod ott lesz a My bots alatt: bármikor módosíthatod a nevét és a képét, visszavonhatod a tokent, vagy megváltoztathatod a hozzáférési listát. A régi parancsok (/mybots, /setname, /setuserpic, /revoke) ugyanezt tudják a csevegésből.