核心用法
本技能提供 Facebook Messenger Platform 的全流程开发指南，涵盖三大核心场景：
1. 消息发送：通过 Send API 直接发送文本、模板、快速回复等多种消息类型
2. Webhook 处理：实现事件订阅、签名验证、消息路由的完整闭环
3. Page 收件箱管理：集成 Messenger 对话管理与客户服务流程
采用纯 HTTPS 请求方案，绕过官方 SDK 的依赖负担，适合需要精细化控制 HTTP 层、多语言环境或轻量级部署的场景。
显著优点
- 零 SDK 依赖：直接构造 HTTP 请求，降低技术栈锁定风险
- 生产级安全设计：强制要求 webhook 签名验证、最小权限原则
- 完整的事件映射：覆盖消息、已读回执、消息送达、用户操作等全量事件类型
- UX 模式沉淀：内置「开始对话」引导、持久菜单、故障降级等成熟交互范式
潜在局限
- OAuth 简化：明确排除复杂的浏览器端 OAuth 流程，需自行处理授权层
- 营销能力边界：不涉及 Graph API 的广告与高级营销功能
- 速率限制需自管：需开发者自行实现退避重试逻辑
适合人群
- 需要构建客服机器人、通知推送类 Messenger 应用的开发团队
- 追求技术栈精简、偏好直接 HTTP 控制的工程文化
- 已有 Page 资产、需快速接入消息能力的中小型业务
常规风险
| 风险点 | 缓解措施 |
|--------|----------|
| Token 泄露 | 禁止日志记录，使用密钥管理服务 |
| Webhook 伪造 | 强制验证 `X-Hub-Signature-256` |
| 速率限制触发 | 实现指数退避重试策略 |
| 权限过度授予 | 遵循文档中的最小权限清单 |
依赖文档
references/messenger-api-overview.md— 基础端点与对象映射references/webhooks.md— 验证与签名机制references/messaging.md— Send API 字段详解references/permissions-and-tokens.md— 权限与令牌流references/request-templates.md— HTTP 请求模板references/conversation-patterns.md— UX 交互模式references/webhook-event-map.md— 事件路由参考