Основные настройки


Основные настройки — это вкладка в разделе Параметры, где вы можете указать базовую информацию о смартапе.

Название смартапа

В поле Название смартапа укажите слово или фразу, которые отражают основную функцию смартапа. По названию пользователь сможет найти смартап в каталоге и запустить его, например, командой «Включи [Имя смартапа]».

Название должно соответствовать требованиям. Оно может состоять из нескольких слов. Максимальная длина — 50 символов. Имя смартапа может состоять из названия бренда, если вы представляете бренд и можете это подтвердить.

Активационные имена

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

Пример команды для запуска смартапа: «Включи [активационное имя]». Все команды запуска представлены в разделе Запуск и остановка смартапа.

В активационном имени можно указать:

  • Дополнительный вариант написания или произнесения названия. Например, чтобы смартап «Gray star 6» распознавался корректно, можно добавить активационные имена - «Грэй стар 6», «Серый шар».
  • Сокращенную или полную форму названия смартапа. Например, для смартапа «Интересные факты о Санкт-Петербурге» можно задать активационное имя «Интересные факты о Питере».
  • Аббревиатуру названия смартапа. Например, для смартапа «Московская студия рисования» можно указать активационное имя «МСР». Если используете аббревиатуру, добавьте ее расшифровку в описание смартапа.

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

Webhook смартапа

Вебхук — это ссылка, по которой платформа будет вызывать ваш смартап. По ссылке должен размещаться бэкенд вашего приложения. Он производит вычисления для определенных шагов в сценарии и возвращает переменные, с которыми смартап работает при выполнении сценария.

Выберите в поле Webhook смартапа инструмент, в котором вы создаете бэкенд: SmartApp Graph, SmartApp Code или SmartApp API. Если вы создаете смартап без бэкенда (например, Native App), выберите опцию «Не требуется».


Webhook для SmartApp Graph и SmartApp Code

Если ваш бэкенд создан в SmartApp Graph или SmartApp Code, выберите в поле проект, который необходимо связать с настройками смартапа. Затем выберите статус проекта.


Webhook для SmartApp API

При выборе инструмента SmartApp API заполните поле URL. Для заполнения поля используйте:

  • только доменное имя;
  • протокол https;
  • доменные зоны на кириллице или латинице (ru, com, рф и т. д.).

Вы можете разместить вебхук на собственном сервере или на сервере SmartMarket. Ваш сервер должен быть настроен на прием POST-запросов. Для отладки вы также можете разместить вебхук локально на компьютере.

Хостинг Native App

Хостинг Native App — это поле для загрузки Android-приложения. Настройка доступна только для смартапа типа Native App. Требования к файлу:

  • Размер до 100 Мб.
  • Формат apk.
  • Наличие подписи. Правила генерации подписи читайте в разделе Native App.

После загрузки начинается проверка apk-файла: на установленный лимит, вирусы, целостность архива и т. п. Если файл пройдет проверку, созданный смартап перейдет в статус «Черновик». Это значит, что смартап готов к использованию, но он не будет поддерживать работу с виртуальными ассистентами. Для этого необходимо дополнительно разработать голосовой сценарий.

Хостинг Canvas App

В поле Хостинг Canvas App вы можете добавить веб-приложение со статичным контентом. Загрузите в поле архив или укажите cсылку на веб-приложение. Настройка доступна только для смартапа типа Canvas App.

При загрузке архива убедитесь, что размер файла не более 50 Мб и формат файла — zip. При вводе ссылки на веб-приложение убедитесь, что она указана с протоколом https.

Приложение должно использовать действительный SSL-сертификат, подписанный доверенным центром сертификации. Для локального тестирования и отладки веб-приложений используйте Assistant Client.

Иконка Native App

Загрузите в это поле иконку для Native App, которая будет отображаться на устройстве пользователя в разделе установленных приложений. Обратите внимание, что эта иконка не будет использоваться для каталога SmartMarket.

Требования к иконке Native App:

  • Размер не более 200 Кб.
  • Формат файла jpg или png.
  • Размер изображения 550×300 px.

Условия запуска

Укажите дополнительные условия запуска вашего смартапа:

  • Можно запускать на устройствах без экрана.

Выберите, если у вашего смартапа есть голосовой сценарий и большинство функций могут работать без экрана. В безэкранном режиме нельзя запрашивать согласие на использование персональных данных. Также не рекомендуется отправлять push-уведомления на устройство, т. к. пользователь может не прочитать их. Подробнее читайте в разделе Проектирование для устройств без экрана.

  • Можно запускать в сессиях без авторизации.

Выберите, если ваш смартап не требует авторизации пользователя и не запускает другой смартап, который требует авторизации. В этом режиме нельзя отправлять push-уведомления и получать персональные данные из сервиса SmartProfile, а также недоступна монетизация.

Поверхности

Это мобильные приложения и устройства, на которых может быть доступен ваш опубликованный смартап. Например: SberBox, SberPortal, СберБанк Онлайн и др.

Перечень поверхностей, на которых будет доступен смартап, зависит от его типа и условий запуска. Например, Native App может быть доступен только на умных устройствах Сбера. Подробнее читайте в разделе Выбор типа смартапа.