Основные настройки — это вкладка в разделе Параметры, где вы можете указать базовую информацию о смартапе.
Название смартапа
В поле Название смартапа укажите слово или фразу, которые отражают основную функцию приложения и будут отображаться на странице приложения в каталоге. По названию пользователь сможет найти приложение в каталоге и запустить его, например, командой «Включи [название смартапа]».
Название должно соответствовать требованиям. Оно может состоять из нескольких слов. Максимальная длина — 50 символов. Вы можете указать название бренда, если вы представляете бренд и можете это подтвердить.
Короткое название смартапа
В поле Короткое название смартапа укажите слово или фразу, которые будут отображаться в виджетах лончера устройств и в виджетах в каталоге приложений. Может совпадать с полным названием.
Короткое название должно соответствовать требованиям и быть лаконичным и понятным без пояснений. Например, «Окко: кино, сериалы, спорт, ТВ» сократите до «Окко». А первый вариант можно использовать в качестве полного названия.
Максимальная длина — 36 символов.
Активационные имена
В блоке Активационные имена укажите до 5 названий, по которым пользователи смогут запустить смартап. По умолчанию активационное имя совпадает с названием смартапа.
Пример команды для запуска смартапа: «Включи [активационное имя]». Все команды запуска представлены в разделе Запуск и остановка смартапа.
В активационном имени можно указать:
- Дополнительный вариант написания или произнесения названия. Например, чтобы смартап «Gray star 6» распознавался корректно, можно добавить активационные имена - «Грэй стар 6», «Серая звезда».
- Сокращенную или полную форму названия смартапа. Например, для смартапа «Интересные факты о Санкт-Петербурге» можно задать активационное имя «Интересные факты о Питере».
Активационные имена должны соответствовать требованиям к названию смартапа.
Сценарий смартапа
Сценарий — часть смартапа, ответственная за голосовое управление. В сценарии запрограммировано поведение приложения в различных ситуациях. Сценарий смартапа работает с помощью вебхуков: при обращении пользователя, ассистент передает HTTP-запросы в сценарий и получает от него ответы.
Некоторым смартапам, например, Native App или HTML5-играм, голосовое управление не нужно. В таких случаях разрабатывать сценарий не требуется.
В раскрывающемся списке Тип сценария нужно выбрать инструмент, с помощью которого создан сценарий: Graph, Code или SmartApp API. Если вы создаете смартап без сценария (например, Native App), выберите пункт Не требуется. Для смартапов типа Canvas App и Native App также доступен пункт Готовый сценарий, который позволяет подключить базовый сценарий обработки голоса.
Если сценарий разрабатывается в Graph или Code, в списке Сценарий выберите или создайте проект. Затем выберите версию проекта.
Если сценарий разрабатывается с помощью SmartApp API, в поле Внешняя ссылка укажите адрес сервера, который будет обрабатывать HTTP-запросы.
При выборе инструмента SmartApp API в поле Внешняя ссылка укажите адрес сервера, который будет обрабатывать HTTP-запросы. Для заполнения поля используйте:
- только доменное имя;
- протокол https;
- доменные зоны на кириллице или латинице (ru, com, рф и т. д.).
Вы можете разместить вебхук на собственном сервере или на нашем. Ваш сервер должен быть настроен на прием POST-запросов. Для отладки вы также можете разместить вебхук локально на компьютере.
Хостинг Native App
Хостинг Native App — это поле для загрузки Android-приложения. Настройка доступна только для смартапа типа Native App. Требования к файлу:
- Размер до 100 Мб.
- Формат apk.
- Наличие подписи. Правила генерации подписи читайте в разделе Native App.
После загрузки начинается проверка apk-файла: на установленный лимит, вирусы, целостность архива и т. п. Если файл пройдет проверку, созданный смартап перейдет в статус «Черновик». Это значит, что смартап готов к использованию, но он не будет поддерживать работу с виртуальным ассистентом. Для этого необходимо дополнительно разработать голосовой сценарий.
Хостинг фронтенда
В поле Хостинг фронтенда вы можете добавить веб-приложение со статичным контентом. Загрузите в поле архив или укажите cсылку на веб-приложение. Настройка доступна только для смартапа типа Canvas App.
При загрузке архива убедитесь, что:
- размер архива — до 50 Мб,
- расширение — zip.
При вводе ссылки на веб-приложение убедитесь, что она указана с протоколом https.
Приложение должно использовать действительный SSL-сертификат, подписанный доверенным центром сертификации. Для локального тестирования и отладки веб-приложений используйте Assistant Client.
Условия запуска
Укажите дополнительные условия запуска вашего смартапа:
- Можно запускать только на поверхностях с экраном.
Выберите, если у вашего смартапа нет голосового сценария и большинство функций не могут работать без экрана.
В безэкранном режиме нельзя запрашивать согласие на использование персональных данных. Также не рекомендуется отправлять push-уведомления на устройство, т. к. пользователь может не прочитать их. Подробнее читайте в разделе Проектирование для устройств без экрана.
- Можно запускать только в сессиях с авторизацией.
Выберите, если ваш смартап требует авторизации пользователя или запускает другой смартап, который требует авторизации.
Без авторизации нельзя отправлять push-уведомления и получать персональные данные из сервиса SmartProfile, а также недоступна монетизация.
Поверхности
Поверхности — это приложения и устройства, в которые встроен виртуальный ассистент Салют и где публикуются смартапы.
Перечень поверхностей, на которых будет доступен смартап, зависит от его типа и условий запуска. Например, Native App может быть доступен только на умных устройствах Sber с экраном. Подробнее читайте в разделе Выбор типа смартапа.
Приложения
- Салют — мобильное приложение с сервисами экосистемы Сбера.
- СберБанк Онлайн — мобильное приложение СберБанка. О публикации смартапов в нем читайте в разделе Публикация в СберБанк Онлайн.
- Звук — мобильное приложение с аудиоконтентом — музыкой, подкастами, аудиокнигами. Сейчас в Звуке можно публиковать только смартапы, которые работают без авторизации.
- Sberbank.ru — сайт СберБанка. Сейчас на сайте можно публиковать только смартапы, которые работают без авторизации. Недоступен для азартных игр и временно недоступен для Canvas App.
Устройства
- Салют ТВ — платформа для телевизора от Сбера. Подробнее читайте в разделах Характеристики и Проектирование для больших экранов.
- SberBox — цифровая ТВ-приставка с пультом дистанционного управления. Подробнее читайте в разделах Характеристики и Проектирование для больших экранов.
- SberBoom — большая умная колонка. Характеристики SberBoom.
- SberBoom Mini — маленькая умная колонка. Характеристики SberBoom Mini.
- SberBox Top — ТВ-медиацентр с умной камерой. Подробнее читайте в разделах Характеристики и Проектирование для больших экранов.
- SberPortal — мультимедийный смарт-дисплей. Подробнее читайте в разделах Характеристики и Проектирование для SberPortal.
- SberBox Time — устройство с функциями механических часов, умной колонки и ТВ-приставки. Характеристики SberBox Time.
- Huawei Vision — умный экран от Huawei. Возможен запуск смартапов в сессиях без авторизации. Подробнее читайте в разделе Проектирование для больших экранов.