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.

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á:
{
"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á:
{
"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_geosestá configurado,blocked_geosse 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ís | Código |
|---|---|
| Estados Unidos | US |
| Canadá | CA |
| Reino Unido | GB |
| Australia | AU |
| Alemania | DE |
| Francia | FR |
| Japón | JP |
| Brasil | BR |
| India | IN |
| México | MX |
Para ver una lista completa de códigos de país, consulta la referencia de ISO 3166-1 alpha-2 .