配置引导 · 8 步接入 FB + INS
复用现有 Meta 应用 AIFENG_DCS_WA_API，无需新建应用。每步写明：操作内容 / 老板在场做什么。
前置条件
- 已拥有 Meta 开发者账号并能登录 developers.facebook.com
- 已有 Meta 应用 AIFENG_DCS_WA_API（WhatsApp 接入在用）
- 已有一个 Facebook 公共主页（公司主页）
- 公司 Instagram 账号已切换为专业账号并与公共主页绑定
- 公网 HTTPS 入口 app.aifengdcs.com 可达（webhook 回调需要）
第 1 步打开现有 Meta 应用
| 操作内容 | 登录 developers.facebook.com，进入已有应用 AIFENG_DCS_WA_API（WhatsApp 接入已用它，FB/INS 复用同一应用，无需新建）。 |
|---|---|
| 老板在场做什么 | 老板亲手登录 Meta 开发者账号，确认能看到应用 AIFENG_DCS_WA_API。 |
第 2 步添加产品 Messenger
| 操作内容 | 在应用面板点「添加产品」→ 找到 Messenger → 设置。它负责 FB 公共主页私信的收发。 |
|---|---|
| 老板在场做什么 | 确认应用处于开发模式即可先测试，正式上线再走 App Review。 |
第 3 步添加产品 Instagram
| 操作内容 | 同一面板添加 Instagram 产品。前置条件：FB 公共主页已绑定一个 Instagram 专业账号（在 INS App 设置里可切为专业账号，免费）。 |
|---|---|
| 老板在场做什么 | 确认公司 INS 账号已切换为专业账号并与 FB 公共主页互相绑定。 |
第 4 步生成主页访问令牌
| 操作内容 | Messenger 设置页 →「访问令牌」→ 添加/关联 FB 公共主页 → 生成 Page Access Token。令牌只由老板保存在服务器环境变量 META_PAGE_TOKEN，绝不入代码、绝不入聊天记录。 |
|---|---|
| 老板在场做什么 | 老板亲手复制令牌并贴进服务器环境变量配置文件；任何网页、聊天框都不粘贴令牌。 |
第 5 步关联 INS 专业账号
| 操作内容 | 在 Messenger 或 Instagram 设置里把已绑定的 Instagram 专业账号加入应用，记录 IG 用户 ID（服务器环境变量 META_IG_USER_ID）。 |
|---|---|
| 老板在场做什么 | 确认 INS 账号登录的是公司官方账号，不是个人号。 |
第 6 步配置 Webhook 回调
| 操作内容 | 应用设置 → Webhooks → 选 Page 与 Instagram 对象 → 回调地址填 https://app.aifengdcs.com/api/meta/webhook，验证令牌填自定义串（服务器环境变量 META_VERIFY_TOKEN，两边一致）。 |
|---|---|
| 老板在场做什么 | 回调地址必须 HTTPS 公网可达；验证令牌自定义且只存在服务器。 |
第 7 步订阅消息字段
| 操作内容 | Page 对象订阅 messages、messaging_postbacks、feed（评论）；Instagram 对象订阅 messages、comments。订阅后新私信与评论才会推送到 /api/meta/webhook。详见本页『Webhook 说明』。 |
|---|---|
| 老板在场做什么 | 每个字段勾选后 Meta 会立即发一次验证请求，看到绿色对勾即成功。 |
第 8 步申请高级权限上线
| 操作内容 | 开发模式只能收测试账号消息。正式上线需在 App Review 申请 pages_messaging、instagram_manage_messages、pages_manage_metadata 高级访问。期间准备好企业认证资料。 |
|---|---|
| 老板在场做什么 | 企业资料由老板提供；审核期间所有真实客户消息仍走现有渠道，不受影响。 |
⚠ 真实接通 Meta（令牌、webhook 上线、权限审核）均为 Human-Gate PENDING，老板在场逐条批准后执行。