【问题标题】:How long can messages be when posting to a Microsoft Teams connector webhook?发布到 Microsoft Teams 连接器 webhook 时,消息可以保留多长时间?
【发布时间】:2019-10-21 00:28:50
【问题描述】:

我将 CI/CD 系统的结果/日志发布到 Microsoft Teams。在处理一些结果较长的失败构建时,我偶然发现了 webhook URL https://outlook.office.com/webhook/bb6bfee7-1820-49fd-b9f9-f28f7cc679ff@<uuid1>/IncomingWebhook/<id>/<uuid2> 返回的以下错误:

Webhook message delivery failed with error: Microsoft Teams endpoint returned HTTP error 413 with ContextId tcid=3626521845697697778,server=DB3PEPF0000009A,cv=BmkbJ1NdTkv1EDoqr7n/rg.0..

据我观察,这是由于发布到 Teams webhook URL 的有效负载过长造成的。

当 JSON 负载超过 18000 个字符时,初始复杂消息(部分、标题、副标题、格式化链接、<pre> 格式化文本等)失败。

对有效负载进行一些测试后发现,我从原始 JSON 有效负载中删除的格式越多,Teams 消息的时间就越长。我可以发布的最长消息(根据 cu cURL):Content-Length: 20711。此消息的 JSON 有效负载是:

{"themeColor":"ED4B35","text":"a....a"}

JSON 格式的空格似乎不算数(即添加空格不会减少我可以发送到 Teams webhook 的最大消息长度)。

作为参考,最初的消息与此类似:

{
    "themeColor": "ED4B35",
    "summary": "iris-shared-libs - shared-library-updates - failure",
    "sections": [
        {
            "activityTitle": "Job: [iris-shared-libs](https://my.concourse.net/teams/hsm/pipelines/iris-shared-libs) - [shared-library-updates #89](https://my.concourse.sccloudinfra.net/teams/hsm/pipelines/iris-shared-libs/jobs/shared-library-updates/builds/89) (FAILURE)",
            "activityImage": "https://via.placeholder.com/200.png/ED4B35/FFFFFF?text=F",
            "facts": [
                {
                    "name": "Failed step",
                    "value": "update-shared-libraries"
                }
            ]
        },
        {
            "text": "Trying a new strategy with gated versioned releases",
            "facts": [
                {
                    "name": "Repository",
                    "value": "[iris-concourse-resources](https://my.git.com/projects/IRIS/repos/iris-concourse-resources)"
                },
                {
                    "name": "Commit",
                    "value": "[2272145ddf9285c9933df398d63cbe680a62f2b7](https://my.git.com/projects/IRIS/repos/iris-concourse-resources/commits/2272145ddf9285c9933df398d63cbe680a62f2b7)"
                },
                {
                    "name": "Author",
                    "value": "me@company.com"
                }
            ]
        },
        {
            "activityTitle": "Job failed step logs part 1",
            "text": "<pre>...very long log text goes here ...</pre>"
        }
    ]
}

Microsoft Teams 连接器 webhook 发布消息的实际最大长度是多少?

official page 没有提及。在底部的反馈部分中,仍有一个关于“邮件大小限制?”的悬而未决的问题。反馈:“我们目前正在对此进行调查。”

【问题讨论】:

标签: json limit webhooks microsoft-teams payload


【解决方案1】:

从我目前所做的测试来看,观察到的一些限制(如果这与服务器无关)大致基于 JSON 消息有效负载(结构和格式)在 18000 到 40000 之间(使用长度低于 18000 永远不会断,超过 40000 总是断)。

  • 用例 18000:一段长文本
  • 用例 40000:600 个事实,名称非常短,值为空字符串

删除 JSON 有效负载的片段并在另一个 JSON 值中添加相同数量的字符不会得到相同的最大值。

我观察到最大部分数的软限制(消息被截断,但没有错误):10。从第 11 个开始的部分将被丢弃。

【讨论】:

  • 如果是安卓手机应用,我们可以看到10多段没有截断的消息。我们在桌面应用上看到的截断
猜你喜欢
  • 1970-01-01
  • 2016-11-06
  • 1970-01-01
  • 1970-01-01
  • 2018-04-07
  • 1970-01-01
  • 2020-09-05
  • 2021-03-20
  • 2013-10-01
相关资源
最近更新 更多