Notifying Yandex Smart Home about events

Yandex Smart Home can receive and process events that are related to smart devices. The manufacturer only needs to send generated events to Yandex Dialogs according to the protocol.

How it works

Providers Smart Devices

Provider's smart devices. Generate events.

Provider IOT Cloud

Provider cloud that processes events received from user devices. When the event is processed, it's forwarded to the Adapter API.

Adapter API

Intermediate provider API. When processing an event, it converts it to the Yandex Smart Home format and forwards it to Yandex Dialogs.

Yandex Smart Home

Yandex's service for managing smart devices. Responds to events received from the provider.

Sample scenario

Step 1. Connecting the device

1. The user bought a smart temperature and humidity sensor that is activated once every five minutes to get readings.

2. If this is the first time the user accesses the Yandex services, the user account in the smart device provider's system must first be linked to the user's Yandex account.

   2.1. The user opens the Home with Alice app, taps in the top right-hand corner, and chooses Устройство умного дома (Smart home device).

   2.2. The user finds the developer skill and links the accounts.

   2.3. After the accounts are linked, the device list is automatically updated.

3. Yandex Smart Home requests the details of user devices from the provider.

4. After that, the device is ready to be used in Yandex Smart Home.

5. If the user device doesn't notify Yandex Smart Home of its state change, the user can't access the current data. To get information about state changes of the user device, the developer must set up the notification service.

Step 2. Notifying Yandex Smart Home about the state change

1. When the sensor is activated, it measures the current indicators and sends them to the device manufacturer server.

2. The manufacturer server sends a request to notify the platform about the device state change.

3. Yandex Smart Home processes the request and updates the device status.

4. When the user wants to find out the sensor state, they say the command. Yandex Smart Home informs the user of the last known temperature state recorded by the device:

   User: Алиса, что с температурой в комнате?

   Alice: Температура в комнате 24 градуса.

   Translation: User: Alice, what's the temperature in the room?

   Translation: Alice: The temperature in the room is 24 degrees.