# Notifications (Busylights & Webhooks)
MuteDeck can notify external applications of changes in your meeting status. Currently, Plenom Busylights and custom webhooks are supported.
# Integrating with Plenom Busylight
The Plenom Busylight integration allows you to synchronize your status from MuteDeck to your Busylight, providing a visual indicator of your current meeting status. Please follow the instructions below to set up this integration successfully.
# Prerequisites
Before proceeding with the integration, ensure that you have the following:
- MuteDeck installed and running on your computer.
- A Plenom Busylight connected and functional.
- For Windows users, the kuandoHUB application (opens new window) should be installed on your computer.
- For macOS users, the Busylight HTTP app (opens new window) should be installed on your computer.
# Configuring Busylight
# macOS
On macOS, the only thing you need to do is to install the Busylight HTTP app (linked in the Prerequisites), and you'll be ready to integrate MuteDeck.
# Windows
On Windows, after you've installed the kuandoHUB app, you'll need to enable the HTTP Server.
- Open kuandoHUB and select the Advanced Settings on the left navigation.
- Click the HTTP Server checkbox to enable it.
- Open the Platform Priorities tab
- Enable the HTTP source, and use the Up buttons to place the HTTP source at the top of the list.
This allows MuteDeck to communicate with your Busylight.
# Enabling the Integration in MuteDeck
Now that the Busylight is ready for the integration, you can enable the integration inside MuteDeck which will have it start sending updates to your Busylight.
- Open the MuteDeck window and click the settings icon on the bottom right to open the settings.
- Locate the Notifications section, and enable the Enable Busylights switch.
You have now successfully enabled the integration between MuteDeck and Plenom Busylights! The Busylight turns green when you're not in a meeting, and turns red when you are in a meeting.
# Custom Webhook Notifications
Starting MuteDeck v2.6, the webhook integration enables you to send real-time notifications to a specified URL whenever there's a change in your call status or in the mute, video, share, or recording state.
# Webhooks
A webhook delivers data to other applications via HTTP as it happens, meaning you get data immediately. In the context of MuteDeck, webhooks are used to send notifications whenever there's a change in your meeting status. You can have the receiving end of the webhook start an automation based on your meeting status.
# Prerequisites
Before setting up the webhook integration, make sure you have:
- MuteDeck installed and running on your computer.
- A valid URL to receive webhook notifications. This URL should be set up to handle incoming HTTP POST requests.
# Enabling the Webhook Integration
Open the MuteDeck application on your computer.
- Open the MuteDeck window and click the settings icon on the bottom right to open the settings.
- Locate the Notifications section, and enable the Enable Webhook switch.
- Enter the webhook URL in the text box that appears when you enable the webhook notification.
The webhook URL is automatically saved and activated. MuteDeck will start sending webhooks on every change, which you can test by toggling mute or by starting a meeting.
# Webhook Format
MuteDeck sends POST
requests to the webhook URL. The payload of the requests is structured the same as the regular API. Check out the API documentation for more information.