ym88659208ym87991671
Вход в сценарий по команде Start для Canvas App | Документация для разработчиков

Вход в сценарий по команде Start

Обновлено 3 ноября 2023

Команда /start приходит в сценарий при первом вызове смартапа и обозначает вход в сценарий диалога.

Если вы внесли изменения в проект сценария, запуск команды /start публикует данные изменения. Чтобы протестировать изменения, создайте новый проект сценария. После тестирования вы можете отправить проект с изменениями на модерацию или перенести изменения в текущий проект с помощью импорта.

Команда /start приходит в сценарий в следующих случаях:

  • при запуске тестового виджета;
  • при вызове смартапа из ассистента по имени активации;
  • при выборе смартапа в каталоге.

Если выключить отправку команды /start на запуск голосом, то при запуске в смартап будет отправляться фраза, по которой вы его запустили.

Например, вы запускаете смартап командой Запусти Очевидные советы. Если настройка команды /start отключена и в этом смартапе не настроена обработка незнакомых фраз, то ассистент вместо приветствия будет озвучивать реплику из раздела Ответы ассистента при форс-мажорах.

Выключение отправки команды /start на запуск голосом можно использовать.

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

Например, смартап «Рецепты на каждый день» имеет несколько активационных фраз:

  • Рецепты на каждый день.
  • Супы на каждый день.
  • Каши на каждый день.
  • Пироги на каждый день.
  • Десерты на каждый день.

Необходимо создать глобальные интенты, которые ведут в разные разделы, с командами запуска: Запусти Супы на каждый день, Открой Каши на каждый день. В этом случае по запросу Запусти Супы на каждый день откроется смартап «Рецепты на каждый день» на разделе Супы, а при запуске фразой Открой Каши на каждый день откроется раздел про каши. При этом фраза Запусти Рецепты на каждый день будет вести в главное меню смартапа, т.к. фраза не относится к конкретному разделу.

Graph

По умолчанию отправка команды /start на запуск голосом включена.

Чтобы настроить отправку команды /start:

  1. В левой навигационной панели проекта нажмите Настройки.
  2. На вкладке Базовые настройки измените параметр Отправлять команду /start на запуск голосом.
  3. Сохраните изменения.

По умолчанию, команда /start создает новую сессии внутри смартапа. Вы можете переопределить такое поведение с помощью параметра Возвращаться в контекст на флаг новой сессии ассистента.

Code

По умолчанию отправка команды /start на запуск голосом выключена.

Чтобы включить отправку команды /start на запуск голосом:

  1. Перейдите в раздел НастройкиДополнительно.
  2. Включите параметр Отправлять команду /start на запуск голосом.
  3. Сохраните изменения.

По умолчанию, команда /start инициирует создание новой сессии внутри смартапа. Такое поведение можно переопределить с помощью тега newSession:.

Вместо запуска новой сессии приложения, вы можете возвращать пользователя в контекст последнего диалога.

Примеры обработки команды

Обработка команды /start с помощью регулярного выражения в глобальном теге q:

theme: /

state: Start
q!: $regex</start>
a: Команда старт обработана правильно.
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.