Создание навыка

Чтобы создать навык умного дома, откройте консоль разработчика и нажмите Создать диалог → Умный дом. Откройте вкладку Настройки и заполните необходимые поля. Руководство по заполнению полей приведено ниже.

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

Основные настройки

Название

Название навыка, которое будет отображаться в каталоге.

Название должно:

  • Состоять не менее чем из 2 слов без учета предлогов (рекомендуется использовать не более 4 слов). Допускается название из 1 слова, если это уникальное название бренда.
  • Быть уникальным в каталоге.
  • Быть написанным на русском или английском языке.
  • Не ограничиваться общей категорией товаров, сервисов или контента (например, «пластиковые окна»).
  • Не содержать слов «Умный дом», «Алиса», «Яндекс» или «Станция».
  • Отвечать остальным формальным требованиям.
Endpoint URL

Адрес обработчика навыка, который будет принимать запросы Яндекс.Диалогов к умному дому и отвечать на них. Обработчик обязательно должен работать по HTTPS, протокол должен быть указан в адресе, например https://example.com/smart-home/.

Примечание. Время ожидания ответа от навыка — 3 секунды. Если Диалоги не получат ответ в течение этого времени, сессия навыка завершится. Алиса сообщит пользователю, что навык не отвечает.

Публикация в каталоге

Приватность

Признак того, что навык не должен отображаться в каталоге.

Примечание. Приватным навыком умного дома может воспользоваться только его разработчик.
Подзаголовок
Краткое описание навыка для списка навыков умного дома в приложении Яндекс.
Имя разработчика
Имя автора навыка.
E-mail разработчика
Адрес для связи с разработчиком навыка (по умолчанию используется Яндекс.Почта аккаунта, авторизованного в Диалогах).
Сайт для верификации прав использования бренда

Адрес сайта для навыка. Будет отображаться на странице описания навыка в каталоге, в разделе «Связь с разработчиком».

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

Права на сайт проверяются с помощью Вебмастера, чтобы навык с вашим брендом могли опубликовать только вы. Если бы этой проверки не было, кто угодно мог бы использовать ваш бренд и официальный сайт для своего навыка — Яндекс.Диалоги не могли бы автоматически убедиться в том, что права на бренд принадлежат вам, а не кому-то еще.

Описание

Описание функциональности навыка на русском языке, которое будет отображаться в каталоге. В описании должны быть перечислены типы устройств, с которыми умеет работать навык, а также инструкции по их подключению. Примеры описаний можно посмотреть у навыков Xiaomi и Phillips Hue.

Чтобы оформить описание, можно использовать некоторые возможности языка разметки Markdown:

  • Заголовки:

    # Первого уровня
    ## Второго уровня
    ### Третьего уровня
  • Цитаты:

    > Текст, на который стоит
    > обратить внимание.
  • Списки:

    * маркированный
    * список
    
    1. нумерованный
    2. список

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

Заметки для модератора

В этом поле нужно указать необходимую для тестирования информацию:

  • Тестовый аккаунт для проверки авторизации в навыке.
  • Если для работы навыка необходимы определенные устройства, опишите их, и команда Диалогов запросит эти устройства у вас при проверке.

Иконка

Изображение размером 224×224 пикселя, которое отображается в каталоге. Рекомендуется загружать картинки этого или большего размера. При необходимости изображение будет автоматически уменьшено.

Ограничения для иконок:

  • Поддерживаемые форматы — PNG и JPG.
  • В иконке может использоваться название или логотип только того бренда, который указан в названии и описании навыка.
  • Чтобы навык прошел модерацию, иконка должна отвечать формальным требованиям.