如何按国家限制聊天机器人访问
有时你会希望 Shoply AI 聊天机器人仅在某些国家可用,或者你想阻止它在特定国家显示。本页面说明了如何使用高级设置来配置国家级访问控制。
在哪里找到高级设置?
前往应用管理控制台中的“Settings”部分,然后向下滚动到“Advanced Settings”部分。在此部分中,你可以提供一个 JSON 对象 来配置各种设置。

工作原理
Shoply 会根据访客的 IP 地址检测其所在国家。根据你的配置,来自被屏蔽国家的访客仍然可能会看到聊天机器人,但他们将无法与其交互。
有两种模式:
- 白名单模式 — 仅允许来自你明确允许的国家/地区的访客进行交互。其他所有人都能看到聊天机器人,但无法使用它。
- 黑名单模式 — 允许所有访客进行交互,但来自你明确屏蔽的国家/地区的访客除外。
如果这两项设置都未配置,则聊天机器人将对全球所有访客完全可用(默认行为)。
设置
这两项设置都在高级设置 JSON 中配置。
whitelisted_geos(白名单模式)
这是一个允许与聊天机器人交互的国家/地区列表。来自任何不在此列表中的国家/地区的访客都将看到聊天机器人,但无法使用它。
当你的商店服务于特定市场集合,并且你希望在其他所有地区限制交互时,请使用此设置。
格式: 每个条目都是一个对象,其中包含一个使用 ISO 3166-1 alpha-2 两位国家代码的 countryCode 字段。
示例 — 仅允许在美国和加拿大使用聊天机器人:
json
{
"whitelisted_geos": [
{ "countryCode": "US" },
{ "countryCode": "CA" }
]
}blocked_geos(黑名单模式)
这是一个其访客被禁止与聊天机器人交互的国家/地区列表。他们仍然可能会看到聊天机器人,但将无法使用它。来自任何不在此列表中的国家/地区的访客都可以正常交互。
当你希望广泛开放可用性,但需要限制特定国家/地区时,请使用此设置。
示例 — 屏蔽来自美国和加拿大的访客:
json
{
"blocked_geos": [
{ "countryCode": "US" },
{ "countryCode": "CA" }
]
}重要说明
国家限制用于控制访问;语言检测决定了可使用该功能的访客所体验到的语言。
- 白名单优先。 如果设置了
whitelisted_geos,则blocked_geos会被完全忽略。 - 一次只使用一种模式。 要么将你想要的国家/地区加入白名单,要么将你不想要的国家/地区加入黑名单——不要同时使用两者。
- 国家代码不区分大小写(
"us"和"US"都可用)。 - 如果无法确定访客所在国家/地区,他们不会被屏蔽,并且可以正常交互。
常见国家代码
| 国家/地区 | 代码 |
|---|---|
| 美国 | US |
| 加拿大 | CA |
| 英国 | GB |
| 澳大利亚 | AU |
| 德国 | DE |
| 法国 | FR |
| 日本 | JP |
| 巴西 | BR |
| 印度 | IN |
| 墨西哥 | MX |
如需查看完整的国家代码列表,请参阅 ISO 3166-1 alpha-2 参考 。