Files
cozsweet-frontend-nextjs/docs/external-entry/links.md
T

3.9 KiB

Facebook 12 条外部入口链接清单

本清单是 Facebook 正式投放的唯一业务链接清单,共 4 类入口乘以 3 个角色,合计 12 条模板。

发送规则

  • 发送前必须把每条模板中的 <PSID> 替换为当前用户经过 URL 编码的 Facebook Page-scoped User ID;不得把占位符原样发送。
  • 每条链接都显式传入 character,不得依赖缺省角色回退。
  • Facebook 业务名称“私密空间”进入普通聊天页;业务名称“图片包”才进入应用的 private-zone
  • 不要在入口中传递登录 Token、Page Access Token、App Secret 或其他秘密。
  • 以下模板包含占位符,替换真实 PSID 后才能直接发送或点击。

正式投放模板

编号 Facebook 入口 角色 发送模板 预期落地与页面状态
1 私密空间 Elio https://cozsweet.com/external-entry?target=chat&character=elio&psid=<PSID> /characters/elio/chat,不显示促销锁卡
2 私密空间 Maya https://cozsweet.com/external-entry?target=chat&character=maya&psid=<PSID> /characters/maya/chat,不显示促销锁卡
3 私密空间 Nayeli https://cozsweet.com/external-entry?target=chat&character=nayeli&psid=<PSID> /characters/nayeli/chat,不显示促销锁卡
4 语音 Elio https://cozsweet.com/external-entry?target=chat&character=elio&mode=promotion&promotion_type=voice&psid=<PSID> /characters/elio/chat,显示一条锁定语音
5 语音 Maya https://cozsweet.com/external-entry?target=chat&character=maya&mode=promotion&promotion_type=voice&psid=<PSID> /characters/maya/chat,显示一条锁定语音
6 语音 Nayeli https://cozsweet.com/external-entry?target=chat&character=nayeli&mode=promotion&promotion_type=voice&psid=<PSID> /characters/nayeli/chat,显示一条锁定语音
7 图片包 Elio https://cozsweet.com/external-entry?target=private-zone&character=elio&psid=<PSID> /characters/elio/private-zone
8 图片包 Maya https://cozsweet.com/external-entry?target=private-zone&character=maya&psid=<PSID> /characters/maya/private-zone
9 图片包 Nayeli https://cozsweet.com/external-entry?target=private-zone&character=nayeli&psid=<PSID> /characters/nayeli/private-zone
10 帮忙买咖啡 Elio https://cozsweet.com/external-entry?target=tip&character=elio&psid=<PSID> /characters/elio/tip
11 帮忙买咖啡 Maya https://cozsweet.com/external-entry?target=tip&character=maya&psid=<PSID> /characters/maya/tip
12 帮忙买咖啡 Nayeli https://cozsweet.com/external-entry?target=tip&character=nayeli&psid=<PSID> /characters/nayeli/tip

预发验证

预发验证不维护第二套业务清单。将上述 12 条模板的主机统一替换为 frontend-test.banlv-ai.com,其余路径和参数保持不变:

https://frontend-test.banlv-ai.com/external-entry?<与正式模板相同的查询参数>

预发环境是 pre,不是正式环境。预发验证通过不代表已经更新 cozsweet.com 或获得生产发布批准。

验收判断

  • 最终浏览器地址必须是表格中的预期页面,且不再保留 /external-entry 的查询参数。
  • <PSID> 替换后的真实值必须由应用保存。
  • “私密空间”只进入普通聊天,不得出现锁定语音、锁定图片或私密文本促销卡。
  • “语音”进入聊天后必须只注入一条锁定语音。
  • “图片包”和“帮忙买咖啡”必须分别进入对应角色的 private-zonetip,不能串到其他角色。

不属于当前 12 条清单的兼容能力

  • 历史 target=private-room 继续兼容,但不得创建新的投放链接。
  • promotion_type=imagepromotion_type=private 和独立 PSID 示例不属于当前正式业务清单。
  • 兼容能力的保留不改变本页“只有 12 条正式投放模板”的口径。