Проблемы и решения по разделу Приложения

Для чего нужен этот документ

Этот документ нужен для ситуаций, когда приложение ведет себя не так, как ожидает сотрудник. Здесь собраны типовые симптомы и практический порядок разбора:

  • что именно выглядит как проблема
  • почему это обычно происходит
  • что проверить в интерфейсе
  • что делать дальше

Связанные документы по разделу:

Открывайте этот документ, если нужно:

  • быстро понять, почему приложение не сохраняется или не активируется
  • разобрать проблему с Telegram-данными, темой, навигацией или платежной привязкой
  • дать сотруднику короткий диагностический маршрут вместо чтения всей инструкции

Если нужен полный обзор раздела, вернитесь к:

Если нужен короткий ответ на типовой вопрос, открывайте:

Если проблема уже понятна и нужен рабочий маршрут, открывайте:

1. Приложение не сохраняется

Как выглядит проблема

Сотрудник заполнил карточку приложения, нажал Сохранить, но изменения не проходят или форма остается в нерабочем состоянии.

Почему так бывает

Чаще всего причина одна из следующих:

  • не заполнены обязательные поля
  • Telegram user-name введен в неверном формате
  • в конфигурации есть противоречивые или пустые обязательные поля
  • в карточке есть невалидные значения theme-настроек

Что проверить

  • заполнено ли Наименование
  • заполнен ли тип приложения
  • корректен ли TG-bot user-name
  • нет ли явных пустых обязательных полей в конфигурации
  • не осталась ли карточка в промежуточном черновом состоянии после неполного редактирования

Что делать

  1. Вернитесь в верхнюю часть карточки.
  2. Проверьте базовые поля.
  3. Проверьте активную вкладку конфигурации.
  4. Убедитесь, что поля Light/Dark, имя конфигурации и ключевые theme-значения заполнены корректно.
  5. Повторите сохранение.

2. Приложение не удается активировать

Как выглядит проблема

Сотрудник включает Активировано, но сохранить карточку в активном состоянии не получается.

Почему так бывает

Частая причина - компания достигла лимита активных приложений.

Что проверить

  • сколько приложений компании уже активно
  • действительно ли нужно активировать еще одно приложение
  • нельзя ли сначала деактивировать старое или тестовое приложение

Что делать

  1. Проверьте текущие рабочие приложения компании.
  2. Определите, какие из них уже не нужны как активные.
  3. Деактивируйте лишние активные приложения.
  4. После этого повторите активацию нужного приложения.
Проверка активности приложения и лимита
На скриншоте: карточка приложения с переключателем Активировано и пример ситуации, когда нужно проверить лимит активных приложений.

3. TG-bot token не проходит проверку

Как выглядит проблема

Токен введен, но система сообщает, что он невалиден, либо мастер не дает перейти дальше.

Почему так бывает

Обычно причина одна из следующих:

  • токен скопирован не полностью
  • токен относится не к тому боту
  • в поле попал лишний символ или пробел
  • бот был создан некорректно или данные перепутаны

Что проверить

  • скопирован ли токен целиком
  • относится ли он именно к нужному Telegram-боту
  • нет ли лишних пробелов в начале или конце строки

Что делать

  1. Откройте Telegram и снова получите токен у BotFather.
  2. Скопируйте токен заново.
  3. Вставьте его в карточку без лишних символов.
  4. Повторите сохранение или повторите шаг мастера.

4. TG-bot user-name заполнен, но приложение все равно работает не так, как ожидали

Как выглядит проблема

Пользователь ожидает, что приложение связано с одним ботом, а фактически команда использует другой.

Почему так бывает

Чаще всего путают:

  • имя бота
  • токен бота
  • старого и нового бота после миграции

Что проверить

  • совпадает ли TG-bot user-name с реальным рабочим ботом
  • относится ли токен к тому же самому боту
  • не остались ли у команды старые инструкции и старая ссылка

Что делать

Сверьте пару:

  • TG-bot user-name
  • TG-bot token

Они должны относиться к одному и тому же Telegram-боту.

5. После смены Telegram-бота приложение стало работать нестабильно

Как выглядит проблема

После замены токена или user-name старые сценарии перестали работать так, как раньше.

Почему так бывает

Смена Telegram-токена - это полноценная смена Telegram-привязки приложения. После этого системе нужно заново обновить связь приложения с ботом.

Что проверить

  • действительно ли новый бот уже должен быть рабочим
  • не пытается ли команда запускать приложение через старого бота
  • сохранена ли карточка после смены токена

Что делать

  1. Убедитесь, что карточка сохранена.
  2. Проверьте запуск приложения именно через нового бота.
  3. Удалите из внутренних инструкций старые ссылки и старые Telegram-данные.
  4. Если проблема сохраняется, временно не меняйте дополнительные параметры одновременно со сменой токена, чтобы не смешивать причины.

6. Приложение открывается, но выглядит не так, как ожидали

Как выглядит проблема

Витрина открывается, но:

  • цвета не те
  • шрифты не те
  • интерфейс слишком крупный или слишком мелкий
  • тема выглядит “сломано”

Почему так бывает

Обычно причина одна из следующих:

  • неправильно настроена активная конфигурация
  • перепутаны Light и Dark
  • в карточке применены неполные theme-наборы
  • включено влияние Telegram theme params, и они переопределяют цвета

Что проверить

  • активную конфигурацию
  • варианты Light/Dark
  • цветовую палитру
  • rootFontSize
  • включен ли флаг Бот может переопределять свойства

