Den Chatbot nach Land einschränken (Geo-Blocking)

Manchmal soll der Shoply-AI-Chatbot nur in bestimmten Ländern verfügbar sein, oder du möchtest verhindern, dass er in bestimmten Ländern angezeigt wird. Auf dieser Seite wird erklärt, wie du den Zugriff auf Länderebene über die erweiterten Einstellungen konfigurierst.

Wo finde ich die erweiterten Einstellungen?

Gehe im Adminbereich der App zum Abschnitt „Einstellungen“ und scrolle dann zum Abschnitt „Erweiterte Einstellungen“. Dort kannst du ein JSON-Objekt  angeben, um verschiedene Einstellungen zu konfigurieren.

So funktioniert es

Shoply erkennt das Land eines Besuchers anhand seiner IP-Adresse. Abhängig von deiner Konfiguration sehen Besucher aus gesperrten Ländern den Chatbot möglicherweise weiterhin, können aber nicht mit ihm interagieren.

Es gibt zwei Modi:

• Whitelist-Modus – Interaktion nur für Besucher aus Ländern zulassen, die du ausdrücklich erlaubst. Alle anderen sehen den Chatbot, können ihn aber nicht verwenden.
• Blacklist-Modus – Interaktion für alle Besucher zulassen, außer für diejenigen aus Ländern, die du ausdrücklich sperrst.

Wenn keine der beiden Einstellungen konfiguriert ist, steht der Chatbot standardmäßig allen Besuchern weltweit uneingeschränkt zur Verfügung.

Einstellungen

Beide Einstellungen werden im JSON der erweiterten Einstellungen konfiguriert.

whitelisted_geos (Whitelist-Modus)

Eine Liste von Ländern, deren Besucher mit dem Chatbot interagieren dürfen. Besucher aus Ländern, die nicht auf dieser Liste stehen, sehen den Chatbot, können ihn aber nicht verwenden.

Verwende dies, wenn dein Shop nur bestimmte Märkte bedient und du die Interaktion überall sonst einschränken möchtest.

Format: Jeder Eintrag ist ein Objekt mit einem Feld countryCode, das den aus zwei Buchstaben bestehenden Ländercode nach ISO 3166-1 alpha-2  verwendet.

Beispiel – den Chatbot nur in den USA und Kanada zulassen:

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

blocked_geos (Blacklist-Modus)

Eine Liste von Ländern, deren Besucher von der Interaktion mit dem Chatbot ausgeschlossen sind. Sie sehen den Chatbot möglicherweise weiterhin, können ihn aber nicht verwenden. Besucher aus Ländern, die nicht auf dieser Liste stehen, können normal interagieren.

Verwende dies, wenn du eine breite Verfügbarkeit wünschst, aber bestimmte Länder einschränken musst.

Beispiel – Besucher aus den USA und Kanada sperren:

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

Wichtige Hinweise

• Die Whitelist hat Vorrang. Wenn whitelisted_geos gesetzt ist, wird blocked_geos vollständig ignoriert.
• Verwende jeweils nur einen Modus. Entweder setzt du die gewünschten Länder auf die Whitelist oder die unerwünschten auf die Blacklist – nicht beides.
• Bei Ländercodes wird nicht zwischen Groß- und Kleinschreibung unterschieden ("us" und "US" funktionieren beide).
• Wenn das Land eines Besuchers nicht ermittelt werden kann, wird er nicht gesperrt und kann normal interagieren.

Häufige Ländercodes

Eine vollständige Liste der Ländercodes findest du in der Referenz zu ISO 3166-1 alpha-2 .