Чтобы связать Mini App с базой сайта, заведите отдельную подтверждённую связь между Telegram ID и внутренним аккаунтом. Совпадение имени, фотографии или введённого телефона не должно автоматически объединять профили. Для первого испытания возьмите два собственных тестовых аккаунта: так ошибка не затронет заказы клиентов.
Разделите вход в Mini App и право присоединить существующий профиль. Проверка данных Telegram подтверждает внешнюю личность, но сама по себе не доказывает, что ей принадлежит конкретный аккаунт вашего магазина. Вторую сторону связи подтверждают штатным входом на сайт или другим согласованным способом восстановления доступа.
Где заканчиваются данные Telegram
Документация Telegram требует проверять initData на сервере; объект initDataUnsafe нельзя считать доверенным. Актуальность входных данных тоже учитывают при проверке. Здесь не приводится второй вариант алгоритма hash: используйте проверенную реализацию по официальной документации. После проверки работайте с подтверждённым ID через свой слой аккаунтов. Источники сверены 11 октября 2026 года.
Условная запись связи, не запрос к базе:
provider: telegram
external_id: <подтверждённый ID>
account_id: <внутренний аккаунт>
state: confirmed
confirmed_at: <время подтверждения>Набор полей иллюстративный. Если на одной платформе несколько независимых организаций, область связи нужно определить отдельно: глобальный аккаунт или профиль внутри компании. Иначе пользователь, обслуживаемый двумя магазинами, неожиданно получит смешанный кабинет. Не записывайте bot token или полное initData в эту карточку.
Привязка с двумя подтверждёнными сторонами
- Пользователь входит в существующий аккаунт сайта штатным способом.
- Сервер создаёт ограниченную по времени одноразовую операцию связывания.
- В подтверждённой Telegram-сессии пользователь видит, какой профиль предлагается связать.
- Сервер повторно проверяет обе стороны, актуальность операции и отсутствие конфликта.
- Связь фиксируется атомарно; повтор того же подтверждения возвращает её прежний результат.
Это рекомендуемый протокол приложения, а не готовый метод Telegram API. Одноразовую операцию нельзя принимать только по account_id из браузера. Она должна быть привязана к конкретным участникам и намерению. При отмене или истечении срока новый запрос начинается заново. Не обещайте бессрочное подтверждение по старой ссылке из истории чата.
Конфликт нельзя молча перезаписать
| Ситуация | Решение приложения | Что проверить |
|---|---|---|
| Та же пара уже связана | Вернуть существующий результат | Повтор не создаёт новую запись |
| Telegram связан с другим профилем | Остановить связывание | Процедура переноса требует подтверждения |
| Два запроса одновременно | Зафиксировать одну допустимую связь | Ограничения уникальности и транзакция |
| Подтверждение устарело | Предложить начать заново | Нет частично активной записи |
Ограничения уникальности выбирайте по своей модели: допускается ли несколько Telegram-профилей у одного аккаунта и можно ли одному внешнему профилю обслуживать несколько компаний. Прежде чем вводить ограничения в рабочей базе, найдите уже существующие неоднозначные записи. Их нельзя автоматически объединить по последнему времени входа. Сохраните отчёт сопоставления для ручного разбора.
Отвязка не должна оставлять вторую дверь
OWASP рекомендует проверять разрешение на каждом запросе. Для этой интеграции полезно отдельно испытать отзыв связи: старая Mini App-сессия больше не должна читать данные отвязанного профиля. Решение об отзыве локальных сессий должно быть частью протокола, а не зависеть от закрытия окна пользователем.
- Привязать тестовую пару и открыть свой заказ.
- Повторить подтверждение и убедиться, что пара осталась одна.
- Отменить связь и повторить чтение через ранее открытую Mini App.
- Попытаться присоединить второй аккаунт без подтверждения его владельца.
Для проектирования такой связи подготовьте схему аккаунтов, правила нескольких организаций и перечень уже неоднозначных профилей без персональных данных. Это позволит выбрать подтверждение и перенос связи до подключения рабочих заказов. Результат первой версии — доказанное соответствие владельцев, а не просто новая таблица в базе.