В Telegram Mini App клиент может видеть свои заявки, документы, записи или состояние услуги. Польза такого кабинета зависит от двух вещей: актуальности данных и правильного ограничения доступа.
До разработки нужно определить, кому принадлежит каждая запись, какие действия доступны клиенту и какая система подтверждает результат. Экран кабинета — только видимая часть этой работы.
Выберите задачи первой версии
Начните с нескольких действий, которые клиенту действительно нужны: посмотреть статус обращения, открыть свой документ, изменить запись или передать недостающую информацию.
Для каждого экрана укажите источник данных, возможность изменения и ответственного за актуальность. Не переносите внутреннюю CRM целиком в клиентский интерфейс: служебные комментарии, оценки менеджеров и сведения других клиентов не относятся к кабинету.
Если пользователю достаточно диалога или нескольких уведомлений, сложный интерфейс может быть лишним. Выбор формата разобран в статье о том, когда нужен Telegram-бот, Mini App или сайт.
Подтвердите вход через Telegram на сервере
Mini App получает данные запуска, но сервер должен проверить их до использования для доступа к кабинету. Telegram прямо предупреждает, что данным initDataUnsafe нельзя доверять; проверку выполняют на основе initData. Документация также описывает проверку времени auth_date, чтобы ограничивать использование устаревших данных. Документация Telegram Mini Apps.
Не открывайте личные сведения только потому, что интерфейс передал идентификатор пользователя или номер заказа. При отсутствии подтверждённого входа кабинет должен показывать безопасное состояние без клиентских данных.
Токен бота и ключи CRM должны оставаться на серверной стороне. Для браузерного интерфейса задайте отдельный способ обращения к серверу и правила срока действия сессии.
Свяжите пользователя Telegram с клиентом в CRM
Подтверждение пользователя Telegram ещё не определяет, какую карточку клиента он вправе видеть. Для связи нужен отдельный процесс: например, подтверждение доступа через уже проверенный контакт клиента или приглашение с ограниченным сроком действия.
Не выбирайте карточку по совпадению имени или по введённому пользователем email без проверки. У корпоративного клиента может быть несколько сотрудников, а у одного человека — доступ к нескольким договорам.
Опишите роли: владелец кабинета, уполномоченный сотрудник, представитель с ограниченными правами. Укажите, кто назначает и отзывает доступ и что происходит при смене ответственного со стороны клиента. Эти условия включают в техническое задание на Telegram-бота и связанные сценарии.
Проверяйте права для каждого действия и документа
Скрытая кнопка не является ограничением доступа. Сервер должен проверять право на конкретную запись при просмотре, скачивании и изменении данных.
Условный пример. Пользователь вправе видеть только заявки своей компании. Если он подставляет номер чужой заявки в запрос, сервер не выдаёт её содержимое. То же правило действует для документов и действий, которые можно вызвать без перехода через меню.
Разделите право читать и право менять сведения. Предусмотрите отзыв доступа, смену ролей и проверку ранее выданных ссылок на документы. В журналах сохраняйте необходимые действия и результат проверки, не записывая лишние персональные сведения или секреты.
Согласуйте обновление данных и поведение при сбоях
Определите, где находится актуальная запись и как кабинет получает изменения. Если данные обновляются с задержкой, покажите время последнего обновления и не выдавайте старый статус за подтверждённый текущий.
При отправке изменения в CRM различайте состояния «получено», «обрабатывается» и «подтверждено». Повторное нажатие не должно создавать несколько одинаковых заявок. Если CRM недоступна, клиенту нужен понятный статус и следующий шаг.
Назначьте правила разрешения конфликтов: что произойдёт, если клиент и менеджер одновременно изменили запись. Проверьте также отказ интеграции, отзыв доступа и повторный вход по принципам приёмки Telegram-бота перед запуском.
Карта личного кабинета до разработки
- Какие экраны и действия входят в первую версию?
- Откуда берутся данные и когда они обновляются?
- Как проверяются вход и срок действия сессии?
- Как пользователь связывается с клиентом в CRM?
- Какие роли дают право читать, скачивать и менять записи?
- Как назначается и отзывается доступ?
- Что происходит при сбое, повторном действии и конфликте изменений?
- Кто проверяет разграничение доступа и отвечает за сопровождение?
В предложении по Telegram-ботам и Mini Apps можно обсудить клиентские экраны, интеграцию с CRM и серверную логику. Начинать оценку стоит с этой карты: именно она задаёт объём работы и проверяемые условия готовности кабинета.