Certification of smart home devices
If you are a smart home device manufacturer or an official manufacturer's representative, you can certify your devices for Alice.
- The device will get the “Works with Alice” badge on Yandex Market and will be listed in the Yandex Smart Home(https://market.yandex.ru/brands--umnyi-dom-yandexa/17333002) section.
- You'll be able to place the “Works with Alice” badge on your promos, packaging, and devices. See how to use the badge in the design rules.
We certify a device or family of devices rather than the manufacturer's brand or product portfolio. The certification may be revoked.
How to certify a device
-
Make sure that the device is listed in the Yandex Market catalog. Check the specifications, brand, and model.
If the device is not on Yandex Market or its description is incorrect, add the product or edit its description following the instructions from Yandex Market Help.
-
Create a public skill on Yandex Dialogs.
When creating a skill, enter your contact details as an official manufacturer representative: Yandex will make this skill official.
-
In the skill settings, specify the devices.
On the skill page in the developer console, click the tab Настройки (Settings) and go to the Устройства (Devices) section. Start typing the device name and select it from the drop-down list or enter the Device ID from a Yandex Market link.
Example of device ID from a link
Link on Yandex Market:
https://market.yandex.ru/product--xiaomi-mi-led-smart-bulb/634589866
Device ID:
634589866
-
Pass moderation.
You can certify a device family, if devices from the family are identical from the user viewpoint.
- It is possible to certify as one device a series of diode tapes that differ in length or color, or electric kettles with different handles or housing material.
- You can't certify as one device a diode tape and a ceiling lamp or functionally different electric kettles (for example, varying in temperature control).
Links to devices in the skill description
The devices specified in the skill settings are grouped by category in the skill description in the skill store. If you select a device group, a Yandex Market page with your brand's products will open.
Requirements for devices to be tested
- You can submit your device for testing if it doesn't require additional electrical installation or assembly (we do not accept unmounted light switches and outlets, electrical relays, and other related devices). Prepare a mobile demo stand if necessary.
- For light bulbs with sockets other than E14, E27, and GU10, make sure to supply a socket and plug.
- Users should be able to connect devices without the developer's assistance through the mobile app or provider's account.
- In response to the Information about user devices request for tested devices, the provider must return the manufacturer name and model (
device_info.manufacturer
anddevice_info.model
properties).
Alert
The requirements below come into effect on January 1, 2023.
- Users should be able to control all the functions their device offers from the manufacturer's app if the Yandex smart home platform includes the relevant skills. For example, if a vacuum cleaner has different cleaning modes in the smart home app, those modes should also be available in the provider's skill.
- The provider must use the notification platform to notify users of the events related to device status changes. This means that any change in the device status outside of the Yandex smart home platform must be passed to the notification service. For example, if a user turns off the device in the provider's app or by pressing a button on the device, the service is expected to send a device shutdown event to the smart home platform via the notification service. Any data about changes in sensor readings, such as humidity or temperature changes or when a door opens, should be passed the same way to the notification service. The moderator will check for these incoming events as part of the skill testing.
In the device_info.manufacturer
and device_info.model
fields, pass the manufacturers and models shown on the device packages (SKUs). If the product name is different from the model, select the model. Let's say that “Yandex smart light bulb” is written on the packaging, and the on-box specification lists the model YNDX-0005
. Enter this model in the device_info.model
field when integrating with Yandex Smart Home.
Revoking certification
Certification is revoked if more than 5% of requests to the certified device models resulted in an error over a four-week period.
After the certification is revoked, the “Works with Alice“ badge” disappears for the skill — both in the Skill store and on the device page on Yandex Market. Yandex notifies your manager responsible for the skill that you must stop using the badge in your marketing materials (including internet content, packaging, and so on) within four weeks.