Person Pass (/person_pass)
Person Pass
The /person_pass command creates a person pass — a pass for a person (not a vehicle). A resident (resident) can create guest passes only. An administrator (admin, super_admin) can create any category.
What is the 6-digit code
When a pass is created, the system generates a random 6-digit access code (e.g. 482913). This is the main artifact: give it to the guest, and security verifies entry by code via /verify_person. Name search is the fallback.
Pass types
| Type | Description |
|---|---|
One-time (one_time) | Single entry. Burned on first check (status used). Valid until the end of the current day. |
Temporary (temporary) | Valid until a chosen date. Multiple entries. |
Permanent (permanent) | Valid until 31 December of the current year. Multiple entries. |
Creation flow (resident)
/person_passThe bot asks for the pass type, then for the guest’s full name:
- Type — One-time / Temporary / Permanent.
- Expiration date — Temporary only (
DD.MM.YYYYorin N days). - Full name — up to 200 characters.
- Property — your plot the guest is linked to.
- Purpose of visit — optional (
/skip). - Confirmation — a summary and a “Create pass” button.
Example
🪪 Guest pass
Select pass type:[1️⃣ One-time] [🗓 Temporary][📅 Permanent][❌ Cancel]After confirmation the bot shows the code:
✅ Person pass created
Name: Ivanov Ivan IvanovichCategory: GuestType: One-time🔑 Access code: 482913Property: 42Valid until: 05.10.2026
Give the guest the 6-digit code for the checkpoint.Important: the code is shown only at creation. Give it to the guest right away.
Pass QR code
On creation the bot sends a QR image of the pass — show it (or forward it) to your guest so security can scan it via the Telegram Mini App (the security “🔍 Проверка QR” button).
- What’s inside the QR: only the pass identifier (
pp_<token>), no name or code. Only a SHA-256 hash of the token is stored in the database. - “🔁 QR” button — regenerate the QR (e.g. if the old one is compromised or lost). The old QR stops working immediately.
- The “🔁 QR” button is also available in
/my_passesnext to your person passes.
🔁 Person pass QR code. Show it to security for scanning.[🔁 QR]If the QR has already been printed and handed over, regenerating it makes the printed copy invalid.
Cancel
At any step press ❌ Cancel.