Dynamics Omnichannel集成Azure Bot后出站消息及会话记录异常求助

一、出站回复无法原路返回问题排查步骤 #

• 首先校验Dynamics Omnichannel通道配置的Webhook回传地址，确认该地址和你Azure Bot注册的Messages endpoint完全一致，注意不要漏写/api/messages后缀，同时确认Dynamics侧配置的Bot应用ID、客户端密钥和Azure Portal里注册的Bot凭证匹配
• 检查Azure Bot的出站消息上下文参数：必须在回复消息里完整携带入站消息传入的conversation.id、channelData字段，不要自行修改这两个参数值，Dynamics Omnichannel依赖这两个字段做路由溯源
• 校验Twilio侧的消息权限：确认你的Twilio号码开通了outbound消息权限，同时Dynamics Omnichannel里关联的Twilio通道配置的Account SID、Auth Token和Twilio控制台的参数完全匹配，且没有触发Twilio的频率限制、合规拦截规则
• 检查Azure Bot的出站响应格式：不要直接返回纯文本，必须使用SDK提供的Activity对象封装回复，示例代码参考：

// .NET SDK 示例
var reply = MessageFactory.Text("你的回复内容");
reply.Id = turnContext.Activity.Id;
reply.Conversation = turnContext.Activity.Conversation;
reply.ChannelData = turnContext.Activity.ChannelData;
await turnContext.SendActivityAsync(reply, cancellationToken);

• 开启Dynamics Omnichannel的通道日志，查看出站消息的错误码：如果日志返回401错误就是凭证问题，返回404就是路由地址错误，返回403就是权限拦截

二、会话记录无法追溯问题修复 #

• 确认Dynamics Omnichannel里开启了会话记录持久化配置：路径是Omnichannel管理中心 > 会话设置 > 会话记录，勾选「保存所有会话消息」，同时给Bot应用分配会话记录的读写权限
• 检查Azure Bot侧是否开启了Transcript日志功能：在Azure Bot的设置页开启转录功能，关联到你的Azure存储账户，同时确保转录日志里会保存conversation.id、channel、from.id、recipient.id四个关键字段，方便后续和Dynamics的会话记录做关联匹配
• 校验入站消息的channelData是否携带Twilio的消息ID、WhatsApp用户ID：如果这个字段为空，Dynamics无法关联到前端渠道的会话，需要在Twilio的通道配置里开启「传递完整渠道参数」开关

内容的提问来源于stack exchange，提问作者smith99