Алиса как входящий канал
Чтобы подключить Алису как входящий канал:
Подключение к каналу
Нажмите на панели управления Каналы > Входящие > Создать канал. В разделе Голосовые Ассистенты выберите Алиса.
Заполните поля:
- Название — здесь вы можете сменить имя канала на удобное для вас.
- Токен — оставьте пустым, токен генерируется автоматически.
- OAuth token — нажмите Получить OAuth. Откроется страница Яндекса, на которой нужно выдать разрешение и получить токен. Скопируйте его и вставьте в поле.
- Ветка — укажите ветку проекта, которую хотите развернуть в канал, по умолчанию
master. - Публикация — автоматически (после каждого сохранения внесенных в проект изменений) или вручную (с помощью кнопки Опубликовать в строке с описанием канала).
Обратите внимание на переключатель Публикация. Публикацию или деплой сценария нужно выполнять перед запуском чатбота. На этом этапе происходит сборка чатбота, проверка синтаксиса сценариев и скриптов, а также проверка прохождения тестов.
Нажмите Создать.
Перед тем как зарегистрировать навык, необходимо скопировать вебхук, на который Алиса будет отправлять все запросы пользователя, когда он активирует ваш навык.
Под названием канала нажмите Получить webhook. Адрес вебхука будет скопирован в буфер обмена.
Регистрация навыка
Чтобы навык начал работать в Алисе, опубликуйте его в каталоге. Для публикации в каталоге, зарегистрируйте навык в Консоли разработчика Яндекс.Диалогов.
Задайте основные настройки навыка:
- Название — название навыка для каталога.
- Активационное имя — фраза, по которой навык можно вызвать в разговоре с Алисой.
- Webhook URL — вставьте вебхук, который был создан при подключении канала на платформе.
- Голос — выберите голос, который будет озвучивать навык.
Подробнее об основных настройках навыка
Задайте ограничения на используемые устройства и настройки публикации в каталоге. Сохраните изменения.
Тестирование бота
Вы можете быстро проверить ответы навыка на его странице в Консоли разработчика: укажите вебхук и откройте вкладку Тестирование. Вы сможете отправлять запросы, видеть примерное отображение ответа Алисы, а также тело последнего запроса и ответа.
При тестировании в личном кабинете навык считается постоянно активированным, поэтому так не получится проверить работу активационных имен.
Подробнее о тестировании навыка
Когда вы удостоверитесь, что навык отвечает правильно, отправьте его на проверку кнопкой На модерацию.
Публикация навыка
Пока вы не опубликовали навык, он недоступен для пользователей Алисы.
После того, как ваш навык одобрен модератором, вы сможете отправить его на публикацию кнопкой Опубликовать. Навык появится в каталоге через 5-10 минут.