Проблемы и решения по разделу Конструктор приложений

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

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

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

1. Не удается перейти дальше с первого шага

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

Сотрудник нажимает Далее, но мастер не переходит к следующему шагу.

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

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

  • не заполнено название приложения
  • не выбран рабочий тип приложения

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

  • заполнено ли Название приложения
  • выбран ли Mini-app

Что делать

  1. Заполните название приложения.
  2. Убедитесь, что выбран Mini-app.
  3. Повторно нажмите Далее.

2. Мастер закрылся после первого шага и кажется, что все пропало

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

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

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

После первого шага приложение уже создается в системе.

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

  • раздел CMS -> Приложения
  • название приложения
  • код приложения

Что делать

  1. Откройте CMS -> Приложения.
  2. Найдите приложение по названию.
  3. При необходимости вернитесь к дальнейшей настройке уже через карточку приложения или начните новый мастер только если нужен отдельный новый проект.

3. TG-bot token не принимается

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

На шаге Telegram-настройки система показывает, что токен не подходит, и не дает спокойно идти дальше.

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

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

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

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

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

Что делать

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

4. TG-bot user-name введен, но шаг все равно не проходит

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

Имя бота введено, но мастер не считает шаг завершенным.

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

Чаще всего имя введено в неверном формате.

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

  • нет ли в начале символа @
  • относится ли имя к нужному Telegram-боту

Что делать

  1. Уберите символ @, если он есть.
  2. Проверьте правильность имени.
  3. Снова проверьте связку имени и токена.

5. Не принимаются данные подсказок адреса

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

На шаге дополнительных сервисов введены данные подсказок адреса, но система считает их неверными.

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

Чаще всего причина такая:

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

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

  • заполнены ли оба поля
  • нет ли ошибки при копировании

Что делать

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

6. Не принимается ключ карт

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

На шаге дополнительных сервисов система не принимает ключ карт.

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

Обычно ключ:

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

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

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

Что делать

  1. Скопируйте ключ еще раз.
  2. Вставьте его повторно.
  3. Если карты пока не нужны, оставьте поле пустым и продолжите создание приложения.

7. Генерация завершилась, но логотип не появился

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

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

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

Обычно логотип просто не был загружен на втором шаге.

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

  • был ли выбран файл логотипа в мастере
  • сохранился ли он в приложении

Что делать

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

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

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

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

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

Чаще всего в каталоге компании еще мало товаров или они не были готовы на момент запуска мастера.

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

  • есть ли товары в каталоге компании
  • заполнены ли сами карточки товаров

Что делать

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

9. После создания слишком много тестового контента

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

Сотрудник открывает приложение и видит, что в нем много временных баннеров, текстов и страниц.

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

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

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

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

Что делать

  1. Откройте Страницы и Компоненты.
  2. Удалите или перепишите лишние материалы.
  3. Замените тестовые изображения и тексты на реальные.

10. Приложение создано, но не запускается через Telegram

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

Внутри CMS приложение уже создано, но сотрудник не может открыть его обычным Telegram-способом.

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

Чаще всего не завершена финальная настройка в BotFather.

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

  • настроен ли Menu Button
  • настроен ли Main App
  • вставлена ли правильная ссылка запуска
  • используется ли правильный бот

Что делать

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