국가별로 챗봇 액세스를 제한하는 방법

때로는 Shoply AI 챗봇을 특정 국가에서만 사용할 수 있게 하거나, 특정 국가에서는 표시되지 않도록 차단하고 싶을 수 있습니다. 이 페이지에서는 고급 설정을 사용하여 국가 단위 액세스 제어를 구성하는 방법을 설명합니다.

고급 설정은 어디에서 찾을 수 있나요?

앱의 관리자 콘솔에서 “Settings” 섹션으로 이동한 다음, 아래로 스크롤하여 “Advanced Settings” 섹션을 찾으세요. 이 섹션에서는 다양한 설정을 구성하기 위해 JSON 객체 를 제공할 수 있습니다.

작동 방식

Shoply는 방문자의 IP 주소를 통해 방문자의 국가를 감지합니다. 설정에 따라 차단된 국가의 방문자도 챗봇을 볼 수는 있지만, 상호작용할 수는 없습니다.

두 가지 모드가 있습니다:

• 화이트리스트 모드 — 명시적으로 허용한 국가의 방문자만 상호작용을 허용합니다. 그 외의 모든 사용자는 챗봇을 볼 수는 있지만 사용할 수는 없습니다.
• 블랙리스트 모드 — 명시적으로 차단한 국가를 제외한 모든 방문자에게 상호작용을 허용합니다.

어느 설정도 구성되지 않은 경우, 챗봇은 전 세계 모든 방문자에게 완전히 제공됩니다(기본값).

설정

두 설정 모두 고급 설정 JSON에서 구성합니다.

whitelisted_geos (화이트리스트 모드)

챗봇과 상호작용할 수 있도록 허용된 국가 목록입니다. 이 목록에 포함되지 않은 국가의 방문자는 챗봇을 볼 수는 있지만 사용할 수는 없습니다.

스토어가 특정 시장 집합만 대상으로 하며, 그 외 지역에서는 상호작용을 제한하고 싶을 때 사용하세요.

형식: 각 항목은 ISO 3166-1 alpha-2  두 글자 국가 코드를 사용하는 countryCode 필드를 가진 객체입니다.

예시 — 미국과 캐나다에서만 챗봇 허용:

{
  "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 참조 를 확인하세요.