This guide will teach you how to configure events to send updates to Slack. You can configure dedicated channels for devices and events.

Step 1: Configure Slack workspace integration

In Formant, in the upper-left corner, open the menu and click Settings.
In the sidebar, click Integrations. Next to Slack, click Connect.
Select the Slack Workspace you want to connect to Formant.
Select the Slack Channel to receive events. We recommend creating a channel dedicated to Formant events.
Click Allow.

Step 2 (Optional): Set a default Slack Channel for your device

You can configure a dedicated Slack Channel for your device. We recommend setting up a dedicated Slack Channel for each device. If configured, you will have the option to send a Slack message to the device channel when events occur on that device.

In Formant, in the upper-left corner, open the menu and click Settings.
In the sidebar, click Devices. Select the device you want to configure to send its events to Slack.
In the General tab, scroll down to Slack Channels. Enter the Slack Channel which should receive event messages from the device.

Step 3: Configure an event

Now that we've configured our Slack channels, we're ready to configure an event to send Slack messages. We recommend setting up a dedicated Slack Channel for each event.

In Formant, in the upper-left corner, open the menu and click Settings.
In the sidebar, click Events. Select the event you want to configure to send updates in Slack.
In the Actions tab, you will see Slack forwarding and Use device Slack channels.

Property Name	Usage
Slack forwarding	Select the Slack Channel you configured in Step 1. The event will send messages to the event channel.
Use device Slack channels	Select the Slack Channel you configured in Step 2. The event will send messages to the device channel.

Example

Slack integration is enabled and linked to the channels #lowBattery,#device1 , and #device2.

In their device settings, Device1 is configured with the Slack Channel #device1, and Device2 is configured with the Slack Channel #device2.

lowBattery is an event which is triggered when a device's battery drops below 20%. lowBattery is configured for both Device1 and Device2. lowBattery has Slack Forwarding set to #lowBattery. Use device Slack channels is set to ON.

Device1's battery drops to 19%, triggering lowBattery. Because Slack Forwarding is set to #lowBattery, a Slack message is sent in #lowBattery. Because Use device Slack channels is set to ON, a Slack message is sent to #device1.

Device2's battery then drops to 19%, again triggering lowBattery. Because Slack Forwarding is set to #lowBattery, a Slack message is sent in #lowBattery. Because Use device Slack channels is set to ON, a Slack message is sent to #device2.

#lowBattery then contains a log of all lowBattery events, #device1 contains a log of all Device1 events, and #device2 contains a log of all Device2 events.

Remove Slack integration

In Formant, in the upper-left corner, open the menu and click Settings.
In the sidebar, click Integrations. Delete all Slack Channels you have configured.
Click Disconnect, and then Yes to confirm the disconnection.

👋
If you notice an issue with this page or need help, please reach out to us! Use the 'Did this page help you?' buttons below, or get in contact with our Customer Success team via the Intercom messenger in the bottom-right corner of this page, or at [email protected].