发送频道消息

Microsoft Teams 连接器中的“发送频道消息”活动。

项目兼容性

Windows | 跨平台

概述

描述	API 方法	API 路径
在 Microsoft Teams 频道中发送带有可选 SharePoint 文件附件的消息。	发布	/标准化团队/{team_id}/channels/{channel_id}/messages-v2/drive/items

输入

参数	描述	数据类型
团队 ID	团队的唯一标识符。输入团队名称，以从可用的下拉列表中检索，或输入自定义团队 ID。您可以从“按名称获取团队”活动的输出中检索 ID。	字符串
频道 ID	频道的唯一标识符。输入频道名称以从可用的下拉列表中检索，或输入频道 ID。您可以从“按名称获取频道”活动的输出中检索 ID。	字符串
消息正文	消息的文本内容	字符串
自适应卡 JSON	表示自适应卡内容的 JSON 负载。将 " 替换为 '，并删除所有包含 '' 的转义字符，例如 \n、\r。例如，将 "type" 替换为 "type"。有关详细信息，请参阅 Microsoft Teams API 文档和自适应卡文档。	字符串
图像	要包含在消息中的图像附件	文件
文件 ID（最多 20 个文件）	要附加到消息的一个或多个 SharePoint 文件 ID。您可以从“获取文件或文件夹”或“上传文件” （Microsoft 365 活动）的输出中检索此 ID。该字段支持“字符串”类型输入。	字符串数组
提及 ID	消息中提及的实体的索引，是将消息文本中的<at>标签链接到提及条目的数字标识符。必须匹配 HTML <at>标签中的id属性。可能的值： 0 、 1 、 2等	Int32
提及用户身份类型	上述用户的身份类型。常用值： member 、 aadUser 、 onPremiseAadUser 、 guest 。对于普通团队成员，默认值为member 。	字符串
提及者的用户 ID	上述用户的唯一标识符（AAD 用户的唯一标识符）。例如74a49af0-e4a2-43d6-9d83-52f5f0 。	字符串
提及中提到的用户显示名称	Azure AD 中提及的用户的完整显示名称。例如: John Doe	字符串
提及提及文本	在消息中用于提及用户的文本。应匹配<at>标签之间的文本。例如John Doe 。	字符串

输出

参数	描述	数据类型
消息 ID	已发送消息的唯一标识符	字符串
网页 URL	已发送消息的网页 URL	字符串
消息	API 返回的完整频道消息对象	对象

备注：

• 在 API 工作流中，系统会返回一个响应对象作为输出。任何必填字段均可直接从此对象中提取。
• 在 RPA 工作流中，某些输出参数可能有所不同，但即使未显式公开，仍可以从响应对象中检索必要的值。

使用用户提及

要在 Teams 频道消息中提及用户，您必须同时配置消息文本和提及属性。

备注：

当前不支持提及标签，只能提及用户。

1. 设置消息文本的格式。

使用带有id属性的 HTML <at>标签包括此提及：

"Hello <at id=\"0\">John Doe</at>, please review this."

2. 如下表中所示配置提及属性。

   属性	值	描述
   提及 ID	0	数字标识符（多次提及时递增）
   提及提及文本	John Doe	提及中显示的显示名称
   提及中提到的用户显示名称	John Doe	Azure AD 中的用户全名
   提及者的用户 ID	{AAD 对象 ID}	用户的 Azure AD 对象 ID（请参见下文）
   提及中提到的用户身份类型	成员	身份类型 (member/aadUser/guest)

要获取 Azure AD 对象 ID，请执行以下操作：

• Azure 门户- 导航到Azure Active Directory > “用户” > {User} > “复制对象 ID”（仅适用于 Azure门户）。
• Microsoft Graph API - GET https://graph.microsoft.com/v1.0/users/{userPrincipalName}
• PowerShell - Get-AzureADUser -ObjectId "[e-mail]" | Select ObjectId

提及用户“Jane Smith”的示例配置：

• 消息文本： "Task completed <at id=\"0\">Jane Smith</at>"
• 提及 ID ： 0
• 提及提及文本: "Jane Smith"
• 提及中提到的用户显示名称: "Jane Smith"
• 提及中提到的用户 ID ： "ef1c916a-3135-4417-ba27-8eb7bd084193"
• 提及中提到的用户身份类型： "member"
  备注：

  • 每个活动实例仅可提及一位用户。
  • <at>标签中的id必须与“提及 ID”属性匹配。
  • 不正确的 Azure AD 对象 ID 将导致提及失败。
  • 确保您的机器人/应用程序有权提及频道中的用户。