Skip to main content

Genea Access Control + Slack Integration

Written by Anmol Gupta

Slack is a nifty team communication app that was designed to make your life simpler. Integrating Slack with your Genea system will be beneficial for you for several reasons. 

  • Audit Log Notifications - Genea can notify you via Slack when changes are made to your Genea access system, including when users are created or deactivated, keys are issued or revoked, or changes are made to schedules or door groups etc...

  • Access Control Notifications - Genea can notify you via Slack when important events occur on your property such as Card Access Denied, Controller Offline/Online, AC Power Failure Battery Backup Failure, Door Being Help Open, Door Forced etc..

  • Visitor Log Notifications - Genea can notify you via Slack when visitors arrive at your property.

  • Safe Workplace, Lock, and Intrusion Alerts - Get notified for additional alert categories based on your configuration.

  • Slack Commands - you can temporarily unlock doors for visitors by using simple commands in Slack.

Slack Integration V1 (Deprecating Nov'26)

Installation Steps

  1. Click on the 'Integrations' tab in your Genea dashboard. Find the Slack integration and click 'Install.'

2. Authorize the integration.

Once done, Slack with be integrated with your Genea system!


3. Select which Slack channels to which you would like your system notifications to be sent. They must be private Slack channels. We recommend creating separate private channels (i.e. #access-control, #audit-logs, #visitor-logs) for better readability and log type segregation. Since the Slack channels must be private, only private Slack channels belonging to the administrator setting up the integration will be available for selection. Which ever channels you select, these will be the channels in which you will receive your notifications.


4. Select your notification filters. When you click on a filter, a blue check mark will appear in the filter box. This means you have enabled the filter and will be notified when the given event occurs on your access control system. When a filter is selected, it is automatically saved and will go into affect immediately.

Slack Migration from V1 to V2

If you already have Slack integrated with Genea, you will see a banner on your Slack integration page:

"Slack will stop supporting the current API after November 2026. Please migrate to Slack Integration v2."

You will also see a Migrate to v2 button on the Slack card in the Integrations overview.

Migration Steps

1. Start the migration Click Migrate to v2 from either the integration overview or the banner on your Slack page.

2. Download your legacy configuration A migration dialog will appear. Before proceeding, click Download Legacy Config to save a copy of your current channel configuration. This file contains your previous setup so you can reference it when reconfiguring.

💡 Keep this file handy after migration you'll start with a clean slate and will need to re-add your channels and notification preferences.

3. Authorize the new integration Click Start Migration. You'll be redirected to Slack to authorize the new Genea Security app. Select your workspace and click Allow.

4. Migration complete Once done, you'll see a Migration Successful confirmation. Your integration is now running on v2.

5. Install the new "Genea Security" slack app to all the private channels you wish to integrate with Genea.

6. Reconfigure your channels After authorization, you'll return to a fresh Slack Location page. Use your downloaded legacy config file as a reference to recreate your channel and alert settings. Click + Add to set up each location.

7. You can always download the legacy configuration from the option which will be available till Nov'26.

⚠️ After migration, your v1 integration will be disabled. Slash commands will switch to the new /genea-* format.

Slack Integration V2 for US and EU

⚠️ Important: Slack is retiring its legacy API after November 2026. All existing Genea Slack integrations must migrate to v2 before this date to continue receiving alerts and using commands.

Genea Security now supports Slack Integration v2, built on Slack's latest API architecture. Here's what's changed:

  • Updated bot identity - The bot is now called Genea Security for US (previously "Genea Access Control") and Genea Security EU for EU customers.

  • New slash commands - Commands now use the /genea-* prefix (e.g., /genea-list, /genea-unlock).

  • Support for EU Customers - Genea Slack app integration will now support EU regions as well.

Setting Up Slack Integration

Step 1 - Install the integration

  1. In your Genea dashboard global overview , go to Integrations in the left sidebar.

  2. Scroll to the Communication section and find the Slack card.

  3. Click Install.

Step 2 - Authorize Genea Security in Slack

You will be redirected to Slack to authorize the integration. On the Slack permissions screen. Select your workspace from the dropdown and click Allow.

[For US Customer] Step 3 - Add Genea Security to your private Slack channel

Before adding a location in Genea, you need to invite the Genea Security bot to each private Slack channel you plan to use for notifications.

Channels must be private 🔒. The bot will only appear as an option in Genea once it has been added to the channel.

To add the bot, go to your private Slack channel and use either method:

  1. Open the private channel in Slack

  2. Click the channel name at the top to open channel settings

  3. Go to IntegrationsAdd an App

  4. Search for Genea Security and click Add

Repeat this for each private channel you want to use. Once added, those channels will be available to select when configuring your location in Genea.

[For EU Customer] Step 3 - Add Genea Security to your private Slack channel

Before adding a location in Genea, you need to invite the Genea Security EU bot to each private Slack channel you plan to use for notifications.

Channels must be private 🔒. The bot will only appear as an option in Genea once it has been added to the channel.

To add the bot, go to your private Slack channel and use either method:

  1. Open the private channel in Slack

  2. Click the channel name at the top to open channel settings

  3. Go to IntegrationsAdd an App

  4. Search for Genea Security EU and click Add

Repeat this for each private channel you want to use. Once added, those channels will be available to select when configuring your location in Genea.

Step 4 - Add a location

Once authorized, you'll land on the Slack Location page. Click + Add to configure your first location.

💡 We recommend creating separate private Slack channels for different alert types (e.g., #access-control-alerts, #audit-logs, #visitor-management) for better readability and log segregation.


Step 5 - Configure your notification filters

Within each location, you'll see the following alert sections. For each section, select a Slack channel and then choose which notification types you want to receive:

Access Control Alerts

  • Controller connection goes down / power supply fails

  • Card access denied / anti-passback / tamper switch events

  • Door held alarm / door forced alarm events

  • Monitor point / control point alarm, fault, and secure state changes

  • Emergency plan triggered / reverted

  • Remote door lock, unlock, and quick grant operations

Audit Logs

  • Create, update, and delete actions across your Genea system

Visitor Management Alerts

  • Notify host when visitor arrives / checks out

Safe Workplace Alerts, Lock Alerts, Intrusion Alerts

  • Add a Slack channel to enable these alert categories

Available Slack Commands 

From any of your configured Genea Slack channels, you can use the following commands:

Command

Description

/genea-list

Get a list of all door IDs in your system

/genea-unlock <door-id>

Remotely unlock a specific door by its ID

/genea-help

View available commands

You can use your Door IDs to remote unlock or lock doors for guests. To do this, you will want to type the following request with your specific Door ID: 

  • /genea-unlock <Door ID> - Use this command to unlock the specific door by its ID. Please use the <door_id> you get in the list command. 

For example, if your Door ID is 27, you will type: /genea-unlock <27>

Sample Slack Notifications

Audit Log Notifications:

Access Control Notifications:

Visitor Log Notifications:

Security & Permissions

Genea Security requests only the minimum Slack permissions required for the integration to function. Here's what each permission is used for and what it cannot do:

What we can do:

  • channels:read / groups:read - Read the list of only channel names in your workspace (public and private). This is used only to populate the channel selector in the Genea portal so you can choose where alerts are sent. We cannot read any messages, files, or content within those channels.

  • chat:write - Post alert notifications outbound to your configured channels and send direct messages to hosts for visitor notifications. Alerts are delivered via Slack's API directly, we do not use incoming webhooks.

  • users:read / users:read.email - Look up a user's profile and email address in two specific cases only: (1) to verify if the person using /genea-unlock has door unlock permissions in the Genea portal, and (2) to match the host's email in Genea with their Slack account to deliver visitor check-in DMs. We do not store usernames or email addresses, nor save bulk user or email.

  • commands - Register the /genea-list, /genea-unlock, and /genea-help slash commands.

What we cannot do:

  • Read messages in any channel

  • Access conversation or channel history

  • Read files or attachments

  • Store any Slack user data like name or email id

Important Note on Data & Privacy

When you connect Slack to Genea Security, certain data from your Slack workspace - such as user IDs, channel information, and event metadata - is accessed solely to enable the integration features. Genea only requests the minimum permissions required for the integration to function.

Your Slack data is processed in accordance with our Privacy Policy and is not shared or used for any purpose other than delivering and improving the integration.

By enabling this integration, you agree to Genea's Privacy Policy.

If you have any questions about this feature or have any other requests, please reach out to acsupport@getgenea.com.

Did this answer your question?