Telegram: saját bot csatlakoztatása
Beszélgess a Codumentorral telefonról vagy számítógépről egy saját Telegram-boton
keresztül. A Codumentor szerverének futnia kell, és el kell érnie a Telegramot;
nyilvános szervercímre vagy webhookra nincs szükség.
Mielőtt elkezded
Szükséged lesz Telegram-fiókra és egy működő Codumentor-példányra, beállított
modellel. A Telegram és a User Secrets bővítményt engedélyezni kell, a
Telegramot pedig per_user módra kell állítani. A bővítmény alapértelmezett
módja technical_user (közös bot), így egy személyes token hozzáadása önmagában
nem vált üzemmódot.
A Community kiadásban te üzemelteted a saját példányodat. Kérd meg a
konfigurációs asszisztenst:
Engedélyezd a Telegram és a User Secrets bővítményt a saját botomhoz.
A Telegram használjon per_user módot, időszakos botfelderítést és az első
üzenet küldőjéhez kötött tulajdonosi hozzáférést. A hangot egyelőre kapcsold
ki. Alkalmazás előtt mutasd meg a módosításokat.
Nézd át és hagyd jóvá a javasolt beállításokat. Kézi konfiguráláshoz az
angol nyelvű per-user konfigurációs referencia
ad mintát.
Központilag üzemeltetett példánynál kérd a rendszergazdától ennek a módnak az engedélyezését.
Biztonság: a Telegramról indított műveletek eszközengedély-kérései
automatikusan jóváhagyódnak; a globális tiltó szabályok továbbra is érvényesek.
Ne számíts arra, hogy a böngésző jóváhagyási ablaka megállítja ezeket a
műveleteket. A bot a te Codumentor-felhasználódként dolgozik, a te titkaiddal
és repókörnyezeteddel. Tartsd privátként.
1. Hozz létre egy botot a Telegramban
- Nyisd meg a @BotFather beszélgetést, és küldd el a
/newbotparancsot. - Kövesd az utasításokat: válassz megjelenítési nevet és egyedi,
botvégű felhasználónevet. - Másold ki a bot tokenjét. Kezeld jelszóként: ne másold be az asszisztenssel folytatott beszélgetésbe, ne commitold, és ne oszd meg másokkal.
2. Mentsd a tokent a Codumentorban
- Jelentkezz be azzal a Codumentor-fiókkal, amelyhez a botot kapcsolni szeretnéd.
- Nyisd meg a Beállítások → Bővítmények → User Secrets panelt (angol felületen Settings → Extensions → User Secrets), és válaszd a hozzáadást (Add).
- A név legyen
telegram_bot_token, az értékhez másold be a tokent. Ha a példányodban más atoken_secret_namebeállítás, azt a nevet használd. - Mentsd el. Időszakos felderítésnél a bot a következő ellenőrzéskor indul el (alapértelmezés szerint 60 másodpercenként); nem kell újraindítani a szervert.
3. Te küldd az első üzenetet
Nyisd meg az új botodat a Telegramban, és küldj neki egy rövid szöveges
üzenetet mielőtt megosztanád a felhasználónevét. Az alapértelmezett,
első üzenethez kötött tulajdonosi beállításnál (per_user_authz: tofu) az
elsőként író Telegram-fiók lesz a tulajdonos; a többi fiókot a bot elutasítja.
Várd meg a Codumentor válaszát.
Hogy más ne foglalhassa le a botodat, mentsd a számszerű Telegram-felhasználói
azonosítódat (a @userinfobot megmondja) a
telegram_allowed_ids nevű felhasználói titokba. A bot ezután csak erre az
azonosítóra válaszol, akkor is, ha valaki más írt neki először. Ha a titokban
nincs érvényes azonosító, a bot mindenkit elutasít.
Szigorúbb védelemhez még az első üzenet előtt állítsd be a
per_user_authz: allowlist módot. Mentsd a számszerű Telegram-felhasználói
azonosítódat a telegram_allowed_ids nevű felhasználói titokba (több azonosítót
vesszővel vagy szóközzel választhatsz el). Az azonosítódat a
@userinfobot segítségével tudhatod meg. Üres
engedélyezési listával senki sem használhatja a botot.
Mindennapi használat és hangüzenetek
Írj a botnak úgy, ahogy a böngészőben tennéd. Minden Telegram-chathez egy
Codumentor-beszélgetés tartozik. Új kérés előtt várd meg a választ: a futó
művelet közben érkező üzeneteket a bot eldobja, és jelzi, hogy még dolgozik.
A böngészőben frissítsd az oldalt a Telegramról érkező beszélgetésfrissítésekhez.
Új beszélgetést a /new paranccsal kezdhetsz; a régi megmarad a böngészőben.
A 30 napig nem használt chat magától új beszélgetést kezd. A /start
parancsra, amelyet a Telegram a bot első megnyitásakor küld, a bot csak
köszön.
Szöveges üzenetekhez nem kell beszédszolgáltatás. Hangüzenetekhez állítsd be a
közös speech: szolgáltatást, és engedélyezd a Telegram voice_reply
beállítását. Kérd a konfigurációs asszisztens segítségét, vagy kövesd az
angol nyelvű hangkonfigurációs referenciát.
Ezután a hangüzenetekre hangos válasz és teljes szöveges válasz is érkezik.
Ha a bot nem válaszol
- Ellenőrizd, hogy a Codumentor fut, a modell működik, és a szerver eléri a Telegramot.
- Várd meg a felderítési időközt.
bot_discovery: startupesetén a token hozzáadása után indítsd újra a szervert. - Ellenőrizd, hogy a Telegram engedélyezve van,
per_usermódban működik, és a titkot a megfelelő Codumentor-fiókhoz, a megfelelő néven mentetted. Közös bothoz más beállítás kell; lásd az angol nyelvű üzemeltetői referenciát. - Hozzáférés megtagadásakor ellenőrizd, nem másik Telegram-fiók küldte-e az első üzenetet, illetve szerepel-e a számszerű azonosítód az engedélyezési listán.
- Ha a User Secrets panel hiányzik a Beállításokból, ellenőrizd, hogy a User Secrets bővítmény engedélyezve van-e.
A saját bot leválasztásához töröld a telegram_bot_token nevű titkot (vagy a
példányodban beállított egyedi nevűt). Az időszakos felderítés a következő
ellenőrzéskor leállítja a botot. Ha a token illetéktelen kezekbe kerül, vond
vissza a @BotFather segítségével, és az újat mentsd a User Secrets panelen.