Как ограничить доступ к чат-боту по стране

Иногда нужно, чтобы чат-бот Shoply AI был доступен только в определенных странах, или чтобы он не отображался в конкретных странах. На этой странице объясняется, как настроить управление доступом на уровне стран с помощью Advanced Settings.

Где найти Advanced Settings?

Перейдите в раздел “Settings” в админ-консоли приложения, затем прокрутите вниз до раздела “Advanced Settings”. В этом разделе вы можете указать объект JSON для настройки различных параметров.

Settings → Advanced Settings is the editor used for the configuration below. The screenshot shows the demo store’s existing configuration; use the keys explained in this guide. Click the screenshot to view it at full size.

Как это работает

Shoply определяет страну посетителя по его IP-адресу. В зависимости от вашей конфигурации посетители из заблокированных стран все еще могут видеть чат-бота, но не смогут взаимодействовать с ним.

Есть два режима:

Режим белого списка — разрешает взаимодействие только посетителям из стран, которые вы явно разрешили. Все остальные видят чат-бота, но не могут им пользоваться.
Режим черного списка — разрешает взаимодействие всем посетителям, кроме тех, кого вы явно заблокировали.

Если ни одна из этих настроек не задана, чат-бот полностью доступен всем посетителям по всему миру (по умолчанию).

Настройки

Обе настройки задаются в JSON для Advanced Settings.

`whitelisted_geos` (режим белого списка)

Список стран, которым разрешено взаимодействовать с чат-ботом. Посетители из любой страны, не входящей в этот список, будут видеть чат-бота, но не смогут им пользоваться.

Используйте это, если ваш магазин работает на определенном наборе рынков и вы хотите ограничить взаимодействие везде в остальных местах.

Формат: Каждая запись представляет собой объект с полем countryCode, использующим двухбуквенный код страны ISO 3166-1 alpha-2 .

Пример — разрешить чат-бот только в США и Канаде:

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 .