Restreindre le chatbot par pays (blocage géographique)

Il peut arriver que vous souhaitiez rendre le chatbot Shoply AI disponible uniquement dans certains pays, ou l’empêcher d’apparaître dans des pays spécifiques. Cette page explique comment configurer le contrôle d’accès au niveau des pays avec les paramètres avancés.

Où trouver les paramètres avancés ?

Accédez à la section « Settings » de la console d’administration de l’application, puis faites défiler jusqu’à la section « Advanced Settings ». Dans cette section, vous pouvez fournir un objet JSON  pour configurer différents paramètres.

Fonctionnement

Shoply détecte le pays du visiteur à partir de son adresse IP. Selon votre configuration, les visiteurs des pays bloqués peuvent toujours voir le chatbot, mais ne pourront pas interagir avec lui.

Il existe deux modes :

• Mode liste blanche — n’autorisez l’interaction que pour les visiteurs des pays que vous autorisez explicitement. Tous les autres voient le chatbot mais ne peuvent pas l’utiliser.
• Mode liste noire — autorisez l’interaction pour tous les visiteurs, à l’exception de ceux venant des pays que vous bloquez explicitement.

Si aucun paramètre n’est configuré, le chatbot est entièrement accessible à tous les visiteurs dans le monde (par défaut).

Paramètres

Les deux paramètres se configurent dans le JSON des paramètres avancés.

whitelisted_geos (mode liste blanche)

Une liste des pays autorisés à interagir avec le chatbot. Les visiteurs de tout pays qui ne figure pas dans cette liste verront le chatbot mais ne pourront pas l’utiliser.

Utilisez-la lorsque votre boutique dessert un ensemble précis de marchés et que vous souhaitez restreindre l’interaction partout ailleurs.

Format : chaque entrée est un objet avec un champ countryCode qui utilise le code pays à deux lettres ISO 3166-1 alpha-2 .

Exemple — autoriser le chatbot uniquement aux États-Unis et au Canada :

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

blocked_geos (mode liste noire)

Une liste des pays dont les visiteurs sont empêchés d’interagir avec le chatbot. Ils pourront toujours voir le chatbot, mais ne pourront pas l’utiliser. Les visiteurs de tout pays qui ne figure pas dans cette liste peuvent interagir normalement.

Utilisez-la lorsque vous souhaitez une large disponibilité mais devez restreindre certains pays.

Exemple — bloquer les visiteurs des États-Unis et du Canada :

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

Notes importantes

• La liste blanche est prioritaire. Si whitelisted_geos est défini, blocked_geos est entièrement ignoré.
• Utilisez un seul mode à la fois. Soit vous mettez en liste blanche les pays souhaités, soit vous mettez en liste noire ceux que vous ne souhaitez pas — pas les deux.
• Les codes pays sont insensibles à la casse ("us" et "US" fonctionnent tous deux).
• Si le pays d’un visiteur ne peut pas être déterminé, il n’est pas bloqué et peut interagir normalement.

Codes pays courants

Pour la liste complète des codes pays, consultez la référence ISO 3166-1 alpha-2 .