Skip to main content

Slack Integration

Connect NirmIQ to Slack for project event notifications.

Subscription Required

Slack integration is gated at the Advanced tier and above. Lower tiers do not see the Slack settings panels.

Overview​

NirmIQ's Slack integration delivers one-way notifications from NirmIQ into Slack channels for project events such as requirement and FMEA changes, comments, mentions, and approval activity. The integration is designed around three configuration layers, each with a distinct purpose.

LayerWho configures itWhat it does
Organisation Slack ConfigOrg AdminStores the Slack app credentials (client ID / secret / bot token) for the workspace. Required before any user or project can connect.
Global Slack SettingsEach userA user's default Slack identity within the workspace, used as a fallback when a project does not have its own settings.
Project Slack SettingsProject memberPer-project channel mappings and notification preferences. Overrides the user's Global settings inside that project.

The integration is send-only. Slack messages are not synchronised back into NirmIQ — replies in Slack stay in Slack.

What Notifications Are Supported​

NirmIQ sends notifications when one of the following events occurs in a project that has a Slack channel mapped:

  • Requirement created / edited / deleted
  • FMEA failure mode created / updated / risk threshold crossed
  • Comment posted, comment resolved
  • @mention of a teammate
  • Action item assigned, status change, due date approaching
  • Approval requested / granted / rejected (where approval workflows are enabled)

Each notification includes a deep-link back to the relevant page in NirmIQ.

Setup​

Step 1 — Organisation Slack Config (one-time, Admin only)​

Before any user can connect Slack, an Organisation Admin must register the Slack app credentials.

  1. Open Settings → Integrations → Slack as an Admin
  2. Click Configure Slack App
  3. Provide the Client ID, Client Secret, and Bot Token from your Slack workspace's app definition
  4. Save

Once configured, all users in the org see the Connect Slack button on their own Global Slack Settings page.

Step 2 — Global Slack Settings (per user)​

  1. Click your profile avatar in the top-right and choose Settings
  2. Open the Global Slack section
  3. Click Connect Slack and complete the OAuth flow with your Slack workspace
  4. Verify your default Slack identity is shown as connected

These Global settings are used whenever a project you belong to does not have its own project-specific Slack settings.

Step 3 — Project Slack Settings (per project)​

  1. Open a project and go to Project Settings → Integrations → Slack
  2. Click Connect Slack to this project (this can use the same OAuth or a project-specific bot)
  3. Add channel mappings — for example:
    • #myproject-requirements for requirement events
    • #myproject-fmea for FMEA events
    • #myproject-approvals for approval workflow events
  4. Save — notifications begin flowing immediately

You can also use the Test notification button to confirm the channel is reachable.

Notification Templates​

NirmIQ ships with a default template for each notification type. Org Admins can view and update these templates per organisation:

  • Settings → Integrations → Slack → Templates
  • Templates use a small set of variables provided by NirmIQ (project name, requirement ID, user, link, etc.)

Custom templates are scoped to an organisation, not to individual users. They apply to all projects in the org.

What This Integration Does Not Do​

To set expectations clearly, the Slack integration does not currently:

  • Synchronise Slack replies back into NirmIQ comments
  • Create Slack channels automatically when a project is created
  • Provide meeting reminders, agendas, or calendar integration
  • Apply per-user content filters (e.g. "only notify me for high-risk items")
  • Throttle notifications based on time of day or quiet hours

If any of these are important to your workflow, please reply to your in-app Feedback panel or email info@nirmiq.com — we prioritise based on customer demand.

Permissions​

ActionRequired
View Org Slack ConfigOrg Admin
Edit Org Slack ConfigOrg Admin
Connect / disconnect own Global SlackAny signed-in user
Connect / disconnect Project SlackProject member
Send a test notificationProject member
Receive notifications in a Slack channelSlack-side (granted by the bot's channel access)

The NirmIQ Slack bot only sends to channels it has been invited to. Make sure your bot has been added to each mapped channel.

Troubleshooting​

"Failed to Connect Slack" during OAuth​

  • Confirm an Org Admin has saved the Organisation Slack Config first
  • Confirm the OAuth redirect URI configured in the Slack app matches the NirmIQ callback URL
  • Try a different browser to rule out third-party cookie issues

"Notifications not appearing in channel"​

  • Confirm the Slack bot is a member of the channel (/invite @YourBotName from inside Slack)
  • Confirm a channel mapping exists for the event type — see Project Slack Settings
  • Use the Test notification button to isolate whether the issue is in NirmIQ or in Slack
  • Check the Notification log in Project Settings → Integrations → Slack for delivery status

Rate Limiting​

Slack enforces a soft limit of approximately one message per second per channel. Bursts of activity in NirmIQ (e.g. a bulk import) can be queued and may arrive in Slack a few seconds late. This is expected and not an error.

Privacy and Security​

  • Slack message content includes the title and a NirmIQ deep link, but does not include the full body of requirements or FMEA fields by default
  • OAuth tokens are encrypted at rest
  • Disconnecting Slack at the Project, Global, or Organisation level immediately stops further notifications

For the full security posture see Security & Compliance.

Need Help?​

The fastest way to get help is from inside the app:

  1. Sign in to NirmIQ
  2. Click the Help menu and choose Documentation or use the in-app feedback button
  3. For email support, write to support@gannetsolutions.com (technical) or info@nirmiq.com (general)