Ограничение чат-бота по странам (геоблокировка)

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

Где найти расширенные настройки?

Перейдите в раздел «Settings» консоли администратора приложения, затем прокрутите страницу до раздела «Advanced Settings». В этом разделе можно указать объект 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 .