Facebook Messenger API Skill (Advanced)
Purpose
Provide a production-oriented guide for Messenger Platform workflows: sending messages, handling webhooks, and managing Page messaging using direct HTTPS calls.
Best fit
- - You need bot-style messaging in Facebook Messenger.
- You want clean webhook handling and message UX.
- You prefer direct HTTP requests rather than SDKs.
Not a fit
- - You need advanced Graph API Ads or Marketing workflows.
- You must use complex browser-based OAuth flows.
Quick orientation
- - Read
references/messenger-api-overview.md for base URLs and core object map. - Read
references/webhooks.md for verification and signature validation. - Read
references/messaging.md for Send API fields and message types. - Read
references/permissions-and-tokens.md for token flow and required permissions. - Read
references/request-templates.md for concrete HTTP payloads. - Read
references/conversation-patterns.md for UX flows (get started, menu, fallback). - Read
references/webhook-event-map.md for event types and routing.
Required inputs
- - Facebook App ID and App Secret.
- Page ID and Page access token.
- Webhook URL and verify token.
- Message UX and allowed interactions.
Expected output
- - A clear messaging workflow plan, permissions checklist, and operational guardrails.
Operational notes
- - Validate signatures on all webhook events.
- Keep replies short and acknowledge quickly.
- Handle rate limits and retries with backoff.
Security notes
- - Never log tokens or app secrets.
- Use least-privilege permissions.
Facebook Messenger API 技能(高级)
目的
提供面向生产的 Messenger 平台工作流程指南:通过直接 HTTPS 调用发送消息、处理 webhook 以及管理主页消息。
最佳适用场景
- - 需要在 Facebook Messenger 中实现机器人式消息发送
- 需要清晰的 webhook 处理和消息用户体验
- 偏好直接使用 HTTP 请求而非 SDK
不适用场景
- - 需要高级 Graph API 广告或营销工作流程
- 必须使用复杂的基于浏览器的 OAuth 流程
快速入门
- - 阅读 references/messenger-api-overview.md 了解基础 URL 和核心对象映射
- 阅读 references/webhooks.md 了解验证和签名校验
- 阅读 references/messaging.md 了解发送 API 字段和消息类型
- 阅读 references/permissions-and-tokens.md 了解令牌流程和所需权限
- 阅读 references/request-templates.md 了解具体 HTTP 负载
- 阅读 references/conversation-patterns.md 了解用户体验流程(入门、菜单、回退)
- 阅读 references/webhook-event-map.md 了解事件类型和路由
必需输入
- - Facebook 应用 ID 和应用密钥
- 主页 ID 和主页访问令牌
- Webhook URL 和验证令牌
- 消息用户体验和允许的交互方式
预期输出
操作说明
- - 对所有 webhook 事件验证签名
- 保持回复简洁并快速确认
- 处理速率限制并通过退避策略进行重试
安全说明