ym88659208ym87991671
Основные настройки | Документация SmartMarket
Skip to main content

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

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

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

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

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

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

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

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

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

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

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

Webhook смартапа

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

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


Webhook для Graph и Code

Если ваш бэкенд создан в Graph или 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.

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

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

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

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

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

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

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

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

Поверхности

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

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

Приложения

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

Устройства

Обновлено 22 июля 2022

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

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