Como Restringir o Acesso ao Chatbot por País

Às vezes, você quer que o chatbot do Shoply AI esteja disponível apenas em determinados países, ou quer impedir que ele apareça em países específicos. Esta página explica como configurar o controle de acesso em nível de país usando as Configurações Avançadas.

Onde encontrar as Configurações Avançadas?

Vá para a seção “Settings” do painel administrativo do aplicativo e, em seguida, role para baixo até a seção “Advanced Settings”. Nesta seção, você pode fornecer um objeto JSON  para configurar várias definições.

Como Funciona

A Shoply detecta o país do visitante a partir do endereço IP dele. Com base na sua configuração, visitantes de países bloqueados ainda podem ver o chatbot, mas não poderão interagir com ele.

Há dois modos:

• Modo de lista de permissões — permite interação apenas para visitantes de países que você permite explicitamente. Todos os demais veem o chatbot, mas não podem usá-lo.
• Modo de lista de bloqueio — permite interação para todos os visitantes, exceto aqueles de países que você bloqueia explicitamente.

Se nenhuma das configurações estiver definida, o chatbot ficará totalmente disponível para todos os visitantes no mundo todo (padrão).

Configurações

Ambas as configurações são definidas no JSON de Configurações Avançadas.

whitelisted_geos (Modo de Lista de Permissões)

Uma lista de países que têm permissão para interagir com o chatbot. Visitantes de qualquer país que não esteja nesta lista verão o chatbot, mas não poderão usá-lo.

Use isso quando sua loja atende a um conjunto específico de mercados e você deseja restringir a interação em todos os outros lugares.

Formato: Cada entrada é um objeto com um campo countryCode usando o código de país de duas letras ISO 3166-1 alpha-2 .

Exemplo — permitir o chatbot apenas nos EUA e no Canadá:

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

blocked_geos (Modo de Lista de Bloqueio)

Uma lista de países cujos visitantes estão bloqueados de interagir com o chatbot. Eles ainda podem ver o chatbot, mas não poderão usá-lo. Visitantes de qualquer país que não esteja nesta lista podem interagir normalmente.

Use isso quando você quiser ampla disponibilidade, mas precisar restringir países específicos.

Exemplo — bloquear visitantes dos EUA e do Canadá:

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

Observações Importantes

As restrições por país controlam o acesso; a detecção de idioma determina o idioma da experiência para os visitantes que podem usá-la.

• A lista de permissões tem prioridade. Se whitelisted_geos estiver definido, blocked_geos será totalmente ignorado.
• Use um modo por vez. Ou coloque na lista de permissões os países que você quer, ou coloque na lista de bloqueio os que você não quer — não ambos.
• Os códigos de país não diferenciam maiúsculas de minúsculas (case-insensitive) ("us" e "US" funcionam).
• Se o país de um visitante não puder ser determinado, ele não será bloqueado e poderá interagir normalmente.

Códigos de País Comuns

Para uma lista completa de códigos de país, consulte a referência ISO 3166-1 alpha-2 .