Webhook JSON 支持 Groups 和 Teams vs Outlook？

Question

使用 Microsoft Teams 文档 here and following the hyperlink titled "Office 365 Connectors API Reference", which links to https://dev.outlook.com/Connectors/Reference but redirects to: https://docs.microsoft.com/en-us/outlook/actionable-messages/card-reference 我们最终得到一个标题为 "Actionable message card reference" 的页面。

这是一份非常有用的文档，列出了我们可以在 JSON 字符串中使用的所有字段，以创建可操作的联系人卡片，以推送到 Office 365 生态系统中的各种 webhook 连接器。

在 https://messagecardplayground.azurewebsites.net/ 使用 JSON 验证器我构建并测试了以下内容：

{
   "title":"New Office 365 Group: Success",
   "text":"Performed by: someuser",
   "themeColor":"00e600",
   "sections":[
      {
         "title":"Section Title"
      },
      {
         "facts":[
            {
               "name":"Name",
               "value":"PRJ000001"
            }
         ]
      },
      {
         "potentialAction":[
            {
               "@context":"http://schema.org",
               "@type":"ViewAction",
               "name":"View Log",
               "target":"something"
            }
         ]
      }
   ]
}

这是有效的并且在该站点上正确呈现，但是当尝试将它发送到 Office 365 组邮箱或团队频道时，我收到错误：

Bad payload received by generic incoming webhook.

如果我们采用更简单的 JSON 构造，它适用于 O365 组邮箱和团队频道：

{
   "title":"New Office 365 Group: Success",
   "text":"Performed by: someuser",
   "themeColor":"00e600",
   "potentialAction":[
      {
         "@context":"http://schema.org",
         "@type":"ViewAction",
         "name":"View Log",
         "target":[
            "https://link/to/log"
         ]
      }
   ]
}

似乎文档在服务之前，或者 Groups 和 Teams webhook 连接器不支持完整的选项列表，也许这只适用于 Outlook？有什么想法吗？

谢谢。

Answer 1

这里有一些建议：

您应该包含必需的 summary 属性，即使文档没有说明。我们会解决这个问题。
尝试用 OpenUri 操作替换您的 ViewAction。 ViewAction 已弃用。尽管仍然支持 ViewAction，但我们希望鼓励大家改用 OpenUri。

Answer 2

现在不支持负载中提到的ViewAction。您应该将其替换为 OpenUri 操作。您可以在我们的文档中找到更多信息：https://docs.microsoft.com/en-us/outlook/actionable-messages/card-reference

请使用以下负载，它应该可以正常工作。

{
"title": "New Office 365 Group: Success",
"text": "Performed by: someuser",
"themeColor": "00e600",
"sections": [{
        "title": "Section Title"
    }, {
        "facts": [{
                "name": "Name",
                "value": "PRJ000001"
            }
        ]
    }, {
        "potentialAction": [
            {
                "@context": "http://schema.org",
                "@type": "OpenUri",
                "name": "View Log",
                "targets": [{
                        "os": "default",
                        "uri": "http://..."
                    }
                ]
            }
        ]
    }
]
}

如果您运行遇到任何其他问题，请告诉我们。

Webhook JSON 支持 Groups 和 Teams vs Outlook？

Webhook JSON support for Groups and Teams vs Outlook?

office365

office365connectors