Skip to content

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

TypeDescription
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_pass

The bot asks for the pass type, then for the guest’s full name:

  1. Type — One-time / Temporary / Permanent.
  2. Expiration date — Temporary only (DD.MM.YYYY or in N days).
  3. Full name — up to 200 characters.
  4. Property — your plot the guest is linked to.
  5. Purpose of visit — optional (/skip).
  6. 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 Ivanovich
Category: Guest
Type: One-time
🔑 Access code: 482913
Property: 42
Valid 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_passes next 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.