邮件格式设置可以使机器人邮件发挥出最佳效果。 可以设置机器人消息的格式,以将富卡作为包含交互式元素(如按钮、文本和图像)的附件包含在内。
注意
关于机器人消息大小限制:
- 机器人消息大小限制为 100 KB:
- 100 KB 是一个大致限制,因为它包括消息本身 (文本、图像链接等 ) 、@-提及和编码为 UTF-16 的反应。 此 100 KB 大小限制不包括 base64 编码的图像。
- 在实现过程中,建议确保消息本身的大小在 80 KB 以内,以确保消息成功传递。
- 如果机器人消息超出大小限制,机器人会收到状态
413代码 (RequestEntityTooLarge) ,其中包含错误代码MessageSizeTooBig。
设置文本内容格式
若要设置机器人邮件的格式,可以设置可选 TextFormat 属性以控制机器人邮件文本内容的呈现方式。
Microsoft Teams 支持以下格式设置选项:
TextFormat 值 |
说明 |
|---|---|
plain |
文本必须被视为原始文本,不应用任何格式。 |
markdown |
文本必须被视为 Markdown 格式,并根据需要在通道上呈现。 |
xml |
文本是简单的 XML 标记。 |
Teams 支持和 xml 或 HTML 格式标记的markdown子集。 机器人还可以在频道中发布的文本消息中提及其他用户和标记。 有关详细信息,请参阅 向邮件添加提及。
以下限制适用于格式设置:
- 纯文本消息不支持表格格式设置。
- 丰富卡片仅支持在文本属性中进行格式设置,不支持在标题或副标题属性中进行格式设置。
- 富卡不支持 Markdown 或表格格式。
设置文本内容格式后,请确保你的格式适用于 Teams 支持的所有平台。
跨平台支持
并非所有平台都支持某些样式。 下表提供了样式列表,其中列出了哪种样式在仅文本的邮件和丰富卡片中受支持:
| 样式 | 仅文本邮件 | 丰富卡片 - 仅 XML |
|---|---|---|
| 粗体 | ✔️️ | ❌ |
| 斜体 | ✔️ | ✔️ |
| 标头 (级别 1-3) | ❌ | ✔️ |
| 删除线 | ❌ | ✔️ |
| 水平规则 | ❌ | ❌ |
| 未排序列表 | ❌ | ✔️ |
| 已排序列表 | ❌ | ✔️ |
| 预设格式的文本 | ✔️ | ✔️ |
| Blockquote | ✔️ | ✔️ |
| Hyperlink | ✔️ | ✔️ |
| 图像链接 | ❌ | ❌ |
检查跨平台支持后,请确保单个平台的支持也可用。
单个平台的支持
对文本格式设置的支持因消息和平台的类型而异。
仅文本邮件
下表提供了样式列表,其中列出哪些样式在桌面、iOS 和 Android 上受支持:
| 样式 | 桌面 | iOS | Android |
|---|---|---|---|
| 粗体 | ✔️ | ✔️ | ✔️ |
| 斜体 | ✔️ | ✔️ | ✔️ |
| 标头 (级别 1-3) | ❌ | ❌ | ❌ |
| 删除线 | ✔️ | ✔️ | ❌ |
| 水平规则 | ❌ | ❌ | ❌ |
| 未排序列表 | ✔️ | ❌ | ❌ |
| 已排序列表 | ✔️ | ❌ | ❌ |
| 预设格式的文本 | ✔️ | ✔️ | ✔️ |
| Blockquote | ✔️ | ✔️ | ✔️ |
| Hyperlink | ✔️ | ✔️ | ✔️ |
| 图像链接 | ❌ | ❌ | ❌ |
AI 生成的内容消息
机器人消息中的 AI 标签、引文、反馈按钮和敏感度标签可提高用户参与度并提高透明度和信任度。
- AI 标签 使用户能够识别消息是使用 AI 生成的。
- 引文 使用户能够通过文本内引文和引用来引用机器人的消息源。
- “反馈”按钮 使用户能够向机器人的消息提供正面或负面反馈。
- 敏感度标签 使用户能够了解机器人消息的机密性。
有关详细信息,请参阅 具有 AI 生成内容的机器人消息。