您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

将机器人连接到 Office 365 电子邮件

适用于: SDK v4

除了其他通道,机器人还可以通过 Office 365 电子邮件与其他用户通信。 当机器人经过配置,可以访问电子邮件时,如果有新邮件到达,它会收到一条消息。 然后机器人可以按照其业务逻辑做出响应。 例如,机器人可能发送确认电子邮件已收到的电子邮件回复,邮件内容为“你好! 感谢你下达的订单! 我们将立即开始处理。”

警告

创建“spambots”(包括发送不需要或未经请求的批量电子邮件的机器人)将被视为违反 Bot Framework 行为准则

备注

如果使用 Microsoft Exchange Server,请确保先启用自动发现,然后再配置电子邮件通道。

配置电子邮件凭据

可以通过在电子邮件通道配置中输入 Office 365 凭据,将机器人连接到电子邮件通道。 不支持使用任何替换 AAD 的供应商的联合身份验证。

备注

不应该将自己的个人电子邮件帐户用于机器人,因为发送到该电子邮件帐户的每个邮件都将转发给机器人。 这可能导致机器人不恰当地向发件人发送响应。 因此,机器人应仅使用专用的 O365 电子邮件帐户。

若要添加电子邮件通道,在 Azure 门户中打开机器人,单击“通道” 边栏选项卡,然后单击“电子邮件” 。 输入有效的电子邮件凭据,然后单击“保存” 。

输入电子邮件凭据

电子邮件通道当前仅使用 Office 365。 目前不支持其他电子邮件服务。

自定义电子邮件

电子邮件通道支持发送自定义值,以使用 活动属性创建更高级、自定义 channelData 的电子邮件。 以下代码片段显示了从机器人到用户的 channelData 传入自定义电子邮件的 的示例。

properties 说明
htmlBody 用于邮件正文的 HTML。
subject 用于邮件的主题。
importance 用于邮件的重要性标志:lownormalhigh
toRecipients 添加到邮件“收件人”字段的用分号 (;) 分隔的电子邮件地址字符串。
ccRecipients 添加到邮件“Cc(抄送)”字段的用分号 (;) 分隔的电子邮件地址字符串。
bccRecipients 添加到邮件“Bcc(密件抄送)”字段的用分号 (;) 分隔的电子邮件地址字符串。

有关 活动属性的信息 channelData ,请参阅 创建自定义电子邮件

其他注意事项

如果机器人没有在 15 秒内返回 HTTP 状态代码“200 正常”作为对传入电子邮件的响应,则电子邮件通道会尝试重新发送该邮件,因此机器人可能会多次收到同一电子邮件活动。 有关详细信息,请参阅 机器人工作原理 一文和 如何排查超时错误一文中的 HTTP 详细信息部分。

备注

如果使用的是启用了 MFA 的 Office 365 帐户,请确保先为指定的帐户禁用 MFA,然后再为电子邮件通道配置帐户。 否则,连接将失败。

其他资源