按国家/地区限制聊天机器人（地理位置屏蔽）

有时，你可能只希望 Shoply AI 聊天机器人在特定国家/地区可用，或不希望它在某些国家/地区出现。本页介绍如何使用高级设置配置国家/地区级访问控制。

在哪里可以找到高级设置？

前往应用管理后台的“设置”部分，然后向下滚动到“高级设置”。你可以在这里提供一个 JSON 对象 来配置各种设置。

工作原理

Shoply 会根据访客的 IP 地址检测其所在国家/地区。根据你的配置，来自被屏蔽国家/地区的访客可能仍会看到聊天机器人，但无法与其互动。

共有两种模式：

• 白名单模式 — 仅允许来自你明确许可的国家/地区的访客互动。其他所有访客都能看到聊天机器人，但无法使用。
• 黑名单模式 — 除来自你明确屏蔽的国家/地区的访客外，允许其他所有访客互动。

如果两项设置都未配置，聊天机器人默认对全球所有访客完全开放。

设置

这两项设置都在高级设置 JSON 中配置。

whitelisted_geos（白名单模式）

允许与聊天机器人互动的国家/地区列表。来自此列表中未包含国家/地区的访客会看到聊天机器人，但无法使用。

如果你的商店只服务一组特定市场，并希望限制其他地区的互动，请使用此模式。

**格式：**每个条目都是一个包含 countryCode 字段的对象，该字段使用 ISO 3166-1 alpha-2  两位国家/地区代码。

示例 — 仅允许美国和加拿大的访客使用聊天机器人：

{
  "whitelisted_geos": [
    { "countryCode": "US" },
    { "countryCode": "CA" }
  ]
}

blocked_geos（黑名单模式）

被禁止与聊天机器人互动的国家/地区列表。这些访客可能仍会看到聊天机器人，但无法使用。来自此列表中未包含国家/地区的访客可以正常互动。

如果你希望广泛开放聊天机器人，但需要限制特定国家/地区，请使用此模式。

示例 — 屏蔽来自美国和加拿大的访客：

{
  "blocked_geos": [
    { "countryCode": "US" },
    { "countryCode": "CA" }
  ]
}

重要说明

• **白名单优先。**如果设置了 whitelisted_geos，系统会完全忽略 blocked_geos。
• **一次只使用一种模式。**要么将希望允许的国家/地区加入白名单，要么将不希望允许的国家/地区加入黑名单，不要同时使用两者。
• 国家/地区代码不区分大小写（"us" 和 "US" 均有效）。
• 如果无法确定访客所在的国家/地区，系统不会屏蔽该访客，其可以正常互动。

常用国家/地区代码

如需查看完整的国家/地区代码列表，请参阅 ISO 3166-1 alpha-2 参考资料 。