Hibakeresés
Üzenet nem érkezik, kapcsolat-vita, csatlakozás-újraindítás
Telegram hibakeresés
A Telegram-integráció általában működik gond nélkül, de néha problémák felmerülhetnek. Itt a megoldások.
"Nem kapok üzenetet"
Ellenőrzés
- Kapcsolat-státusz: Connect → Telegram → Connected (zöld)?
- Trigger-konfig: Trigger settings → a kérdéses esemény be van kapcsolva?
- Quiet hours: Az esemény idő-szempontból a quiet hours-ben volt? (Akkor késleltetett.)
- Bot-mute: Telegram-felületen a bot-csevegésen
notificationsmuted?
Megoldás
- A toggle-ek ellenőrzése után, ha még mindig nincs üzenet → SuperAdmin support.
"A csatlakozás token lejárt"
Probléma
A Bookinda-felületen generált csatlakozási token 10 perc után lejár.
Megoldás
- Bookinda → Connect → Telegram → újra "Csatlakozz a Telegram-mal" gomb
- Új token + új deep-link
- Új /start a Telegram-ban
"A bot nem reagál a /start parancsra"
Probléma
A bot-felhasználónév rossz, vagy a token-formátum érvénytelen.
Megoldás
- Ellenőrizd a deep-link helyes formátumát:
https://t.me/{botUsername}?start={token} - A {botUsername}: a platform-szintű bot-név (Bookinda-felületen jelölve)
- A {token}: pontosan az, amit a Bookinda generált
- Másold + illeszd, ne gépeld
"A bot új üzenetet küld, de a Telegram-on nem látszik"
Probléma
A Telegram-app notifications-szabályai blokkolnak.
Megoldás
- Telegram → Settings → Notifications → Bot-üzenetek engedélyezve?
- iOS: Settings → Notifications → Telegram → engedélyezve?
- Android: hasonló
"A daily digest nem érkezik"
Probléma
A daily digest off, vagy a tárolt napi-érték már elment ma.
Megoldás
- Connect → Telegram → Settings → Daily digest ON
- A digest minden nap egyszer megy (a beállított időpontban)
- Ha a beállított időpont elment ma, holnap kapod meg
"A trigger-toggle nem mentődik"
Probléma
Browser-cache vagy front-end bug.
Megoldás
- Ctrl+F5 (cache-frissítés)
- Logout + login
- Más böngészőben próbálkozás
"Több userre küldi ugyanazt"
Probléma
Több user csatlakozott, mindegyik trigger be van.
Megoldás
- Per-user filter-elés: csak az Owner kapja az összesítőt, Reception csak az online-foglalást.
- Trigger-konfig finomhangolás.
Audit-trail
A TelegramMessageLog tábla minden küldést rögzít:
- Időbélyeg
- Trigger
- User (chat ID)
- Sikeres / sikertelen (SENT / FAILED)
- Hiba-üzenet (ha sikertelen)
A SuperAdmin-felületen elérhető a log (vita-rendezésre).
Re-connect
Ha a kapcsolat teljesen elromlott:
- Bookinda: Connect → Telegram → user-soron → Disconnect
- Telegram: bot-csevegésben
/stop(opcionális) - Bookinda: új csatlakozás (új token + deep-link + /start)
Telegram-bot lekérdezések
A Telegram-felületen a bot támogatja:
- /status: jelenlegi kapcsolat-státusz, trigger-számok
- /help: parancslista, dokumentáció-link
- /stop: kapcsolat megszüntetés
Mikor használd
Szcenárió 1, vendég-vita Vendég panaszkodik: "Foglalás visszaigazolás nem érkezett". Telegram-üzenet hiánya nem releváns (vendég nem kapja a Telegram-üzenetet, az csak a salon-belső).
Szcenárió 2, kapcsolat-vita A salon-tulajdonos panaszkodik: "Nincs Telegram-üzenetem már 1 hete". Status check → Connection ERROR (token lejárt). Re-connect.
Szcenárió 3, trigger-overload Owner panaszkodik: "Naponta 50 Telegram-üzenetem van". Trigger-konfig finomhangolás (csak fontosabb események).
Szcenárió 4, csoport-csevegés zaj Telegram-csoport recepciós-staff. Csapat panaszkodik: "Túl sok üzenet". Csoport-szintű trigger-szelekció (csak online-foglalás).
Szcenárió 5, daily digest hiba Daily digest időpont 21:00 állítva, de nem jön. Quiet hours 21:30-09:00 → a 21:00-os digest még quiet hours előtt megy. Ellenőrizd a quiet hours kezdő-órát (legyen 22:00 vagy később).
Tippek
- A status-ellenőrzés mindig az első lépés, ne kapkodj.
- A trigger-konfig évente egyszer érdemes finomhangolni, ahogy a salon-stratégia változik.
- A Telegram-app notifications-szabálya gyakori probléma, ellenőrizd elsőre.
- A re-connect veszélytelen, a régi adatok megmaradnak.
- A SuperAdmin-log a vita-rendezés alapja, mindig kérhető.
- A daily digest és quiet hours interakciója: a digest előbbre legyen, mint a quiet hours kezdete.