StatusRoute

Documentation

Complete guide to setting up and using StatusRoute

Getting Started

1. Install from Monday.com Marketplace

  1. Go to the Monday.com Marketplace and search for "StatusRoute"
  2. Click "Install" and select your workspace
  3. Review the permissions and click "Authorize"
  4. You'll be redirected to the StatusRoute setup page

2. Connect Microsoft Teams

  1. On the StatusRoute dashboard, click "Connect Teams Account"
  2. Sign in with your Microsoft Teams account
  3. Grant permissions to send messages on your behalf
  4. You'll be redirected back to StatusRoute

Permissions tip: The first installation should be performed by a tenant admin and consent should be granted for the organization so teammates can use the integration without extra approvals.

Note: You need admin permissions in both Monday.com and Microsoft Teams to complete the setup.

User Mapping

User mapping connects Monday.com users to Microsoft Teams users. StatusRoute uses these mappings to determine where to send notifications.

Automatic Email Matching

StatusRoute automatically matches users when their email addresses are identical in Monday.com and Teams. This happens in the background and requires no action from you.

Manual Mapping

For users with different email addresses or when automatic matching fails:

  1. Go to the "User Mappings" page in StatusRoute
  2. Click "Add Mapping"
  3. Select the Monday.com user from the dropdown
  4. Select the corresponding Teams user
  5. Click "Save"

CSV Bulk Import

To import many user mappings at once:

  1. Create a CSV file with two columns: monday_email and teams_email
  2. Add one mapping per row
  3. Go to "User Mappings" and click "Import CSV"
  4. Upload your file and click "Import"

Example CSV:

monday_email,teams_email
[email protected],[email protected]
[email protected],[email protected]

Creating Automations in Monday.com

Basic Notification Automation

  1. Open your Monday.com board
  2. Click "Integrate" in the top menu
  3. Search for "StatusRoute" in the integrations list
  4. Select "When person is assigned, send notification to Teams"
  5. Configure your trigger (e.g., "When person changes")
  6. Customize your message using placeholders
  7. Click "Create Automation"

Available Placeholders

You can use these placeholders in your notification messages:

  • {board_name} - The name of the board
  • {group_name} - The group the item belongs to
  • {item_name} - The name of the item
  • {assignee_name} - The name of the assigned person
  • {item_url} - Direct link to the item in Monday.com

Example message:

You've been assigned to {item_name} in {board_name}. Click here to view: {item_url}

Sending to Channels

To send notifications to a Teams channel instead of a user:

  1. In your Monday.com automation, select "Send to channel" instead of "Send to assigned user"
  2. Choose the Teams channel from the dropdown
  3. Customize your message
  4. Save the automation

Notification Format

StatusRoute sends notifications as Adaptive Cards in Microsoft Teams. Each notification includes:

  • Header: Board name and group
  • Title: Item name (clickable link to Monday.com)
  • Message: Your custom message with placeholders replaced
  • Action button: "View in Monday.com" direct link

Notifications appear as 1:1 messages in the Teams chat, so users can respond or dismiss them just like any other message.

Activity Log

The Activity Log shows a record of all notifications sent through StatusRoute:

  1. Go to the "Activity" page in StatusRoute
  2. View recent notifications with status (Sent, Failed, No Mapping)
  3. Filter by date, user, or status
  4. Click any entry to see full details

Activity logs are retained for 90 days.

Troubleshooting

Notification not received

Check these common issues:

  • Verify the user mapping exists (User Mappings page)
  • Confirm the automation is active in Monday.com
  • Check the Activity Log for error messages
  • Ensure the Teams user has granted permissions
  • Verify the user isn't blocking bot messages in Teams

"No mapping found" error

This means StatusRoute couldn't find a Teams user for the Monday.com assignee:

  1. Go to User Mappings
  2. Create a manual mapping for this user
  3. Or add their email to your CSV import file
  4. The next notification will use the new mapping

Authentication expired

If you see an authentication error:

  1. Go to Settings in StatusRoute
  2. Click "Reconnect Monday.com" or "Reconnect Teams"
  3. Sign in again to refresh your credentials

Notifications are delayed

Slight delays can occur due to:

  • Monday.com automation queue processing
  • Microsoft Teams API rate limits
  • High volume of notifications

Typical delivery time is under 5 seconds. If delays exceed 1 minute, check the Activity Log or contact support.

Security & Permissions

Required Monday.com Permissions

  • Read board data (to get item details)
  • Read user information (to identify assignees)
  • Access automations (to receive triggers)

Required Microsoft Teams Permissions

  • Send messages as user (Chat.ReadWrite)
  • Read user profiles (User.Read.All)

You can revoke these permissions at any time through Monday.com or Microsoft Teams settings.

Limits & Quotas

  • User mappings: Unlimited
  • Notifications per day: Based on your subscription plan
  • Activity log retention: 90 days
  • CSV import size: Up to 10,000 rows
  • Automation counts: monday.com may count automation evaluations even when conditions fail and nothing is delivered; factor that into your quota planning.

Data & Privacy

StatusRoute stores:

  • User mapping data (Monday.com email ↔ Teams email)
  • OAuth tokens (encrypted)
  • Activity logs (90 day retention)
  • Notification content (transient, not permanently stored)

See our Privacy Policy for complete details.

Support

Need help? We're here for you:

  • Chat: Use our chat feature at the bottom right of the website. It connects you to a live person if we're online, or emails a live person if we're offline—no AI chatbot.
  • FAQ: Frequently Asked Questions
  • Response time: Within 24 hours on business days

Updates & Changelog

We regularly improve StatusRoute based on user feedback. Major updates will be announced via:

  • Email to all administrators
  • In-app notifications
  • Monday.com Marketplace listing

Last updated: December 09, 2025