Come limitare l’accesso al chatbot per paese

A volte vuoi che il chatbot Shoply AI sia disponibile solo in determinati paesi, oppure vuoi impedirne la visualizzazione in paesi specifici. Questa pagina spiega come configurare il controllo dell’accesso a livello di paese utilizzando le Impostazioni avanzate.

Dove trovare le Impostazioni avanzate?

Vai alla sezione “Settings” della console di amministrazione dell’app, quindi scorri verso il basso fino alla sezione “Advanced Settings”. In questa sezione, puoi fornire un oggetto JSON  per configurare varie impostazioni.

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.

Come funziona

Shoply rileva il paese del visitatore dal suo indirizzo IP. In base alla tua configurazione, i visitatori dei paesi bloccati potrebbero comunque vedere il chatbot, ma non potranno interagire con esso.

Ci sono due modalità:

  • Modalità whitelist — consente l’interazione solo ai visitatori provenienti dai paesi che autorizzi esplicitamente. Tutti gli altri vedono il chatbot ma non possono usarlo.
  • Modalità blacklist — consente l’interazione a tutti i visitatori, tranne quelli provenienti dai paesi che blocchi esplicitamente.

Se nessuna delle due impostazioni è configurata, il chatbot è completamente disponibile per tutti i visitatori in tutto il mondo (impostazione predefinita).

Impostazioni

Entrambe le impostazioni vengono configurate nel JSON delle Impostazioni avanzate.

whitelisted_geos (Modalità whitelist)

Un elenco di paesi a cui è consentito interagire con il chatbot. I visitatori provenienti da qualsiasi paese non presente in questo elenco vedranno il chatbot ma non potranno usarlo.

Usa questa opzione quando il tuo negozio serve un insieme specifico di mercati e vuoi limitare l’interazione ovunque altrove.

Formato: Ogni voce è un oggetto con un campo countryCode che utilizza il codice paese di due lettere ISO 3166-1 alpha-2 .

Esempio — consenti il chatbot solo negli Stati Uniti e in Canada:

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

blocked_geos (Modalità blacklist)

Un elenco di paesi i cui visitatori sono bloccati dall’interagire con il chatbot. Potrebbero comunque vedere il chatbot, ma non potranno usarlo. I visitatori provenienti da qualsiasi paese non presente in questo elenco possono interagire normalmente.

Usa questa opzione quando desideri un’ampia disponibilità ma hai bisogno di limitare paesi specifici.

Esempio — blocca i visitatori dagli Stati Uniti e dal Canada:

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

Note importanti

Le limitazioni per paese controllano l’accesso; il rilevamento della lingua determina la lingua dell’esperienza per i visitatori che possono utilizzarlo.

  • La whitelist ha la priorità. Se whitelisted_geos è impostato, blocked_geos viene ignorato completamente.
  • Usa una modalità alla volta. Inserisci nella whitelist i paesi che desideri, oppure nella blacklist quelli che non desideri — non entrambi.
  • I codici paese sono case-insensitive ("us" e "US" funzionano entrambi).
  • Se il paese di un visitatore non può essere determinato, non viene bloccato e può interagire normalmente.

Codici paese comuni

PaeseCodice
Stati UnitiUS
CanadaCA
Regno UnitoGB
AustraliaAU
GermaniaDE
FranciaFR
GiapponeJP
BrasileBR
IndiaIN
MessicoMX

Per un elenco completo dei codici paese, consulta il riferimento ISO 3166-1 alpha-2 .