Подключение и настройка платформы Яндекс.Диалоги
Яндекс. Диалоги доступны только на Windows в Яндекс Браузере или на Android в приложении Яндекс. Убедитесь в совместимости перед подключением и установите необходимые программы.
В Яндекс Диалогах не поддерживаются:
- компоненты Документ и Аудио,
- форматирование текста,
- предпросмотр ссылок,
- ряды кнопок (обычные кнопки всегда приходят в один ряд, кнопки с подсказками всегда приходят одна под другой),
- номер телефона через файл контакта принять не получится, номер нужно вводить вручную.
- запросы с долгим ответом работать не будут, через 4 секунды запрос упадет.
Другие ограничения и особенности:
- сообщения не прерывающиеся Вводом от пользователя или Развилкой, то есть все сообщения идущие подряд, склеиваются в одно сообщение,
- при использовании Ввода от пользователя и Развилки поддерживается следующие типы данных: текст, регулярное выражение, число, дата. Остальные типы данных не работают,
- чтобы платформа успевала срабатывать, в сценариях для Яндекс.Диалогов не рекомендуем использовать длинные тексты, запросы, которые выполняются долго, а также Таймауты.
Подключение
- Зайдите в свой аккаунт на Яндексе или создайте новый.
- Откройте ссылку https://dialogs.yandex.ru/
- Нажмите кнопку Создать навык.
4. Нажмите на плюс и создайте новый диалог.
5. Выберите Навык в Алисе чтобы попасть в Настройки.
6. Назовите навык.
7. Откройте настройки Ботмамы и включите платформу Яндекс.Диалоги. Выберите экран, в который перейдет пользователь при возвращении в диалог, затем скопируйте Webhook URL.
8. Вернитесь в настройки навыка, выберите Webhook URL и вставьте вебхук из Ботмамы.
9. При необходимости можно выбрать голос из списка. Им будут озвучиваться ответы бота в браузере или в приложении.
10. Тип доступа выберите Приватный. Приватный навык будет доступен только владельцу бота. Чтобы все пользователи имели доступ к навыку, выберите тип навыка: Публичный. В этом случае нужно будет заполнять все настройки навыка и пройти процесс модерации и тестирования, чтобы команда Алисы одобрила ваш навык для публичного использования.
11. Пролистайте ниже до раздела Публикация в каталоге. В примерах запросов выберите из первого списка Запусти навык, из второго — название создаваемого навыка.
12. Заполните поля Имя и Email разработчика.
13. Из выпадающего списка выберите категорию, под которую попадает навык и опишите навык в произвольной форме.
14. Выберите изображение для иконки навыка.
15. Сохранитесь.
16. Если всё заполнено верно, то справа появится информация о том, что черновик в разработке. Нажмите кнопку Опубликовать.
17. Понадобится некоторое время, чтобы диалог опубликовали. О том, что диалог опубликован, придет письмо на почту. Дождитесь письма и обновите страницу. Если диалог не опубликовали в течении нескольких часов, обратитесь в поддержку Яндекса.
18. Перейдите в раздел Доступ и сгенерируйте ссылку на диалог.
19. Откройте ссылку на Windows в Яндекс Браузере или на Android в приложении Яндекс. Другими способами ссылка не откроется.
20. Запустите навык.
21. После этого бот автоматически запустится в открывшемся окне для диалога. Текст, пришедший из бота, будет сразу озвучен.
Загрузка изображений
Из-за особенностей Яндекс Диалогов, сообщения не прерывающиеся Вводом от пользователя или Развилкой, то есть все сообщения идущие подряд, склеиваются в одно сообщение. Поэтому можно отправить только одно изображение за один раз. Отправить две картинки подряд или изображение с кнопками не получится.
1. Перейдите в раздел Ресурсы на сайте подключения Яндекс Диалогов.
2. Перетащите или выберите из файловой системы компьютера изображение. Рекомендуем загружать прямоугольные изображения горизонтального формата, другой формат платформа обрежет под прямоугольник.
Со стороны Яндекса есть следующие ограничения по загрузке изображений на платформу Яндекс.Диалоги:
- для одного аккаунта Яндекса можно загрузить не больше 100 МБ изображений,
- каждый файл должен быть размером не менее 1 КБ и не более 1 МБ,
- поддерживаются форматы PNG, JPEG, GIF, BMP, TIFF, WEBP.
3. После загрузки скопируйте ID изображения.
4. Перейдите в Ботмаму и добавьте компонент Изображение на экран.
5. Откройте настройки компонента и вставьте ID изображения из Яндекс Диалогов в поле ID файла для Яндекс.Диалогов.
6. При необходимости добавьте Название изображения. Название придет в диалог под картинкой.
7. Сохраните изменения.
Готово. Если все сделано правильно, картинка придет в Яндекс Диалоги при вызове экрана с Изображением.
Получение ссылки для попадания в диалог с ботом
Чтобы получить прямую ссылку на диалог с ботом, Тип доступа у навыка должен быть Публичный. Ссылка появится во вкладке Продвижение после появления опубликованного навыка в каталоге.
Более подробно про получение прямой ссылки можно узнать в официальной справке Яндекса →