发送个人聊天消息

项目兼容性

Windows | 跨平台

概述

描述	API 方法	API 路径
在 Microsoft Teams 中创建一个私人聊天，并提供从 SharePoint 附加文件的选项。	发布	/create-chat/individual-chat-messages-v2

输入

参数	描述	数据类型
发送方式	用于发送消息的模式（电子邮件或聊天）	枚举
聊天 ID	私人聊天的唯一标识符。您可以输入48:notes ，向自己发送消息。注意： 48:notes解决方法未经 Microsoft 官方记录，可能会发生变化。此字段支持String类型输入。	字符串
UPN（用户主体名称）	参与者的用户主体名称。这应该是登录 Azure AD 和其他 Office 服务的唯一用户。在极少数情况下，Azure AD 管理员可以为 UPN 设置其他值。	字符串
用户角色	用户在聊天中的角色（所有者或成员）	枚举
消息正文	消息的文本内容	字符串
自适应卡 JSON	表示自适应卡内容的 JSON 负载。将\"替换为' ，并删除所有包含'\'转义字符，例如\n 、 \r 。例如，将\r\n\"type\"替换为'type' 。有关详细信息，请参阅 Microsoft Teams API 文档和自适应卡文档。	字符串
图像	要包含在消息中的图像附件	文件
文件 ID（最多 20 个文件）	要附加到消息的一个或多个 SharePoint 文件 ID。您可以从“获取文件或文件夹”或“上传文件” （Microsoft 365 活动）的输出中检索此 ID。此字段支持String类型的输入。	字符串数组
提及 ID	消息中提到的实体的索引	Int32
提及用户身份类型	提及用户的身份类型	字符串
提及中提到的用户显示名称	提及用户的显示名称	字符串
提及者的用户 ID	提及用户的唯一标识符	字符串
提及 ID	消息中提及的实体的索引，是将消息文本中的 <at> 标签链接到提及条目的数字标识符。必须匹配 HTML <at>标签中的id属性。可能的值： 0 、 1 、 2等	Int32
提及用户身份类型	上述用户的身份类型。常用值：成员、 aadUser 、 onPremiseAadUser 、 guest 。普通团队成员的默认值为member 。	字符串
提及者的用户 ID	上述用户的唯一标识符（AAD 用户的唯一标识符）。例如74a49af0-e4a2-43d6-9d83-52f5f0 。	字符串
提及中提到的用户显示名称	Azure AD 中提及的用户的完整显示名称。例如: John Doe	字符串
提及提及文本	在消息中用于提及用户的文本。应匹配 <at> 标签之间的文本。例如John Doe 。	字符串

输出

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

备注：

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