Skip to main content

Actionable Notification: Microsoft Teams

Send interactive messages to your Teams colleagues

Written by Peter Novosel

Microsoft Teams Actionable Notifications let you send interactive SmartSuite notifications to Microsoft Teams so recipients can take action directly from the message. Instead of opening the record first, users can review the notification, click an action button, and update the related record from within Teams.

Overview

Actionable Notifications are designed for workflows where someone needs to make a decision or update a record quickly, such as approvals, reviews, and status changes. Each notification is tied to a specific SmartSuite record and includes action buttons that update a selected field when clicked.

A Microsoft Teams Actionable Notification can include:

  • a target record

  • a personal or team message destination

  • a message title

  • rich text message content

  • a link to open the related record

  • up to three action buttons tied to field values

Before you begin

To use Microsoft Teams Actionable Notifications, your workspace must have an active Microsoft 365 integration and the Microsoft Teams app configured in SmartSuite.


Installing the Microsoft Teams Integration

Follow the steps below to connect Microsoft Teams to SmartSuite.

1 - Connect your Office account

Sign in using your organization’s email to connect your Microsoft Office account. Microsoft Teams connection requires an existing O365 link up to exist

  • If users try to enable Microsoft Teams integration before it was fully configured user will see an error: “Teams integration is not ready to be enabled”

💡 This indicates that additional setup (app installation in Teams) is required before the integration can be enabled.

2 - Download the Teams app package

After successful connection:

  • Click Download Teams app zip

3 - Open Teams Admin Center

Click Open Teams Admin Center to proceed with app connection.

4 - Navigate to Manage Apps

In Microsoft Teams Admin Center:

  • Go to Teams apps

  • Open Manage apps

5 - Upload the app

In the Manage apps page:

  • Click Actions

  • Select Upload new app

6 - Install the app

  • Upload the previously downloaded .zip file

  • Wait for confirmation: “New app added”

7 - Complete integration

Once the app is successfully installed:

  • Return to SmartSuite

  • Enable Microsoft Teams integration (toggle will now work)


How to Configure Teams Actionable Notifications

1. Add the Microsoft Teams action

In Automations, add the Microsoft Teams action called Send an actionable notification. This action sends a Teams message with buttons that update a SmartSuite record when clicked.

2. Choose the target record

Select the single record the notification should reference and update. Supported sources include:

  • Trigger output

  • Single Find output

  • Current Item in a Loop

3. Select the message type

Choose whether to send the notification as a Personal message or a Team message.

Personal message

Use a personal message to notify one person directly in Teams.

You can define the recipient using either:

  • a static member selection

  • a dynamic value from your automation

Dynamic values can be matched by full name or email. If the value contains multiple entries, SmartSuite uses the first one only. For static selections, the member list is limited to users who have access to the target table and excludes view-only users such as Viewers, Commenters, and Guests.

Team message

Use a team message to post the notification to a Teams channel.

You will define:

  • a Team

  • a Channel

Both static and dynamic values are supported. If the Team is selected statically, SmartSuite shows only channels that belong to that Team. If the Team is provided dynamically, the Channel must also be provided dynamically.

Team and Channel values are limited to a single result, and if multiple values are returned, SmartSuite uses the first one. Channels are identified by channel name.

4. Enter the message title and content

Add a Message Title and Message Content for the notification. Both support static text and dynamic values. The title is required, and the message body is also required. The message body supports rich text formatting.

5. Add an Open Record link

You can include a link in the message so recipients can open the related SmartSuite record directly from Teams. This link supports dynamic values, making it possible to insert the correct record URL for each notification.

6. Configure the action buttons

Action buttons are based on a selected SmartSuite field. Supported field types are:

  • Status

  • Single Select

  • Multiple Select

  • Yes/No

You can add up to three buttons. For each button, configure:

  • the field value the button represents

  • the button label shown to the user

Each field choice can only be used once. If you do not enter a custom label, the button label inherits the selected field value. Button color is not supported in Microsoft Teams.


How it works

Once sent, the notification appears in the selected Teams channel or personal feed with the configured content and action buttons. Recipients can review the message and click one of the available buttons to trigger a record update in SmartSuite.

After a user clicks a button:

  • the action is submitted to SmartSuite

  • the notification is treated as executed

  • the same notification cannot be used again

If the action succeeds, the related record is updated. If it fails, the user can see a clear error message in Teams. Examples include permission errors, missing records, and timeout-related failures.

Permissions

SmartSuite checks whether the person who clicked the button has permission to edit the related record. If they do not, the action fails and returns an error.

Activity history and tracking

SmartSuite tracks the outcome of Actionable Notifications.

Successful actions are captured in the record’s activity history and can include the name of the person who clicked the button along with the automation name. Failed attempts can be added to the record as comments with details about the action and the reason it failed.

Example use case

A common use case is an approval workflow. For example, SmartSuite can send a Microsoft Teams notification asking someone to review a record. The recipient can click Approve or Reject directly in Teams, and SmartSuite updates the related field on the record based on that selection.


FAQ

Q. Can I send an Actionable Notification to a person instead of a channel?

A. Yes. You can choose a Personal message and send it to a single recipient.

Q. Can I post an Actionable Notification to a Teams channel?

A. Yes. Choose a Team message, then define the Team and Channel.

Q. Can I use dynamic values for recipients, teams, channels, and message content?

A. Yes. Dynamic values are supported for recipients, team and channel selection, message title, message body, button labels, and record links.

Q. How many action buttons can I add?

A. You can add up to three action buttons to a notification.

Q. What field types can be used for action buttons?

A. Action buttons can be based on Status, Single Select, Multiple Select, and Yes/No fields.

Q. Can a recipient click more than one button?

A. No. Once a button is clicked, the notification is considered executed and cannot be used again.

Q. What happens if the user does not have permission to update the record?

A. The action fails and SmartSuite returns an error instead of updating the record.

Q. Is activity from Actionable Notifications tracked in SmartSuite?

Yes. Successful updates can appear in the record activity history, and failed attempts can be logged on the record with the reason for failure.

Did this answer your question?