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.