Microsoft Teams Integration

IntuitivePM integrates with Microsoft Teams through incoming webhooks. Configure Teams centrally in the Integration Hub, then assign the Teams channel to Virtual Colleagues or automation features that should use it.

Virtual Colleague reports and notifications are delivered as Adaptive Cards — rich, structured messages that display cleanly in Teams channels.

How It Works

When a Virtual Colleague runs a scan, IntuitivePM sends an Adaptive Card payload to the Teams notification channel assigned to that colleague. The card includes:

• A bold heading with the subject or colleague name and action type.
• The colleague’s name and role displayed in a column layout.
• The full message body with word wrapping enabled.

Teams renders the card natively, so messages look professional and are easy to read on desktop, mobile, and the Teams web app.

Adaptive Cards Format

IntuitivePM sends messages using Adaptive Cards v1.4, the modern format supported by Teams Workflows connectors. Each message contains:

{
  "type": "message",
  "attachments": [{
    "contentType": "application/vnd.microsoft.card.adaptive",
    "content": {
      "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
      "type": "AdaptiveCard",
      "version": "1.4",
      "body": [
        { "type": "TextBlock", "size": "Medium", "weight": "Bolder",
          "text": "Sprint Health Report", "style": "heading" },
        { "type": "ColumnSet", "columns": [{ "type": "Column",
          "width": "auto", "items": [
            { "type": "TextBlock", "weight": "Bolder",
              "text": "Sprint Analyst" },
            { "type": "TextBlock", "spacing": "None",
              "text": "Virtual Colleague — Scrum Master",
              "isSubtle": true }
          ]}]},
        { "type": "TextBlock", "text": "Report content here...",
          "wrap": true }
      ]
    }
  }]
}

Note: IntuitivePM uses the Adaptive Cards format (not the older MessageCard/O365 Connector format). This is compatible with the Teams Workflows connector, which Microsoft recommends for all new integrations.

Prerequisites

• A Microsoft Teams workspace where you have permission to add connectors or create workflows.
• An IntuitivePM account with admin or project manager permissions.

Setting Up the Teams Connection

Step 1: Create a Workflows Webhook in Teams

Microsoft recommends using Workflows (Power Automate) for incoming webhooks. The legacy O365 Connector method is being retired.

1. Open Microsoft Teams and navigate to the channel where you want to receive messages.
2. Click the … menu next to the channel name.
3. Select Workflows (or Manage channel > Connectors in older versions).
4. Search for “Post to a channel when a webhook request is received” and select it.
5. Name the workflow (e.g., “IntuitivePM Notifications”).
6. Confirm the channel and click Add workflow.
7. Teams generates a webhook URL. Copy it to your clipboard.

The URL will look something like:

https://prod-XX.westus.logic.azure.com:443/workflows/XXXXXXXX/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=XXXXXXXX

Step 2: Add the Webhook to the Integration Hub

1. In IntuitivePM, navigate to System → Integrations → Integration Hub.
2. Open Microsoft Teams.
3. Create a notification channel.
4. Paste the webhook URL into the channel configuration.
5. Click Test. A test Adaptive Card should appear in your Teams channel.
6. Assign the channel to the Virtual Colleague or automation that should use it.

Step 3: Verify the Integration

After saving, trigger a manual scan or wait for the next scheduled run. Check your Teams channel to confirm the Adaptive Card renders correctly with the colleague’s name, role, and message content.

Message Types

Virtual Colleagues deliver the same report types to Teams as they do to other channels:

Troubleshooting

Next Steps

• For step-by-step configuration instructions, see Teams Integration Configuration.
• Set up Slack as an additional channel with the Slack Integration guide.
• Configure email notifications in Email Setup.