ym88659208ym87991671
Основные настройки | Документация для разработчиков

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

Обновлено 21 декабря 2022

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

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

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

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

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

В блоке Активационные имена укажите до 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-файла: на установленный лимит, вирусы, целостность архива и т. п. Если файл пройдет проверку, созданный смартап перейдет в статус «Черновик». Это значит, что смартап готов к использованию, но он не будет поддерживать работу с виртуальными ассистентами. Для этого необходимо дополнительно разработать голосовой сценарий.

Хостинг Canvas App

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

При загрузке архива убедитесь, что:

  • размер архива — до 50 Мб,
  • расширение — zip.

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

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

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

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

  • Можно запускать только на поверхностях с экраном.

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

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

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

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

Без авторизации нельзя отправлять push-уведомления и получать персональные данные из сервиса SmartProfile, а также недоступна монетизация.

Поверхности

Поверхности — это приложения и устройства, в которые встроены виртуальные ассистенты Салют и где публикуются смартапы.

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

Приложения

  • Салют — мобильное приложение с сервисами экосистемы Сбера.
  • СберБанк Онлайн — мобильное приложение СберБанка. О публикации смартапов в нем читайте в разделе Публикация в СберБанк Онлайн.
  • Звук — мобильное приложение с аудиоконтентом — музыкой, подкастами, аудиокнигами. Сейчас в Звуке можно публиковать только смартапы, которые работают без авторизации.
  • Sberbank.ru — сайт СберБанка. Сейчас на сайте можно публиковать только смартапы, которые работают без авторизации. Недоступен для азартных игр и временно недоступен для Canvas App.

Устройства

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней