intercom

Last updated on November 06, 2025

Intercom.

Available device functions

The device can have all the functions listed below or some of them. E.g. if the intercom is not able to reject incoming calls, there is no need in including the reject_call function in its model description.

The online function must be described.

Function	Mandatory?	Description
incoming_call		Whether the intercom has incoming call
online	✔︎	Device availability: offline or online
reject_call		Reject incoming intercom call
unlock		Open the intercom lock

Intercom model description example

The model shall be described in accordance with the model structure. The example describes an intercom equipped with all functions.

{
   "id": "QWERTY124",
   "manufacturer": "Xiaqara",
   "model": "SM1123456789",
   "hw_version": "3.1",
   "sw_version": "5.6",
   "description": "Xiaqara Smart Intercom",
   "category": "intercom",
   "features": [
      "incoming_call",
      "online",
      "reject_call",
      "unlock",
   ]
}

User's intercom description example

The device shall be describe in accordance with the device structure. The example contains no intercom model description as we believe that models are described independently and the model ID will be enough (in this case, QWERTY124).

{
   "id": "ABCD_004",
   "name": "My intercom",
   "default_name": "Smart intercom",
   "room": "Entrance",
   "groups": ["Guests", "Common areas"],
   "model_id": "QWERTY124",
   "hw_version": "3.1",
   "sw_version": "5.6",
   "partner_meta": {
      "internal-id": 1234,
      "specificity": "microchip 2A"
   },
}