Skip to main content
The Nuon Slack app posts deploy, action, workflow, and approval events into Slack channels you choose, and lets users approve workflow steps without leaving Slack.
The Slack integration is gated by an org feature flag. If you don’t see Slack in the dashboard sidebar, ask Nuon support to enable the slack feature flag for your org.

​
Overview

There are three pieces of state involved:

​
Installing the Slack app

  1. In the dashboard sidebar, click Slack.
  2. Click Install in Slack. You’ll be redirected to Slack’s OAuth consent screen.
  3. Approve the requested scopes. Slack redirects back to Nuon and creates the workspace installation.
  4. The workspace now shows up under Slack → Linked workspaces for your org.
Repeat step 1–2 from another org to link the same workspace to multiple orgs.

​
Subscribing a channel

Subscriptions are created from inside Slack via the slash command:
This opens a modal where you choose:
  • Org — which linked Nuon org to subscribe to.
  • Match — which entities in the org events must come from.
  • Interests — which events you care about.
Re-running /nuon subscribe in a channel that already has a subscription opens the modal pre-filled with the current settings — you can use it to edit.

​
Slash commands

All responses are ephemeral — only the user who ran the command sees them.

​
Match — routing predicate

match decides which entities a subscription cares about. Three modes:
  • Org-wide — every entity in the linked org.
  • Specific IDs — an explicit list of install / app / component IDs.
  • Label selector — entities whose labels match a selector (e.g. env=prod,tier=critical).
The same match contract is shared with webhooks, so the same mental model applies in both places.

​
Interests — event filter

interests decides which kinds of events are delivered. It’s a structured filter across:
  • Resource kinds — installs, components, actions, workflows.
  • Operations — deploy, destroy, plan, etc.
  • Outcomes — completion, failures.
  • Approvals — approval requests and approval responses.
For example, a “production deploy failures” subscription matches installs with the env=prod label, and interests of deploy + failures.

​
Role change notifications

When a customer enables or disables an operation role in their install stack, Nuon can post a notification to subscribed Slack channels. Role change events appear as standalone messages (not threaded under a workflow) showing the role name, type, and install context. To receive role change notifications, include installs in your subscription’s interests. Role enable/disable events are delivered alongside other install lifecycle events.

​
Approvals from Slack

When a workflow step requires approval and a channel is subscribed to approval events, Nuon posts the approval request into that channel with Approve / Reject buttons. Clicking either button records the response against the approver’s Nuon account (resolved from their Slack identity), so the audit trail matches a dashboard approval.

​
Unsubscribing

From inside the channel, run:
You can also remove a subscription from Slack → Subscriptions in the dashboard.

​
Removing the workspace installation

To fully remove the Nuon app from a workspace, an org admin can delete the Slack installation from Slack → Linked workspaces in the dashboard. This deletes the OAuth token, all org links for the workspace, and all channel subscriptions tied to those links.

​
Troubleshooting

  • /nuon subscribe says “this workspace isn’t linked to any Nuon org yet” — Open the dashboard and complete the OAuth install for the org you want to subscribe to.
  • No events arriving in a subscribed channel — Run /nuon status in the channel to confirm the subscription is recorded, then verify the source entity’s labels actually match the match selector.
  • Buttons in approval messages do nothing — The Slack app’s Interactivity Request URL must be reachable from Slack. If you’re running locally, your Slack app config must point at a public tunnel (e.g. Tailscale Funnel or ngrok) in front of the Nuon Slack listener.