Hoe je chatbottoegang per land beperkt

Soms wil je dat de Shoply AI-chatbot alleen beschikbaar is in bepaalde landen, of wil je voorkomen dat deze verschijnt in specifieke landen. Deze pagina legt uit hoe je toegangscontrole op landniveau configureert met behulp van de Geavanceerde instellingen.

Waar vind je Geavanceerde instellingen?

Ga naar het gedeelte “Settings” van de adminconsole van de app en scroll vervolgens omlaag naar het gedeelte “Advanced Settings”. In dit gedeelte kun je een JSON-object  opgeven om verschillende instellingen te configureren.

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.

Hoe het werkt

Shoply detecteert het land van de bezoeker aan de hand van het IP-adres. Op basis van je configuratie kunnen bezoekers uit geblokkeerde landen de chatbot nog steeds zien, maar ze kunnen er niet mee interageren.

Er zijn twee modi:

  • Whitelistmodus — sta alleen interactie toe voor bezoekers uit landen die je expliciet toestaat. Iedereen anders ziet de chatbot, maar kan deze niet gebruiken.
  • Blacklistmodus — sta interactie toe voor alle bezoekers, behalve die uit landen die je expliciet blokkeert.

Als geen van beide instellingen is geconfigureerd, is de chatbot volledig beschikbaar voor alle bezoekers wereldwijd (de standaardinstelling).

Instellingen

Beide instellingen worden geconfigureerd in de JSON van Geavanceerde instellingen.

whitelisted_geos (Whitelistmodus)

Een lijst met landen die toegestaan zijn om met de chatbot te interageren. Bezoekers uit elk land dat niet op deze lijst staat, zien de chatbot wel maar kunnen deze niet gebruiken.

Gebruik dit als je winkel zich richt op een specifieke set markten en je interactie overal elders wilt beperken.

Indeling: Elke invoer is een object met een veld countryCode dat de landcode van twee letters volgens ISO 3166-1 alpha-2  gebruikt.

Voorbeeld — sta de chatbot alleen toe in de VS en Canada:

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

blocked_geos (Blacklistmodus)

Een lijst met landen waarvan bezoekers geblokkeerd zijn om met de chatbot te interageren. Ze kunnen de chatbot nog steeds zien, maar kunnen deze niet gebruiken. Bezoekers uit elk land dat niet op deze lijst staat, kunnen normaal interageren.

Gebruik dit als je brede beschikbaarheid wilt, maar specifieke landen moet beperken.

Voorbeeld — blokkeer bezoekers uit de VS en Canada:

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

Belangrijke opmerkingen

Landbeperkingen regelen de toegang; taaldetectie bepaalt de taal van de ervaring voor bezoekers die deze kunnen gebruiken.

  • Whitelist heeft prioriteit. Als whitelisted_geos is ingesteld, wordt blocked_geos volledig genegeerd.
  • Gebruik één modus tegelijk. Zet óf de landen op de whitelist die je wilt, óf de landen die je niet wilt op de blacklist — niet allebei.
  • Landcodes zijn niet hoofdlettergevoelig ("us" en "US" werken allebei).
  • Als het land van een bezoeker niet kan worden bepaald, wordt die bezoeker niet geblokkeerd en kan normaal interageren.

Veelvoorkomende landcodes

LandCode
Verenigde StatenUS
CanadaCA
Verenigd KoninkrijkGB
AustraliëAU
DuitslandDE
FrankrijkFR
JapanJP
BraziliëBR
IndiaIN
MexicoMX

Voor een volledige lijst met landcodes, zie de ISO 3166-1 alpha-2-referentie .