Codumentor logo Codumentor Enterprise

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

  1. Nyisd meg a @BotFather beszélgetést, és küldd el a /newbot parancsot.
  2. Kövesd az utasításokat: válassz megjelenítési nevet és egyedi, bot végű felhasználónevet.
  3. 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

  1. Jelentkezz be azzal a Codumentor-fiókkal, amelyhez a botot kapcsolni szeretnéd.
  2. 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).
  3. A név legyen telegram_bot_token, az értékhez másold be a tokent. Ha a példányodban más a token_secret_name beállítás, azt a nevet használd.
  4. 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

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.