Send events to Slack
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.
Updated 25 days ago