传统集成活动

上次更新日期 2025年9月22日

获取消息

“获取消息” 活动调用 Microsoft Graph 获取频道消息或获取聊天消息 API

从聊天 (ChatId) 或频道 (ChannelId) 和团队 (TeamID) 中检索指定的消息 (MessageId )。

执行搜索后，该活动会在 ChatMessage 对象 (消息) 中输出其属性，您可以在后续活动中将其用作输入变量（例如，获取消息回复、回复消息等中的ChatMessage.Id ）。

此活动与获取消息活动之间的区别在于要求输入特定消息 ( 消息ID)。通过输入消息 ID ，您可以检索特定的 ChatMessage 对象，而不是在 获取消息 活动中返回的对象数组。

以下步骤和消息序列图是活动从设计时（即活动依赖项和输入/输出属性）到运行时如何工作的示例。

A. 添加活动或运行输出 Chat.Id 值的外部流程（例如，获取聊天记录）。

B. 添加活动或运行输出 Team.Id 值的外部流程（例如，获取团队）以及输出 Channel.Id 值的活动或外部流程（例如，获取渠道）。

将此活动添加到 UiPath Studio 中的项目时，会指定以下属性的值。

活动的显示名称。

包含要从中获取消息的频道的 Team 对象的 ID。

属性	详细信息
类型	`String`
必填	是（如果 ChatId 为空）
默认值	空白
允许的值	输入 `String` 或 `String` 变量。
注意	要获取 `Team.Id` 值，请使用输出中包含 `Team.Id` 值的外部流程或活动（例如，获取团队或外部 API 调用） (ChatId) 或 (TeamId 和 ChannelId) 为必填项。

要从中获取消息的 Channel 对象的 ID。

属性	详细信息
类型	`String`
必填	是（如果团队 ID 具有值）
默认值	空白
允许的值	输入 `String` 或 `String` 变量。
注意	要获取 `Channel.Id` 值，请使用输出中包含 `Channel.Id` 值的外部流程或活动（例如，获取渠道或外部 API 调用） (ChatId) 或 (TeamId 和 ChannelId) 为必填项。

要向其发送消息的 Chat 对象的 ID。

属性	详细信息
类型	`String`
必填	是（如果团队 ID 和渠道 ID 为空）
默认值	空白
允许的值	输入 `String` 或 `String` 变量。
注意	要获取 `Chat.Id` 值，请使用输出中包含 `Chat.Id` 值的外部流程或活动（例如，获取聊天或外部 API 调用） (ChatId) 或 (TeamId 和 ChannelId) 为必填项。

要检索的消息的 ID。

属性	详细信息
类型	`String`
必填	是
默认值	空白
允许的值	输入 `String` 或 `String` 变量。
注意	要获取 `Message.Id` 值，请使用输出中包含 `Message.Id` 值的外部流程或活动（例如，获取消息或外部 API 调用）。

如果已选择，变量和参数的值将不会在 Verbose 级进行记录。

ChatMessage 对象，表示“消息 ID ” 属性中指定的消息。

属性	详细信息
类型	`ChatMessage`
必填	否（如果您计划在后续活动中使用输出数据，则为必填项）
默认值	空白
允许的值	输入`ChatMessage`变量。
注意	您为此属性创建的变量可用作后续活动（例如，获取消息回复、回复消息等）中的输入变量。 `ChatMessage` 对象包含多个可在其他活动中使用的属性。下面的示例图像显示了您可以返回的一些属性。注意 - 设计器中列出的某些属性不适用于 `ChatMessage` 对象（例如`ODatatType` ）。有关适用的 `Team` 属性的列表，请访问上面的链接。