如何获取Facebook message_reads webhook？未收到已读通知问题排查

一、如何配置message_reads Webhook #

• 进入Facebook开发者后台，打开你的应用，导航到Messenger > Webhooks页面
• 设置回调URL：点击「添加回调URL」，填写你的服务器接收地址，输入自定义的验证令牌，完成验证
• 订阅事件：在「订阅字段」中勾选message_reads，同时按需勾选其他需要的事件（如messages），保存设置
• 关联Facebook页面：在「页面订阅」区域，点击「订阅页面」，选择目标页面完成授权，确保页面的Webhook订阅包含message_reads事件
• 确保应用已获取pages_messaging权限（正式模式需申请高级访问并通过审核）

二、收不到message_reads通知的排查要点 #

• 确认订阅字段生效：回到Messenger > Webhooks页面，检查message_reads是否处于勾选状态，且设置已保存（部分场景下勾选后未保存会导致事件不推送）
• 验证页面关联完整性：确认目标Facebook页面已与应用成功关联，且页面的Webhook订阅列表中包含message_reads事件（部分情况下需单独在页面设置中确认）
• 检查触发条件是否满足：message_reads仅在用户手动打开Messenger对话并读取消息时触发，测试时需用真实账号（不能仅停留在推送通知环节），且消息是由你的应用发送给用户的
• 排查服务器接收日志：查看你的Webhook服务器日志，确认是否有message_reads请求被接收但处理异常（如返回非200状态码，Facebook会终止重试）
• 复核权限与应用状态：再次确认pages_messaging高级访问权限已通过审核，且权限覆盖关联的目标页面；应用处于正式模式且无权限限制
• 更换测试场景：若使用测试账号测试存在异常，尝试用真实用户账号在官方Messenger客户端中操作，排除测试环境限制

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