使用Webhook与Power Automate发送Teams通知的格式及链接问题求助

• 现有Azure DevOps流水线功能：扫描KeyVault，检测已过期/即将过期的Secrets/Certificates，向指定Teams频道发送通知。
• 遇到的问题：
  • 采用新工作流通过Webhook Request发送通知时，出现格式变形问题；
  • 按建议修改后，多余内容消失，但密钥对应的链接无法点击（即使启用代码视图保存配置，刷新后仍自动变回普通模式，链接失效）。
• 已提供排查材料：PowerShell函数代码、工作流配置信息、通知效果截图。

1. 改用Teams标准卡片格式发送Webhook请求 #

Teams Webhook对普通Markdown的支持有限，尤其是链接解析，必须使用官方规范的MessageCard或AdaptiveCard JSON格式才能保证格式和交互正常。

示例PowerShell代码片段（替换原有Webhook请求逻辑）

# 初始化消息卡片结构
$messageCard = @{
    "@type" = "MessageCard"
    "@context" = "http://schema.org/extensions"
    "summary" = "KeyVault过期资源告警"
    "themeColor" = "E81123"
    "sections" = @(
        @{
            "activityTitle" = "⚠️ KeyVault存在已过期/即将过期的资源"
            "facts" = @()
        }
    )
}

# 遍历过期资源，添加到卡片并生成可点击链接
foreach ($resource in $expiredResources) {
    # 向卡片事实列表添加资源信息，链接采用HTML格式（兼容MessageCard）
    $messageCard.sections[0].facts += @{
        "name" = "$($resource.Type): $($resource.Name)"
        "value" = "<a href='$($resource.KeyVaultPortalUrl)'>在Azure门户查看</a>"
    }
}

# 发送Webhook请求
$teamsWebhookUrl = "你的Teams频道Webhook URL"
$jsonPayload = ConvertTo-Json $messageCard -Depth 10
Invoke-RestMethod -Uri $teamsWebhookUrl -Method Post -Body $jsonPayload -ContentType "application/json"

2. 修复链接不可点击问题 #

• 禁止在Teams手动编辑通知内容：所有通知内容必须通过Webhook的JSON payload直接发送，避免Teams自动将HTML链接转义为普通文本；
• 确保JSON payload格式正确：使用ConvertTo-Json时指定足够的Depth参数（如-Depth 10），避免嵌套结构被截断；
• 验证URL有效性：确保生成的KeyVault资源URL是完整可访问的（如https://portal.azure.com/#view/Microsoft_Azure_KeyVault/KeyVaultItemDetailsBlade/...）。

3. 流水线配置校验 #

在DevOps流水线的PowerShell任务中添加JSON格式验证步骤，避免无效payload导致的格式问题：

$jsonPayload = ConvertTo-Json $messageCard -Depth 10
if (Test-Json -Json $jsonPayload) {
    Write-Host "JSON格式验证通过，发送通知..."
    Invoke-RestMethod -Uri $teamsWebhookUrl -Method Post -Body $jsonPayload -ContentType "application/json"
} else {
    Write-Error "消息卡片JSON格式错误，终止通知发送"
    exit 1
}

如果自定义流水线维护成本高，可直接使用Azure原生告警能力：

• 配置KeyVault的过期资源警报规则：在Azure门户的KeyVault资源中，创建针对SecretNearExpiry/CertificateNearExpiry/SecretExpired/CertificateExpired事件的警报；
• 通过动作组关联Teams Webhook：触发警报时，自动发送符合Teams格式的通知，链接原生支持点击，无需自定义代码。

内容的提问来源于stack exchange，提问作者Sumit Bhardwaj