Csatlakozás (token-alapú flow)
10 perces csatlakozás, deep-link, /start parancs
Telegram-csatlakozás
A Telegram-csatlakozás 5 perces folyamat. Token-alapú deep-link: a Bookinda generál egy tokent, te a Telegram-ban a /start parancsban beillesztesz.
Lépés 1: Csatlakozás indítás Bookinda-ban
- Bookinda → Connect → Telegram
- + Csatlakozz a Telegram-mal gomb
- A Bookinda generál egy 10 percig érvényes csatlakozási tokent
- Megjelenik a deep-link:
https://t.me/{botUsername}?start={token}
Lépés 2: Telegram megnyitás
- Klikk a deep-link-re (vagy másold + nyisd a Telegram-ban)
- A Telegram megnyitja a Bookinda-bot-ot
- Start gomb a Telegram-ban (vagy
/start {token}parancs auto-küldés)
Lépés 3: Bot-üzenet
A bot válasza:
✅ Sikeres csatlakozás a Salon X tenant-hoz!
Elérhető parancsok:
/status — kapcsolat-státusz
/stop — kapcsolat-leállítás
/help — súgó
Kapni fogod az értesítéseket a beállított trigger-ek szerint.
Lépés 4: Bookinda visszairányítás
A Bookinda-felületen automatikusan láthatod:
- Connect → Telegram → Connected státusz
- Telegram-felhasználó-info (név, chat ID)
- Trigger-konfiguráció elérhető
Token-élettartam
A csatlakozási token 10 percig érvényes. Ha lejár:
- A Bookinda-ban újabb token generálható
- Új deep-link
- Új /start
Több user / tenant
Egyetlen tenant-hoz több Telegram-felhasználó csatlakozhat:
- Owner + Manager + Reception mind külön-külön
- Mindegyik saját trigger-konfig
- Mindegyik saját csendes-órák
A bot egyetlen, de per-user szinkronizáció.
Csapat-csoport (advanced)
Telegram-csoportba is csatolható a bot (a /start parancsot a csoportban add ki):
- A csoport minden tagja kapja az üzenetet
- Recepció-csoport esetén hasznos
- A bot moderátor-jogot igényelhet a csoportban
Disconnect
Bookinda-felületen
Connect → Telegram → user-soron → Disconnect gomb. A csatlakozás megszűnik, többé nem küld üzenet.
Telegram-ban
A bot-csevegésben /stop parancs. Ugyanaz az eredmény.
Bot-parancsok
A bot 4 parancsot támogat:
- /start {token}: csatlakozás (egyszer használt)
- /status: jelenlegi kapcsolat-státusz, trigger-számok
- /stop: kapcsolat-leállítás
- /help: parancslista + linkek
Mikor használd
Szcenárió 1, salon-tulajdonos első csatlakozás Owner: Connect → Telegram → gomb → deep-link → Telegram megnyit → Start → kész. 1 perc.
Szcenárió 2, recepció-csapat csatlakozás 3 recepciós külön-külön csatolja. Mindegyik saját trigger-választás (pl. Reception 1 csak online-foglalások, Reception 2 minden).
Szcenárió 3, csoport-csatolás Telegram-csoport "Salon X Recepció". Bot-meghívás csoportba. /start a csoportban. Csoport-tagok mind kapják az üzeneteket.
Szcenárió 4, csatlakozás-vita A csatlakozás-token lejárt. Új token generálás Bookinda-ban. Új deep-link.
Szcenárió 5, leiratkozás munkaviszony-vége esetén Munkatárs távozik a salonból. Bookinda-ban Disconnect → többé nem kap üzenetet a salon-eseményekről.
Tippek
- A 10 perces token-élettartam szigorú, ne hagyd elveszni.
- A deep-link mobile-on klikkelve auto-megnyit Telegram-ot, desktop-on URL-másoláshoz hosszabb.
- A több-user támogatott, ne aggódj a csapat-tagok csatlakoztatásával.
- A csoport-csatolás haladó funkció, alaposan próbáld először 1-2 csoporttal.
- A
/stopparancs Telegram-oldalról is kifehérít, opt-out-respektáló. - A bot-felhasználónév platform-szintű (
@bookinda_notifications_botvagy hasonló).
