Slack Integration

Slack Integration

Get instant notifications in your Slack channels when feedback arrives, tasks are created, or statuses change. Claim and complete tasks without leaving Slack.

6 Event Types Slash Commands Interactive Actions

Overview

The TendedLoop Slack integration connects your facility management workflow directly to your team's Slack workspace. Once installed, you can:

  • Receive real-time notifications for feedback, tasks, and status changes
  • Route different event types to different channels
  • Use /tendedloop slash commands to check task status
  • Claim and complete tasks with one-click buttons directly in Slack
Quick start: Go to Integrations in your dashboard and click "Install Slack App." The OAuth flow takes about 10 seconds.

Setup & Installation

Installing the TendedLoop Slack app uses the standard OAuth 2.0 flow. You need to be a Slack workspace admin and a TendedLoop admin.

Installation steps

  1. Open your TendedLoop dashboard and navigate to Integrations.
  2. Click Install Slack App. You'll be redirected to Slack's OAuth consent screen.
  3. Select the Slack workspace you want to connect and choose a default channel for notifications.
  4. Click Allow. You'll be redirected back to TendedLoop with a success message.

After installation, TendedLoop stores a bot token scoped to your workspace. You can manage notification settings, change channels, or uninstall at any time from the dashboard.

Note: Only one Slack workspace can be connected per TendedLoop tenant. To switch workspaces, uninstall the current integration first.

Notifications

TendedLoop posts rich Block Kit messages to your Slack channels when events occur. Each notification type includes structured data and, where applicable, interactive action buttons.

feedback.received

Posted when new feedback is submitted via a QR code scan. Includes the rating (with emoji), amenity name, and comment if provided.

Toggle: notifyFeedback

Format: Rating emoji + star display, amenity name, optional comment in blockquote

status.reported

Posted when an amenity status changes (e.g., supplies running low or empty). Shows previous and new status.

Toggle: notifyFeedback

Format: Previous status → New status comparison

task.created

Posted when a new task is created from feedback or a status report. Includes a "Claim Task" button.

Toggle: notifyTaskCreated

Format: Priority, source (feedback/status report/manual), interactive Claim button

task.acknowledged

Posted when a task moves to IN_PROGRESS (technician starts working on it).

Toggle: notifyTaskCreated

task.completed

Posted when a task is marked as completed.

Toggle: notifyTaskCompleted

task.reassigned

Posted when one or more tasks are reassigned to a different team member.

Toggle: notifyTaskCreated

Notification Settings

After installation, you can configure which events trigger Slack messages and where they're posted. Settings are managed from the dashboard's Slack integration page.

Per-event toggles

Each notification category can be independently enabled or disabled:

Toggle Controls Default
notifyFeedback feedback.received, status.reported On
notifyTaskCreated task.created, task.acknowledged, task.reassigned On
notifyTaskCompleted task.completed On

Channel routing

By default, all notifications go to the channel selected during installation. You can optionally route specific event types to different channels using channel routing: 

{
  // Route feedback to #facility-feedback
  "feedback.received": "C0123FEEDBACK",

  // Route tasks to #facility-ops
  "task.created": "C0456TASKS",

  // Events without a routing rule use the default channel
}

Events not listed in the routing table fall through to the default channel. If no default channel is set, the notification is silently skipped.

Slash Commands

The TendedLoop Slack app registers the /tendedloop slash command. Commands return ephemeral messages visible only to you.

/tendedloop status

Returns a task dashboard summary for your tenant, including:

  • Open Tasks — count of tasks with status NEW
  • In Progress — count of tasks with status IN_PROGRESS
  • Completed Today — tasks completed since midnight UTC
  • Total Active — open + in progress

/tendedloop help

Lists available commands and their descriptions.

Interactive Actions

Task notifications include interactive buttons that let your team act on tasks without leaving Slack. When a user clicks a button, TendedLoop matches their Slack email to their TendedLoop account to perform the action.

Button Appears On Effect
Claim Task task.created notifications Assigns the task to the clicking user and sets status to IN_PROGRESS
Complete Task Claimed task messages Marks the task as COMPLETED

How user matching works

  1. When a user clicks a button, TendedLoop calls the Slack users.info API to retrieve their email address.
  2. TendedLoop looks up the user in your tenant by matching email addresses (case-insensitive).
  3. If a match is found, the task action is performed on behalf of that user.
  4. If no match is found, an ephemeral error message is shown to the user.
Tip: Make sure your team members use the same email address in both Slack and TendedLoop for interactive actions to work correctly.

Permissions & Scopes

The TendedLoop Slack app requests the following OAuth bot token scopes:

Scope Purpose
chat:write Post notification messages to channels
commands Register and respond to the /tendedloop slash command
users:read Look up user information for interactive action matching
users:read.email Read email addresses to match Slack users to TendedLoop accounts

TendedLoop does not read your channel messages, access private channels unless invited, or store any Slack user data beyond the bot token and workspace metadata.

Troubleshooting

Notifications aren't appearing in my channel

  • Verify the integration is active in your dashboard
  • Check that the relevant notification toggle is enabled
  • Ensure the TendedLoop bot has been invited to the target channel (/invite @TendedLoop)
  • Confirm a default channel is set (or channel routing covers the event)

"Could not find your TendedLoop account" when clicking buttons

  • Your Slack email must match your TendedLoop account email (case-insensitive)
  • Ask your admin to verify your email in TendedLoop settings

Slash commands return "TendedLoop is not connected"

  • The app may need to be reinstalled — go to Integrations in your dashboard
  • Make sure you're in the correct Slack workspace

OAuth installation fails

  • You must have admin permissions in your Slack workspace
  • You must be an admin in TendedLoop
  • Ensure you click "Allow" on the Slack consent screen — clicking "Cancel" will redirect you back with an error

Ready to connect Slack?

Install the TendedLoop Slack app in under a minute from your dashboard.

Open Integrations Start Free Trial