Cómo restringir el acceso al chatbot por país

A veces quieres que el chatbot de Shoply AI esté disponible solo en ciertos países, o quieres bloquear que aparezca en países específicos. Esta página explica cómo configurar el control de acceso por país usando la Configuración avanzada.

¿Dónde encontrar la Configuración avanzada?

Ve a la sección “Settings” de la consola de administración de la aplicación y luego desplázate hacia abajo hasta la sección “Advanced Settings”. En esta sección, puedes proporcionar un objeto JSON  para configurar varios ajustes.

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.
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.

Cómo funciona

Shoply detecta el país del visitante a partir de su dirección IP. Según tu configuración, los visitantes de países bloqueados todavía pueden ver el chatbot, pero no podrán interactuar con él.

Hay dos modos:

  • Modo de lista blanca — solo permite la interacción de visitantes de países que autorices explícitamente. Todos los demás verán el chatbot, pero no podrán usarlo.
  • Modo de lista negra — permite la interacción a todos los visitantes, excepto a los de países que bloquees explícitamente.

Si no se configura ninguna de las dos opciones, el chatbot estará totalmente disponible para todos los visitantes en todo el mundo (comportamiento predeterminado).

Configuración

Ambas opciones se configuran en el JSON de Configuración avanzada.

whitelisted_geos (Modo de lista blanca)

Una lista de países que tienen permitido interactuar con el chatbot. Los visitantes de cualquier país que no esté en esta lista verán el chatbot, pero no podrán usarlo.

Usa esto cuando tu tienda atiende a un conjunto específico de mercados y quieres restringir la interacción en cualquier otro lugar.

Formato: Cada entrada es un objeto con un campo countryCode que usa el código de país de dos letras ISO 3166-1 alpha-2 .

Ejemplo — permitir el chatbot solo en EE. UU. y Canadá:

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

blocked_geos (Modo de lista negra)

Una lista de países cuyos visitantes tienen bloqueada la interacción con el chatbot. Aun así pueden ver el chatbot, pero no podrán usarlo. Los visitantes de cualquier país que no esté en esta lista pueden interactuar con normalidad.

Usa esto cuando quieres una disponibilidad amplia, pero necesitas restringir países específicos.

Ejemplo — bloquear a visitantes de EE. UU. y Canadá:

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

Notas importantes

Las restricciones por país controlan el acceso; la detección de idioma determina el idioma de la experiencia para los visitantes que pueden usarlo.

  • La lista blanca tiene prioridad. Si whitelisted_geos está configurado, blocked_geos se ignora por completo.
  • Usa un solo modo a la vez. O incluyes en lista blanca los países que quieres, o incluyes en lista negra los que no quieres, pero no ambos.
  • Los códigos de país no distinguen entre mayúsculas y minúsculas ("us" y "US" funcionan ambos).
  • Si no se puede determinar el país de un visitante, no se bloquea y puede interactuar con normalidad.

Códigos de país comunes

PaísCódigo
Estados UnidosUS
CanadáCA
Reino UnidoGB
AustraliaAU
AlemaniaDE
FranciaFR
JapónJP
BrasilBR
IndiaIN
MéxicoMX

Para ver una lista completa de códigos de país, consulta la referencia de ISO 3166-1 alpha-2 .