Bot connector API:能否直接向aadObjectId发送机器人消息
基于Bot Connector API向指定aadObjectId定向发消息的实现说明
核心结论
不存在仅靠aadObjectId就可以直接调用Bot Connector API发消息、完全无任何会话上下文要求的现成接口能力,但可以通过可落地的工程方案,实现绕开常规“用户主动发消息触发实时会话路由”流程的定向消息投递效果。
接口设计的原生约束
- Bot Connector API的消息投递逻辑强依赖完整的会话地址对象,这个对象属于活动(Activity)结构的必填组成部分,需要携带渠道类型、会话ID、服务端点地址、租户ID等核心路由信息才能完成消息投递。
- 单纯的aadObjectId是Azure AD体系下的用户唯一标识,本身不包含上述渠道侧的会话路由信息,直接用aadObjectId作为入参调用发消息接口会直接被校验拦截。
- 常规会话路由链路的本质是:用户主动向机器人发送消息时,渠道会自动把带完整会话上下文的请求推送到机器人后端,机器人无需手动组装会话参数即可直接回复。要绕开这个流程,核心是提前获取目标用户的会话上下文,不依赖实时触发的请求。
可落地的无实时会话路由的实现路径
- 前置映射缓存:在用户首次和机器人完成交互、加入会话时,将活动对象里提取到的用户aadObjectId,和对应的完整会话地址信息做持久化存储,以aadObjectId为核心主键建立映射关系。
- 定向消息投递:需要给指定aadObjectId发消息时,直接从缓存中拉出对应用户的会话地址参数,组装成符合接口要求的活动对象,直接调用Bot Connector的
SendToConversation接口完成投递,整个过程不需要等待用户主动发消息触发实时路由流程。 - 渠道侧增强适配(以Teams场景为例):如果需要给从未和机器人交互过的aadObjectId发消息,可以借助Teams机器人的单聊会话创建能力,针对目标aadObjectId新建1:1单聊通道,拿到新建会话的ID后即可直接发消息,这种场景不需要提前缓存用户的历史会话信息。
落地时的注意事项
- 缓存的会话ID存在有效期,长时间未交互的会话可能被渠道端回收,发送失败时需要增加降级逻辑,触发重新创建会话的流程。
- 同一aadObjectId可能在多个渠道(如Webchat、Teams、企业微信)和机器人有过交互,缓存映射时必须将渠道ID作为联合主键,避免消息投递到错误渠道。
内容的提问来源于stack exchange,提问作者maletor
相关产品推荐
相关产品推荐

