Microsoft Teams Post

Send messages and Adaptive Cards to Microsoft Teams channels using Incoming Webhook URLs.

Prerequisites

Users need a Webhook URL from Teams. Guide them to create one if missing:

1. In Teams, go to the target channel
2. Open Workflows app (search from Apps or click three dots below input)
3. Find template: "Post to a channel when a webhook request is received"
4. Name the workflow (e.g., "CLI Notification Bot")
5. Select target Team and Channel
6. Copy the generated HTTP POST URL

Quick Start

The bundled script scripts/send_teams.py handles all message types.

python3 scripts/send_teams.py <WEBHOOK_URL> --text "Hello Teams!"

Message Types

Simple Text Message

For basic notifications and alerts.

python3 scripts/send_teams.py <WEBHOOK_URL> -t "🚀 Deployment completed successfully"

Adaptive Card

For rich formatted cards with titles, facts, images, and buttons. Pass JSON as string or file.

Inline JSON:

python3 scripts/send_teams.py <WEBHOOK_URL> -c '{
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "version": "1.4",
  "body": [
    {
      "type": "TextBlock",
      "text": "Build Report",
      "weight": "Bolder",
      "size": "Medium"
    },
    {
      "type": "FactSet",
      "facts": [
        {"title": "Project", "value": "Backend API"},
        {"title": "Status", "value": "✅ Success"},
        {"title": "Duration", "value": "45s"}
      ]
    }
  ]
}'

From JSON file:

python3 scripts/send_teams.py <WEBHOOK_URL> -c card.json

Raw Payload

For custom message structures not covered by text or card modes.

python3 scripts/send_teams.py <WEBHOOK_URL> -r '{"type": "message", "text": "Custom"}'

Common Patterns

Build/Deployment Notification

python3 scripts/send_teams.py <WEBHOOK_URL> -c '{
  "type": "AdaptiveCard",
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.4",
  "body": [
    {"type": "TextBlock", "text": "Deployment Notification", "weight": "Bolder", "size": "Medium"},
    {"type": "TextBlock", "text": "Project: my-app deployed to production", "wrap": true}
  ],
  "actions": [
    {"type": "Action.OpenUrl", "title": "View Logs", "url": "https://ci.example.com/logs/123"}
  ]
}'

Alert with Facts

python3 scripts/send_teams.py <WEBHOOK_URL> -c '{
  "type": "AdaptiveCard",
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.4",
  "body": [
    {"type": "TextBlock", "text": "⚠️ Alert Summary", "weight": "Bolder"},
    {
      "type": "FactSet",
      "facts": [
        {"title": "Severity", "value": "High"},
        {"title": "Service", "value": "api-gateway"},
        {"title": "Time", "value": "2026-01-23 09:45:00 UTC"}
      ]
    }
  ]
}'

Script Reference

scripts/send_teams.py

Argument	Description
webhook_url	Teams Incoming Webhook URL (required positional)
-t, --text TEXT	Send simple text message
-c, --card CARD	Send Adaptive Card (JSON string or .json file)
-r, --raw RAW	Send raw custom payload (JSON string or .json file)
-v, --verbose	Enable verbose output

Exit codes: 0 on success, 1 on failure.

Error Handling

The script reports errors clearly:

• ❌ HTTP Error: 401 - Invalid webhook URL
• ❌ HTTP Error: 400 - Malformed JSON or invalid card schema
• ❌ URL Error - Network connectivity issue
• ✅ Message sent successfully - Confirmed delivery

For 4xx errors, the response body is printed to help diagnose schema issues.

Suspended Workflow

If you receive errors indicating the workflow is "suspended" or "inactive":

1. Open Power Automate in your browser:

   • https://make.powerautomate.com
   • OR your org's URL: https://.powerautomate.com

2. Go to My flows / Workflows

3. Find your workflow (look for "Suspended" status)

4. Click → Resume / Activate / Turn on

5. Retry sending your message