--- metadata: - name: generator content: Diplodoc Platform v5.48.2 alternate: - https://yandex.ru/dev/dialogs/smart-home/doc/en/certification.md - https://yandex.ru/dev/dialogs/smart-home/doc/ru/certification.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/dialogs/smart-home/doc/en/llms.txt # 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](https://yandex.ru/dev/dialogs/smart-home/doc/en/works-with-alice-rules.md) 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](https://yandex.ru/dev/dialogs/smart-home/doc/en/works-with-alice-rules.md) on your promos, packaging, and devices. See how to use the badge in the [design rules](https://yandex.ru/dev/dialogs/smart-home/doc/en/works-with-alice-rules.md). We certify a device or family of devices rather than the manufacturer's brand or product portfolio. The certification may be [revoked](#revocation). ## How to certify a device {#howto} 1. 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](https://yandex.ru/support/marketplace/assortment/add/index.html). 1. 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. 1. In the skill settings, specify the devices. On the skill page in the [developer console](https://dialogs.yandex.ru/developer/), 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. {% cut "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` {% endcut %} ![Devices subsection of the Settings tab in the developer console](_images/devices.jpg) 1. Pass [moderation](https://yandex.ru/dev/dialogs/smart-home/doc/en/publishing.md). 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 {#supported-device} The devices specified in the skill settings are grouped by category in the skill description in the [skill store](https://dialogs.yandex.ru/store/categories/smart_home). If you select a device group, a Yandex Market page with your brand's products will open. ![Supported devices screen in the app](_images/supported-device.png) ## Requirements for devices to be tested {#device-requirements} - 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](https://yandex.ru/dev/dialogs/smart-home/doc/en/reference/get-devices.md) request for tested devices, the provider must return the manufacturer name and model (`device_info.manufacturer` and `device_info.model` properties). {% note alert %} The requirements below come into effect on January 1, 2023. {% endnote %} - 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](https://yandex.ru/dev/dialogs/smart-home/doc/en/reference-alerts/post-skill_id-callback-state.md) 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 {#revocation} 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”](https://yandex.ru/dev/dialogs/smart-home/doc/en/works-with-alice-rules.md) 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.