跳转到内容

Meta 开发者准备

Facebook 和 Instagram 都由 Meta 管,共用同一个应用,不需要建两个。

  1. 打开 developers.facebook.com,用公司的 Facebook 账号登录
  2. 点右上角「开始使用」/「Get Started」,按引导完成开发者注册(要验证手机号)
  1. 打开 应用创建页
  2. 先选一个商业组合(business portfolio)。没有就现场建一个
  3. 到「添加用例」界面时,把左侧筛选切到 「全部」/「All」
  4. 列出来的用例全部跳过 —— 往下滚到「没找到想要的?」/「Looking for something else?」,选 「其他」/「Other」,继续
  5. 应用类型选 「商务」/「business」
  6. 填应用名称等信息,创建
  1. 在应用里添加 「Facebook 登录」/「Login with Facebook」 产品,配置方式选 「商务版登录」/「login for business」
  2. 设置 OAuth 回调地址(按你的 Postiz 部署方式选一个):
部署方式 回调地址
生产(有域名) https://你的postiz域名/integrations/social/facebook
本地开发 http://localhost:4200/integrations/social/facebook
Docker http://localhost:5000/integrations/social/facebook

Instagram 有两条路,选一条:

方案 前提 回调地址 凭据变量
A. 走 Facebook 主页(推荐,本系统按此配置) IG 必须关联一个 Facebook 主页 https://你的postiz域名/integrations/social/instagram 与 Facebook 共用 FACEBOOK_APP_ID / FACEBOOK_APP_SECRET
B. IG 独立登录 不要主页,但 IG 必须是专业号 https://你的postiz域名/integrations/social/instagram-standalone 单独的 INSTAGRAM_APP_ID / INSTAGRAM_APP_SECRET

方案 B 需要额外添加 Instagram 产品并开启 Instagram 商务登录。

第四步:申请权限(advanced access)

Section titled “第四步:申请权限(advanced access)”

在应用的「权限和功能」里为下列权限申请 advanced access:

Facebook 发帖需要:

pages_show_list
business_management
pages_manage_posts
pages_manage_engagement
pages_read_engagement
read_insights

Instagram 发帖额外需要(方案 A):

instagram_basic
instagram_content_publish
instagram_manage_comments
instagram_manage_insights

在应用「设置 → 基本」里拿到 应用编号(App ID) 和 应用密钥(App Secret),写进 Postiz 的环境变量:

FACEBOOK_APP_ID="你的 App ID"
FACEBOOK_APP_SECRET="你的 App Secret"

方案 B 的 Instagram 独立登录再加:

INSTAGRAM_APP_ID="你的 IG App ID"
INSTAGRAM_APP_SECRET="你的 IG App Secret"

这是最容易踩的坑,务必搞清楚:

应用模式 谁能授权成功 帖子谁能看见
开发(Development) 只有应用角色名单里的账号(管理员 / 开发者 / 测试人员) 只有你自己看得到;别人看到的帖子还会缺图
上线(Live) 所有人 所有人

把成员加入授权名单(必做,否则运营绑不上号)

Section titled “把成员加入授权名单(必做,否则运营绑不上号)”

应用在开发模式下,运营账号必须先被加进角色名单,才能在控制台完成绑定。

  1. 进入应用后台 → 「应用角色」/「App Roles」→「角色」/「Roles」
  2. 点 「添加测试人员」/「Add Testers」(也可加为 Developer,权限更大,按需选)
  3. 输入运营提供的 Facebook 用户名或数字 ID,搜索并添加
  4. 告知运营去接受邀请 —— 邀请不会自动生效
  1. 同样在 「应用角色」/「App Roles」 里,找到 Instagram 测试人员 / Instagram Testers
  2. 输入运营的 Instagram 用户名并添加
  3. 告知运营:在 Instagram App 里打开 设置 → 网站许可 / 应用和网站,找到邀请并接受
检查项 通过标准
名单里有人 应用角色页能看到该账号,状态是已接受(不是“待处理”)
运营能绑号 运营在控制台「账号健康」点「绑定新账号」,跳转授权页不报错
帖子对外可见 用未登录的浏览器打开帖子链接能看到,且图片在
现象 原因 怎么修
点「绑定新账号」跳转后报权限错误 该账号不在应用角色名单,或邀请没接受 加进名单 + 让运营接受邀请
Instagram 授权后选不到账号 IG 不是专业号,或没关联 Facebook 主页 IG 切专业号并关联主页(方案 A 必须)
授权成功但发帖失败 主页权限不足,或权限没申请全 确认运营在 Page 里是管理员;补齐权限
帖子只有自己可见 / 图片丢失 应用还在开发模式 切到 Live
回调报 redirect_uri 不匹配 回调地址与 Postiz 实际域名不一致 逐字符核对回调地址,注意 http/https 与结尾无斜杠