From a7c1574e582cfabdd056c3553526cad27708ea94 Mon Sep 17 00:00:00 2001 From: chenhang Date: Wed, 15 Jul 2026 11:24:12 +0800 Subject: [PATCH] docs(external-entry): update entry links and remove avatar_url parameter --- docs/external-entry-links.md | 26 +++++++++++++++++++++++++- docs/external-entry.md | 5 +++-- 2 files changed, 28 insertions(+), 3 deletions(-) diff --git a/docs/external-entry-links.md b/docs/external-entry-links.md index c48e8c86..16b7efe7 100644 --- a/docs/external-entry-links.md +++ b/docs/external-entry-links.md @@ -1,6 +1,6 @@ # 外部入口链接清单 -以下链接可以直接点击打开，用于验证普通聊天和促销模式。 +以下链接可以直接点击打开，用于验证聊天、促销模式、咖啡打赏和私密空间入口。 ## 测试环境 @@ -13,6 +13,18 @@ APP HOST：`frontend-test.banlv-ai.com` | 图片促销 | `promotion` | `image` | [打开图片促销](https://frontend-test.banlv-ai.com/external-entry?target=chat&mode=promotion&promotion_type=image) | | 私密文本促销 | `promotion` | `private` | [打开私密文本促销](https://frontend-test.banlv-ai.com/external-entry?target=chat&mode=promotion&promotion_type=private) | +### 咖啡打赏 + +| 咖啡档位 | `coffee_type` | 链接 | +| --- | --- | --- | +| Small Coffee (US$4.99) | `small` | [打开 Small Coffee 打赏](https://frontend-test.banlv-ai.com/external-entry?target=tip&coffee_type=small) | +| Medium Coffee (US$9.99) | `medium` | [打开 Medium Coffee 打赏](https://frontend-test.banlv-ai.com/external-entry?target=tip&coffee_type=medium) | +| Large Coffee (US$19.99) | `large` | [打开 Large Coffee 打赏](https://frontend-test.banlv-ai.com/external-entry?target=tip&coffee_type=large) | + +### 私密空间 + +[打开私密空间](https://frontend-test.banlv-ai.com/external-entry?target=private-room) + ## 正式环境 APP HOST：`cozsweet.com` @@ -24,4 +36,16 @@ APP HOST：`cozsweet.com` | 图片促销 | `promotion` | `image` | [打开图片促销](https://cozsweet.com/external-entry?target=chat&mode=promotion&promotion_type=image) | | 私密文本促销 | `promotion` | `private` | [打开私密文本促销](https://cozsweet.com/external-entry?target=chat&mode=promotion&promotion_type=private) | +### 咖啡打赏 + +| 咖啡档位 | `coffee_type` | 链接 | +| --- | --- | --- | +| Small Coffee (US$4.99) | `small` | [打开 Small Coffee 打赏](https://cozsweet.com/external-entry?target=tip&coffee_type=small) | +| Medium Coffee (US$9.99) | `medium` | [打开 Medium Coffee 打赏](https://cozsweet.com/external-entry?target=tip&coffee_type=medium) | +| Large Coffee (US$19.99) | `large` | [打开 Large Coffee 打赏](https://cozsweet.com/external-entry?target=tip&coffee_type=large) | + +### 私密空间 + +[打开私密空间](https://cozsweet.com/external-entry?target=private-room) + 如需传递 Facebook 身份信息，可在任一链接末尾追加 `&psid=`。PSID 为可选参数。 diff --git a/docs/external-entry.md b/docs/external-entry.md index 298d1530..fa303915 100644 --- a/docs/external-entry.md +++ b/docs/external-entry.md @@ -19,7 +19,6 @@ | --- | --- | --- | --- | | `target` | 否 | `chat`、`tip`、`private-room` | 最终页面，缺失或无效时进入 `chat`。 | | `psid` | 否 | string | Facebook Page-scoped User ID。 | -| `avatar_url` | 否 | URL string | 用户头像地址。 | | `coffee_type` | 打赏入口可选 | `small`、`medium`、`large` | `target=tip` 时指定咖啡档位，缺失或非法时默认为 `small`。 | | `mode` | 否 | `promotion` | 设置为 `promotion` 时尝试开启聊天促销模式。 | | `promotion_type` | 促销模式必填 | `voice`、`image`、`private` | 指定促销锁消息类型。 | @@ -28,6 +27,8 @@ ## 普通入口 +下述为链接格式。测试环境和正式环境的可点击链接见 [外部入口链接清单](./external-entry-links.md)。 + 进入聊天： ```text @@ -84,7 +85,7 @@ https:///external-entry?target=tip&coffee_type=large ## 接入要求 -- 所有参数必须使用 URL 编码，尤其是 `avatar_url`。 +- 所有参数值必须使用 URL 编码。 - 不要通过入口传递登录 token、Page Access Token 或 App Secret。 - `coffee_type` 仅在 `target=tip` 时生效；缺失或非法时使用 `small`。 - `promotion_type` 非法时按普通聊天入口处理，不展示促销消息。