Алиса как входящий канал

Чтобы опубликовать навык в канал Алиса:

1. Подключите канал в JAICP.
2. Создайте навык в консоли разработчика.
3. Протестируйте навык.
4. Опубликуйте навык.

Подключение канала

1. В JAICP нажмите Каналы → Входящие → Подключить канал на панели управления.

2. В разделе Голосовые ассистенты выберите Алиса.

3. Укажите настройки:

   • Название — название канала.
   • Токен — токен бота. Оставьте поле пустым, токен будет сгенерирован автоматически.
   • OAuth token — уникальный токен авторизации.
     1. Нажмите Получить OAuth. Вы будете перенаправлены на страницу авторизации в Яндекс.
     2. Авторизуйтесь по Яндекс ID. После авторизации вы будете перенаправлены на страницу с OAuth-токеном.
     3. Скопируйте токен и вставьте его в поле в настройках канала.
   • Ветка — ветка проекта, которую вы хотите развернуть в канал, по умолчанию master. Вы также можете выбрать Git-тег или ввести хеш конкретного коммита.
   • Публикация — способ публикации проекта:
     • Автоматически после каждого сохранения изменений в проект.
     • Вручную с помощью кнопки Опубликовать в строке с описанием канала.
   предупреждение

   Публикацию сценария нужно выполнять перед запуском бота. На этом этапе происходит сборка бота, проверка синтаксиса сценариев и скриптов, а также прохождения тестов.

4. Нажмите Создать.

5. Дождитесь всплывающего окна с результатом публикации.

6. Под названием канала нажмите Получить webhook. Адрес вебхука будет скопирован в буфер обмена.

   • Вебхук понадобится при создании навыка в консоли разработчика.
   • На этот вебхук Алиса будет отправлять все запросы пользователя, когда ваш навык будет активирован.

Создание навыка в консоли разработчика

1. Перейдите в консоль разработчика в Яндекс.Диалогах.
2. Нажмите Создать диалог и выберите Навык в Алисе. Откроется вкладка с настройками навыка.
3. Укажите настройки:
   • Основные настройки: Имя навыка, Активационные имена, Backend, Голос.
     • В поле Backend выберите Webhook URL и вставьте вебхук, полученный на при подключении канала в JAICP. После этого вы сможете проверить навык на вкладке Тестирование в Яндекс.Диалогах.
   • Доступные поверхности: ограничения на устройства и приложения.
   • Публикация в каталоге: Примеры запросов, Имя разработчика, Категория, Описание, Иконка.
4. Нажмите Сохранить.

подсказка

Подробнее о настройках навыка

Тестирование навыка

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

Протестировать навык можно двумя способами:

• На любом устройстве или в приложении Яндекса с того же аккаунта, с которого создается навык.

• В консоли разработчика на вкладке Тестирование.

  предупреждение

  При тестировании в консоли разработчика навык считается постоянно активированным, поэтому проверить работу активационных имен здесь нельзя.

Когда вы удостоверитесь, что навык отвечает правильно, отправьте навык на модерацию.

Публикация навыка

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

После того как модератор одобрит навык, в консоли разработчика станет доступна кнопка Опубликовать. Нажмите на кнопку, чтобы отправить навык на публикацию. Навык появится в каталоге через 5–10 минут, а в результатах поиска по каталогу начнет отображаться в течение суток.