MFA Passport Dashboard bot

Telegram bot with useful tools for the community | Click to visit in real time.

Важливе повідомлення

Станом на 28 Січ 2024

Я помітив деяку активність репозиторія та боту, проте отримав свій паспорт досить давно, це робить підтримку бота не необхідною для мене і здебільшого марна трата ресурсів, отож підтримки рантайму самого бота в тг не буде, але ви завжди можете selfhostʼити чи забрати АПІ та використовувати у своїх проектах.

Станом на 13 Серп 2025

Проект був вдосконалений користувачем mrAlexZT.

• Форк проекту: https://github.com/mrAlexZT/passport-status-bot
• Сам бот у Telegram: @passport_mfa_gov_ua_check_bot

Я рекомендую цю оновлену версію, оскільки вона містить деякі покращення, хоч і не змінює основний функціонал боту. Однак, хочу підкреслити, що я не маю жодного відношення до цього бота, його розробника (mrAlexZT) чи будь-яких подальших\зроблених змін.
Усі питання, пов'язані з роботою бота, його функціоналом або усуненням проблем, слід адресувати безпосередньо автору форку хоч я і є розробником основного функціоналу.

PR завжди відкриті :)

Actual Demo (NOT!)

[Note] Click on image.

Цей бот повідомляє про зміни статусу вашої заявки на passport.mfa.gov.ua та надає можливість відстежувати її статус, оскільки МЗС не забезпечує такої можливості, чим створює незручності.
А саме те що потрібно вручну перевіряти кожного часу коли є можливість, щоб знати що хоч щось змінилося.

На даний момент бот надає можливості:

• Перевіряти статус заявки за простим надсиланням номера заявки, наприклад "1005562"

• Створення власного кабінету:
  • Прив'язка заявки до кабінету
  • Швидкий доступ до статусу заявки через кабінет

• Відстеження змін статусу через підписку (макс 5 підписок.)

• Пуш-повідомлення про зміну статусу заявки (працює тільки для підписок через NFTY.sh)

• Повний перелік команд бота:

ToDo

• Перевірка статусу заявки
• Перевірка статусу заявки через кабінет
• Підписка на зміни статусу заявки
• Підписка на зміни статусу заявки через кабінет
• Push-повідомлення про зміну статусу заявки
• Refactoring
• Docker-compose
• Readme.md
• QR-code scanner
• Analytics
• Rate limit
• Inline buttons
• Improved structure
  • Middlewares

Changelog

CHANGELOG.md

Installation

Clone Repo

git clone https://github.com/denver-code/passport-status-bot
cd passport-status-bot

Environment variables

Rename example.env to .env and fill it with your data.

cp example.env .env
vi .env

Docker-compose

docker-compose up -d

Manual

poetry install
poetry shell
python main.py

Edit in VSCode

poetry install
poetry shell
code .

Then select interpreter in VSCode: Ctrl+Shift+P -> Python: Select Interpreter -> Poetry Environment or something like that.

License

MIT