![](\"https://raw.githubusercontent.com/homebridge/branding/latest/logos/homebridge-color-round-stylized.png\")
\n\n \n
![](\"https://github.com/denisgabriel5/homebridge-intercom/actions/workflows/build.yml/badge.svg\" "\\"Node"){kind=icon}
\n\n\n\n## Overview\n\n**Homebridge Intercom** is a plugin for [Homebridge](https://github.com/homebridge/homebridge) that enables integration with old intercoms. This allows you to control and monitor your intercom system directly from your Home app.\n\n## Features\n\n* **Notifications**: Receive notifications when someone rings your intercom.\n* **Door control**: Unlock the door connected to your intercom.\n* **Automations**: Create automatizations whne the intercom rings, via an Occupancy Sensor exposed in the Home app.\n\n## Installation Instructions\n\nIf you have installed Homebridge UI, then you can install the plugin from the Homebridge Plugins screen by searching for `homebridge-intercom`. If not, then you can install it by running this command:\n\n```\nsudo npm install -g homebridge-intercom\n```\n\n## Usage\n\n### Configuration\n\nIn order to configure the intercom you will need to fill the following fields:\n\n#### Intercom general fields:\n\n- Name: `string` _(required)_\n - The name that will appear in your homebridge log.\n- Manufacturer: `string` _(optional)_\n - What will show under Manufacturer in accessory settings.\n- Model: `string` _(optional)_\n - What will show under Model in accessory settings.\n- Serial Number: `string` _(optional)_\n - What will show under Serial Number in accessory settings.\n- Timeout: `number` _(optional)_\n - The number of seconds between the unlocking and locking notifications. Defaults to 10 seconds.\n- Intercom type: `string` _(required)_\n - The intercom communication with Homebridge is done directly with the intercom or indirectly. When done indirectly, an interface will be used, such as Raspberry Pi or Shelly. \n As of now, these are the supported ways of communication:\n - Shelly Uni _(indirectly)_\n\n _Note: Please open an issue if you would like support added for your intercom._\n\n#### Intercom Specific Fields:\n\n1. Shelly Uni:\n\n- Ring Notification Type: `string` _(required)_\n - Choose how the plugin should detect ringing:\n - `request`: Exposes a webhook that the Shelly Uni calls.\n - `poll`: Polls a Shelly Uni endpoint for it's ringing status.\n - Defaults to `poll`.\n- Webhook Port: `number` _(required if using `request` notification type)_\n - The port on which the webhook will listen for `http://homebridge.ip:port/ringing?status=$value` calls.\n - Defaults to `9000`.\n - `request` specific field.\n - **Note**: If your Homebridge runs in Docker, then you must expose this port to the host.\n- Status URL: `string` _(required if using `poll` notification type)_\n - URL which retrieves the status of the Shelly Uni.\n - `poll` specific field.\n- Status JSON Path: `string` _(required if using `poll` notification type)_\n - `poll` specific field.\n - Path in the JSON structure to the field that changes upon ringing.\n- Poll Interval: `number` _(required if using `poll` notification type)_\n - The interval in seconds at which the plugin polls the endpoint for ringing status.\n - Defaults to `1`.\n - `poll` specific field.\n- Status Threshold: `number` _(required)_\n - The minimum value considered as a ringing trigger for `poll` or `request` methods.\n- Talk URL: `string` _(required)_\n - URL which triggers the Talk button on the Shelly Uni.\n- Open URL: `string` _(required)_\n - URL which triggers the Open button on the Shelly Uni.\n- Buttons Pressing Order: `string` _(required)_\n - Some intercoms require different pressing orders. The default one is pressing the Talk button, then the Open button, but others might require an additional press of the Talk or Open button.\n - Defaults to `open-talk`.\n- Buttons Timeout: `number` _(required)_\n - The number of seconds between \"pressing\" the buttons. Defaults to `1` second.\n- Ring Suppression Timeout: `number` _(required)_\n - The number of seconds to ignore any other changes in the status of the Shelly Uni (changes that imply that the intercom is ringing).\n\n### Description\n\nOnce configured, your intercom system will be accessible through the Home app. \n\nYou will have one accessory (the Intercom) which will encompass 3 accessories:\n- 1 Doorbell;\n- 1 Locking Mechanism;\n- 1 Occupancy Sensor (this will be useful in automations to detect when the Intercom is ringing).\n\nWhen someone will ring the intercom, the Doorbell will sent a notifications to all your Apple devices. Then to open the door, you will have to use the unlock switch, which is present in the Intercom accessory.\n\nIf you want you can automatize the opening of the door by using the Occupancy Sensor. This sensor will get triggered everytime the Intercom rings. You will still get the ringing notification, as well as unlocking/locking the door notifications.\n\n## License\n\nThis project is licensed under the Apache-2.0 license - see the [LICENSE](LICENSE) file for details.\n","readmeFilename":"README.md"}