使用Microsoft Bot Framework Composer向Facebook Messenger发送主动消息失败排查

核心问题分析 #

你的代码存在几个关键问题，导致主动消息在Facebook平台无法正常工作：

1. ContinueConversationAsync身份参数错误
   第一个参数传入了空字符串string.Empty，但Facebook平台要求传入Bot的AppId来完成身份验证，空值会导致请求被拒绝。

2. SendProactiveMessage冗余代码干扰
   方法内手动创建ConnectorClient属于多余操作，turnContext已经封装了发送消息的能力，重复实例化客户端可能引发冲突；同时ServiceUrl的信任操作位置错误，应该在创建对话引用后立即执行。

3. 异常处理缺失日志
   直接抛出异常但未记录错误细节，无法获取Facebook平台返回的具体错误信息（如权限不足、无效对话ID等），增加排查难度。

修正后的代码 #

主方法修正 #

public async Task<IActionResult> ProActiveMessage(ProactiveConvRef proactiveConvRef)
{
    try
    {
        bool anyPropNotNull = proactiveConvRef.GetType().GetProperties().Any(prop => prop.GetValue(proactiveConvRef) != null);
        if (anyPropNotNull)
        {
            var newReference = new ConversationReference()
            {
                Bot = new ChannelAccount()
                {
                    Id = proactiveConvRef.BotId
                },
                Conversation = new ConversationAccount()
                {
                    Id = proactiveConvRef.ConversationId
                },
                ServiceUrl = proactiveConvRef.ServiceUrl,
            };

            // 提前信任ServiceUrl，确保请求被允许
            AppCredentials.TrustServiceUrl(proactiveConvRef.ServiceUrl);
            // 传入Bot的AppId而非空字符串
            await ((BotAdapter)_adapter).ContinueConversationAsync("<你的Bot AppId>", newReference, async (context, token) => await SendProactiveMessage(proactiveConvRef.BotMessage, context, token), default);
        }

        return new ContentResult()
        {
            Content = "主动消息已发送。",
            ContentType = "text/html",
            StatusCode = (int)HttpStatusCode.OK,
        };
    }
    catch (Exception ex)
    {
        // 建议添加日志记录，例如：_logger.LogError(ex, "主动消息发送失败");
        throw;
    }
}

消息发送方法简化 #

private async Task<string> SendProactiveMessage(string botMsg, ITurnContext turnContext, CancellationToken cancellationToken)
{
    try
    {
        var res = await turnContext.SendActivityAsync(MessageFactory.Text(botMsg), cancellationToken);
        return res.Id; // 返回消息ID便于追踪
    }
    catch (Exception ex)
    {
        // 建议添加日志记录，例如：_logger.LogError(ex, "上下文消息发送失败");
        throw;
    }
}

额外注意事项 #

• Facebook平台配置检查
  • 确认Webhook验证令牌与Bot Framework配置一致，且已订阅messages、messaging_postbacks等必要事件。
  • 确保Facebook应用已获取pages_messaging权限，公开应用需完成审核流程。
• 对话ID有效性
  Facebook的ConversationId格式为用户ID_页面ID，需确保持久化和传递的ID格式正确，无截断或错误。
• ServiceUrl正确性
  Facebook的ServiceUrl格式为https://graph.facebook.com/v{版本号}/（如v18.0），需从对话上下文动态获取并存储，避免硬编码过期地址。

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