Что делать

  1. Откройте блок Конфигурация.
  2. Проверьте настройки светлой и темной темы.
  3. Если нужен строго фирменный стиль, временно отключите Бот может переопределять свойства.
  4. Сохраните карточку.
  5. Повторно проверьте вид витрины.

7. Приложение выглядит нормально на одном устройстве, но плохо на другом

Как выглядит проблема

На одном экране интерфейс выглядит аккуратно, а на другом:

  • слишком плотный
  • слишком крупный
  • плохо читается
  • “разъезжается” по размеру

Почему так бывает

Чаще всего проблема в:

  • rootFontSize
  • недостаточно продуманных breakpoints
  • слишком грубых theme-настройках без адаптации под диапазоны экранов

Что проверить

  • rootFontSize
  • правила Min screen width / Max screen width
  • свойства, заданные внутри breakpoints

Что делать

  1. Откройте нужную конфигурацию.
  2. Проверьте Значения по умолчанию.
  3. Пересмотрите rootFontSize.
  4. Добавьте или скорректируйте правила для разных экранов.
  5. Повторно проверьте приложение в предпросмотре и на устройстве.

8. Навигация внутри приложения ведет не туда

Как выглядит проблема

Переходы в каталог, корзину, оформление заказа или профиль ведут не на тот экран или вообще работают некорректно.

Почему так бывает

Обычно причина связана с тем, что фактические страницы и компоненты приложения не соответствуют ожидаемому клиентскому сценарию.

Например:

  • нужная CMS-страница не создана
  • страница есть, но в ней нет нужного торгового блока
  • в приложении проверяют не ту витрину или не ту конфигурацию

Что проверить

  • нужные страницы в разделе CMS -> Страницы
  • нужные блоки в разделе CMS -> Компоненты
  • выбранное приложение в Редакторе приложений
  • фактический сценарий в предпросмотре

Что делать

  1. Откройте раздел CMS -> Страницы и убедитесь, что нужные экраны существуют.
  2. Проверьте, что на страницах добавлены нужные компоненты.
  3. Сохраните изменения.
  4. Откройте приложение в Редакторе приложений.
  5. Повторно проверьте навигацию и торговые сценарии.

9. Не удается привязать платежный аккаунт

Как выглядит проблема

Пользователь выбирает платежный аккаунт, но сохранить привязку не удается.

Почему так бывает

Обычно причина в том, что выбранный аккаунт не принадлежит текущей компании или сотрудник пытается привязать не ту запись.

Что проверить

  • принадлежит ли аккаунт текущей компании
  • действительно ли выбран нужный платежный аккаунт

Что делать

Выберите только тот платежный аккаунт, который принадлежит текущей компании и реально должен использоваться именно для этого приложения.

10. В приложении не работают карты или географические сценарии

Как выглядит проблема

Карты не отображаются или сценарии с географией ведут себя неправильно.

Почему так бывает

Часто причина в:

  • невалидном ключе карт
  • пустом ключе карт
  • ошибке в самом значении ключа

Что проверить

  • заполнено ли поле API ключ карт
  • корректен ли ключ
  • не был ли он заменен на тестовый, старый или неполный

Что делать

  1. Получите рабочий ключ заново.
  2. Вставьте его в карточку приложения.
  3. Сохраните изменения.
  4. Повторно проверьте сценарий с картой.

11. Подсказки адреса не работают

Как выглядит проблема

При оформлении заказа или в похожих сценариях нет адресных подсказок, либо они работают неправильно.

Почему так бывает

Обычно причина одна из следующих:

  • не заполнен API ключ подсказок
  • не заполнен Secret
  • заполнено только одно поле из пары
  • указаны невалидные данные

Что проверить

  • заполнены ли оба поля
  • относятся ли они к одному и тому же рабочему аккаунту

Что делать

  1. Проверьте оба поля.
  2. Если заполнено только одно, заполните второе.
  3. Если данные вызывают сомнение, получите их заново и сохраните карточку.

12. После обычного удаления приложение пропало, но команда ожидала другой результат

Как выглядит проблема

Пользователь удалил приложение и понял, что ожидал не просто удаления карточки, а другой глубины очистки, либо наоборот ожидал более мягкого результата.

Почему так бывает

Причина чаще всего организационная: перед удалением не было четкого понимания разницы между:

  • обычным удалением
  • глубоким удалением

Что проверить

  • какое именно удаление было запущено
  • чего именно ожидала команда
  • были ли нужны связанные страницы и компоненты дальше

Что делать

Перед любым новым удалением всегда сначала определяйте цель:

  • убрать только запись приложения
  • или полностью убрать весь связанный след

Не запускайте удаление, пока это не согласовано внутри команды.

13. Пользователь боится запускать Глубокое удаление, потому что не понимает последствия

Как выглядит проблема

Кнопка есть, но сотрудник не уверен, можно ли ее использовать без риска.

Почему это нормально

Потому что Глубокое удаление действительно опасно и должно вызывать осторожность.

Что проверить перед действием

  • используются ли компоненты приложения где-то еще
  • нужны ли еще его страницы
  • важны ли связанные корзины и списки избранного
  • подтверждено ли решение владельцем или ответственным менеджером

Что делать

Если есть хотя бы одно серьезное сомнение, не запускайте глубокое удаление сразу.

Сначала:

  1. деактивируйте приложение
  2. проверьте связанные сущности
  3. согласуйте последствия

Только после этого принимайте окончательное решение.