MS Teams Direct+

Documentation

Complete guide to setting up and using MS Teams Direct+

New to MS Teams Direct+? Start with our Quick Start Guide for a 5-minute walkthrough to send your first notification.

Getting Started

This documentation provides comprehensive information. If you prefer a streamlined setup guide, visit the Quick Start page.

1. Install from Monday.com Marketplace

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

2. Connect Microsoft Teams

  1. On the MS Teams Direct+ 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 MS Teams Direct+

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. MS Teams Direct+ uses these mappings to determine where to send notifications.

Automatic Email Matching

MS Teams Direct+ 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 MS Teams Direct+
  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 "MS Teams Direct+" 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

MS Teams Direct+ 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 MS Teams Direct+:

  1. Go to the "Activity" page in MS Teams Direct+
  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 MS Teams Direct+ 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 MS Teams Direct+
  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

MS Teams Direct+ 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 MS Teams Direct+ 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