如何依國家限制聊天機器人存取
有時您會希望 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 參考資料 。