--- metadata: - name: generator content: Diplodoc Platform v5.66.0 alternate: - https://yandex.ru/dev/dialogs/smart-home/doc/en/start.md - https://yandex.ru/dev/dialogs/smart-home/doc/ru/start.md - href: https://yandex.ru/dev/dialogs/smart-home/doc/ru/start.md type: text/markdown title: Markdown version - href: https://yandex.ru/dev/dialogs/smart-home/doc/ru/llms.txt?revision=r21995741 rel: describedby --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/dialogs/smart-home/doc/ru/llms.txt?revision=r21995741 # Создание и настройки {% note alert %} Для брендированных навыков используйте не личные аккаунты сотрудников, а общие корпоративные аккаунты. В [Вебмастере](https://webmaster.yandex.ru/site/settings/access/) подтвердите для аккаунтов права на сайт. {% endnote %} Прочитайте [концепцию управления умным домом](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/general-concept.md). Чтобы создать навык, откройте [консоль разработчика](https://dialogs.yandex.ru/developer/) и нажмите **Создать диалог** → **Умный дом**. Откройте вкладку **Настройки** и заполните необходимые поля. ## Язык и описание {#languages} Чтобы навык прошел модерацию, все настройки (название, описание, иконка и т. д.) должны отвечать формальным требованиям. #### Язык Язык навыка, от которого зависит, в какой стране может быть опубликован ваш навык. Название, описание и подзаголовок нужно указать на этом языке. #### Название Название навыка, которое появится в [каталоге](https://dialogs.yandex.ru/store/categories/smart_home). Требования к названию: - Состоит как минимум из двух слов без учета предлогов (рекомендуем использовать не более четырех слов). Допускается одно слово, если это уникальное название бренда. - В каталоге нет такого же названия. - Не ограничивается общей категорией товаров, сервисов или контента (например, «пластиковые окна»). - Не содержит слов «Умный дом», «Алиса», «Яндекс» или «Станция». #### Подзаголовок Краткое описание навыка для списка навыков умного дома в приложении [![](_images/smart-home-app.svg) Дом с Алисой](https://alice.yandex.ru/smart-home). #### Описание Описание функциональности навыка на русском языке, которое появится в [каталоге](https://dialogs.yandex.ru/store/categories/smart_home) и в приложении ![](_images/smart-home-app.svg) Дом с Алисой. Итоговое описание формируется из следующих полей: - **Подключение устройств**: предзаполненное текстовое поле с плейсхолдерами, которые должен заполнить автор навыка. - **URL поддержки** (только для [официальных навыков](https://yandex.ru/dev/dialogs/smart-home/doc/ru/about.md#about-trusted-skills)). Для каждого языка нужно добавить свое описание. В описании доступны возможности языка разметки Markdown: - Заголовки: ``` # Первого уровня ## Второго уровня ### Третьего уровня ``` - Цитаты: ``` > Текст, на который стоит > обратить внимание. ``` - Списки: ``` * маркированный * список 1. нумерованный 2. список ``` #### Дополнительный язык Нажмите кнопку **Добавить язык**, чтобы сделать описание навыка доступным на еще одном языке. Для дополнительного языка также укажите название, подзаголовок и описание. Если описание не представлено на указанном языке, то будет использоваться первый язык из списка. ## Регионы и страны {#countries} В каких странах поддерживает работу ваш навык. {% note alert "Ограничение" %} Если для разных стран вы используете разные обработчики, то вам нужно создать несколько навыков, так как для одного навыка можно указать только один **Backend URL**. {% endnote %} Все страны, в которых будет поддерживаться навык, отмечаются автоматически на вкладке **Все доступные** в зависимости от указанных языков. Вы можете изменить список на вкладке **Свой выбор**, убрав отметки со стран, где навык не должен быть опубликован. Чтобы страна стала доступна для выбора, нужно поддержать хотя бы один из языков этой страны. ## Основные настройки {#general-settings} #### Backend {#backend} Параметры обработчика навыка, который будет принимать запросы пользователя через Яндекс Диалоги и отвечать на них. {% note alert %} Время ожидания ответа от навыка — 3 секунды. Если платформа умного дома не получит ответ в течение этого времени, Алиса сообщит пользователю, что устройства долго не отвечают. При управлении через **Умный дом** → **Устройства** пользователь увидит сообщение об ошибке и ID запроса. В 3 секунды входят: - установка сетевого соединения; - время доставки запроса до сервера навыка; - собственное время работы навыка; - время доставки ответа до серверов Алисы. {% endnote %} {% note alert %} Длина ответа не должна превышать 5000 символов, длина OAuth-токена и refresh-токена — 2048 символов. Время жизни токенов (свойство `expires_in`) должно быть числом от 1 до 4 294 967 296. {% endnote %} Доступные варианты: - **Endpoint URL** — адрес обработчика навыка. Обработчик обязательно должен работать по HTTPS, а протокол должен быть указан в адресе, например `https://example.com/smart-home/`. Для корректной работы навыка настройте цепочку SSL-сертификатов на веб-сервере или сервисе провайдера: 1. Сгенерируйте сертификат, используя одну из программ для получения сертификатов ([Let's Encrypt](https://letsencrypt.org/), [SSL For Free](https://www.sslforfree.com/), [CAcert](http://www.cacert.org/) и др.). 2. Скопируйте файлы сертификатов в нужную папку. 3. Укажите вашему веб-серверу пути к этим файлам. {% note alert %} Платформа принимает только fullchain-сертификаты. При попытке верифицироваться с самоподписанным сертификатом вы получите сообщение «Endpoint URL: Некорректный SSL-сертификат». {% endnote %} Чтобы проверить валидность сертификата, используйте онлайн-сервисы [SSL Labs](https://www.ssllabs.com/ssltest/analyze.html), [SSL Shopper](https://www.sslshopper.com/ssl-checker.html), [Wormly](https://www.wormly.com/test_ssl), [ImmuniWeb](https://www.immuniweb.com/ssl/). Однако не забывайте, что онлайн-способы генерации и проверки сертификатов не должны применяться для чувствительных данных, чтобы ваши приватные ключи не попали к сторонним сервисам. - **Функция Yandex.Cloud** — идентификатор [функции в Yandex.Cloud](https://yandex.ru/dev/dialogs/alice/doc/deploy-ycloud-function-docpage/). Функцию должен быть создать автор навыка. О том, как создать и подключить функцию для навыка Алисы, читайте в [документации Yandex.Cloud](https://cloud.yandex.ru/docs/functions/solutions/alice-skill). #### Тип доступа {#access-type} Доступ к опубликованному навыку бывает: - **Публичный** — навык попадет в каталог навыков, его увидят все пользователи Алисы. - **Приватный** — навык доступен только вам (на всех поверхностях, где вы авторизованы как создатель навыка). Приватный навык не отправляется на модерацию, а сразу публикуется. Выдавайте к нему индивидуальный доступ пользователям Яндекса. Подробнее о приватных навыках читайте в разделе [Доступ к навыку](https://yandex.ru/dev/dialogs/smart-home/doc/ru/access.md). После публикации приватный навык появится в приложении [![](_images/smart-home-app.svg) Дом с Алисой](https://alice.yandex.ru/smart-home). Откройте приложение ![](_images/smart-home-app.svg) Дом с Алисой, в правом верхнем углу нажмите ![Плюс](_images/plus.svg) и выберите **Устройство умного дома**. Вы найдете навык в списке популярных производителей. ## Публикация в каталоге {#publishing} #### Имя разработчика Имя автора навыка. #### Email разработчика Адрес для связи с разработчиком навыка (по умолчанию используется Яндекс Почта аккаунта, авторизованного в Диалогах). #### Официальный навык Указание на то, что это официальный навык бренда, а разработчик — производитель устройств или его официальный представитель. #### Сайт для верификации прав использования бренда Адрес сайта для навыка. Отобразится на странице описания навыка — в [каталоге](https://dialogs.yandex.ru/store/categories/smart_home), в разделе **Связь с разработчиком**. Если вы заполнили это поле, навык пройдет модерацию, когда вы [подтвердите права](https://yandex.ru/support/webmaster/service/rights.html) на сайт в [Яндекс Вебмастере](https://webmaster.yandex.ru/welcome/). Мы убедимся, что права на бренд принадлежат вам. Никто, кроме вас, не сможет использовать ваш бренд и официальный сайт для своего навыка. #### Заметки для модератора Укажите информацию для тестирования: - Тестовый аккаунт для проверки авторизации в навыке. - Устройства, необходимые для работы навыка. Команда Диалогов запросит эти устройства у вас при проверке. #### Иконка Изображение, которое появится в [каталоге](https://dialogs.yandex.ru/store/categories/smart_home). Требования к иконкам: - Формат — PNG или JPG. - Размер — 224 × 224 пикселя или больше. При необходимости изображение автоматически уменьшится. - В иконке может использоваться название или логотип бренда, который указан в названии и описании навыка. ## Поддерживаемые устройства {#devices} #### ID или название товара Перейдите на вкладку **Устройства**. Начните вводить название устройства и выберите его из выпадающего списка либо введите ID устройства из ссылки на Яндекс Маркете. {% cut "Пример ID устройства из ссылки" %} - Ссылка на Яндекс Маркете: `https://market.yandex.ru/product--xiaomi-mi-led-smart-bulb/634589866` - ID устройства: `634589866` {% endcut %} Это поле необходимо заполнить, чтобы [сертифицировать устройства](https://yandex.ru/dev/dialogs/smart-home/doc/ru/certification.md) при создании официальных навыков. ## Часто задаваемые вопросы {#troubleshooting} {% cut "Почему навык не отвечает пользователю?" %} Время ожидания ответа от навыка — три секунды. Если Диалоги не получат ответ за три секунды, сессия завершится. Алиса сообщит пользователю, что навык не отвечает. {% endcut %} {% cut "Можно ли перенести навык с одного аккаунта на другой?" %} Да. Напишите в [службу поддержки](https://yandex.ru/dev/dialogs/smart-home/doc/ru/feedback.md). Навык переместят в течение двух недель. Чтобы не переносить брендированные навыки с личных аккаунтов сотрудников, создавайте такие навыки с корпоративных аккаунтов. {% endcut %} {% cut "Какие этапы обработки запроса входят в ограничение три секунды?" %} В три секунды входят: 1. Установка сетевого соединения. 1. Отправка запроса по сети с сервера Диалогов на сервер навыка. 1. Формирование ответа. 1. Отправка ответа по сети с сервера навыка на сервер Диалогов. {% endcut %} [![Служба поддержки](_images/support-image.svg)](https://yandex.ru/dev/dialogs/smart-home/doc/ru/feedback.md)