Creation and settings

Check out the smart home management concept. To create a skill, open the developer console and click Создать диалог → Умный дом (Create dialog → Smart home). Open the Настройки (Settings) tab and fill in the required fields.

Language and descriptionLanguage and description

For a skill to pass moderation, all settings (name, description, icon, and so on) should comply with formal requirements.

LanguageLanguage

The language of the skill, which determines which country your skill can be published in. The name, description, and subtitle should be written in this language.

NameName

The name of the skill that will show up in the Skill store.

Name requirements:

• Consists of at least two words excluding prepositions (we recommend using no more than four words). One word is acceptable if it is a unique brand name.
• The same name doesn't already exist in the store.
• It doesn't match a general category of products, services, or content (for example, “plastic windows”).
• It doesn't contain the words “Smart home”, “Alice”, “Yandex”, or “Station”.

SubtitleSubtitle

A brief description of the skill for the list of smart home skills in the Home with Alice app.

DescriptionDescription

A description of the skill's features in Russian to show up in the Skill store. List the device types the skill works with and provide instructions on how to connect these devices. Check out an example of the Aqara skill description.

You can use the Markdown markup language features in the description:

• Headers:

  # Level one
  ## Level two
  ### Level three
  

• Quotes:

  > Text
  > to pay attention to.
  

• Lists:

  * bulleted
  * list
  
  1. numbered
  2. list
  

Additional languageAdditional language

Click the Добавить язык (Add language) button to make your skill available in another language. Also provide the name, subtitle, and description in the additional language.

The first language on the list is used as the backup language.

Regions and countriesRegions and countries

Locations that your skill supports.

All countries where the skill is supported are automatically selected on the Все доступные (All available) tab depending on the specified languages.

You can edit the list on the Свой выбор (Manual selection) tab by deselecting the countries the skill shouldn't be published in.

For a country to become selectable, you need to use at least one of the languages of that country for your skill.

Main settingsMain settings

BackendBackend

The parameters of the skill handler that accepts the user's requests via Yandex Dialogs and responds to them.

Available options:

• Endpoint URL: The URL of the skill handler. The handler must run on HTTPS, and the address must specify the protocol, for example https://example.com/smart-home/.

  For the skill to run correctly, set up the SSL certificate chain on the web server or in the provider service:

  1. Generate a certificate using one of the certificate programs (such as Let's Encrypt, SSL For Free, CAcert).

  2. Copy the certificate files to the folder.

  3. Specify the paths to these files for your web server.

  Alert

  The platform only supports fullchain certificates. If you try to verify with a self-signed certificate, you will receive the following message: “Endpoint URL: Invalid SSL certificate".

  To check the validity of the certificate, use the following online services: SSL Labs, SSL Shopper, Wormly, ImmuniWeb. Keep in mind that online methods of generating and verifying certificates should not be used for sensitive data, because that way your private keys might leak to third-party services.

• Yandex Cloud function: The ID of the function in Yandex Cloud. The function must be created by the skill author. For more information about creating and enabling a function for an Alice skill, see the Yandex Cloud documentation.

Access typeAccess type

There are two types of access to a published skill:

• Public: The skill will be published in the Skill store and seen by all Alice users.

• Private: The skill is only available to you (in all surfaces where you're logged in as a skill creator).

  Private skills don't go through moderation and are published immediately. You can give Yango users individual access to a private skill. For more information about private skills, see Skill access.

  Once published, the private skill will appear in the Home with Alice app. Open the  Home with Alice app. In the top right-hand corner, tap and select Устройство умного дома (Smart home device). You'll find the skill in the list of popular manufacturers.

Publication in the Skill storePublication in the Skill store

Developer's nameDeveloper's name

Skill author's name.

Developer's emailDeveloper's email

Address for contacting the skill developer (the default is the Yandex.Mail account used to sign in to Yandex Dialogs).

Official skillOfficial skill

Indicates that it's an official brand skill, and the developer is a device manufacturer or the official representative of the manufacturer.

Website for verifying the rights to use the brandWebsite for verifying the rights to use the brand

Website address for the skill. It will be displayed on the skill description page in the Skill store, under Contact developers.

If you fill out this field, the skill will only pass moderation when you verify your rights to the site in Yandex Webmaster.

We'll make sure that you own the rights to the brand. Only you can use your brand and official website for your skill.

Notes for the moderatorNotes for the moderator

Provide testing information:

• Test account to verify skill authorization.
• Devices needed for the skill to work. The Dialogs team will ask for these devices from you during verification.

IconIcon

The image to appear in the Skill store.

Icon requirements:

• Format: PNG or JPG.
• Size: 224 × 224 pixels or more. The image size will be reduced automatically if necessary.
• The icon can feature the brand name or logo specified in the skill name and description.

Supported devicesSupported devices

Product ID or nameProduct ID or name

Go to the Устройства (Devices) tab. Start typing the device name and select it from the drop-down list or enter the device ID from a Yandex Market link.

You need to fill in this field to be able to certify devices when creating official skills.

Frequently asked questionsFrequently asked questions