Wie richte ich country & rate limiting ein?

Erfahren Sie, wie Sie country & rate limiting konfigurieren, um sicherzustellen, dass Ihr GatewayAPI-Account SMS-Nachrichten nur in die Länder oder mit den rate limits versenden kann, die Sie explizit genehmigt haben.

Diese Sicherheitsfunktion verhindert, dass Ihr Account für den Versand von SMS-Nachrichten in blockierte Länder genutzt wird – selbst wenn Ihre API-Keys kompromittiert werden oder Sie das Ziel eines SMS pumping / AIT-Angriffs sind.

Bitte beachten Sie, dass standardmäßig alle Länder erlaubt sind, wenn Sie einen neuen Account erstellen. Wenn Sie den Zugriff einschränken möchten, müssen Sie Ihre zugelassenen Länder manuell auswählen.

Beachten Sie außerdem, dass Sie für die Nutzung der rate limiting-Funktion die neue Mobile Messaging API verwenden müssen.

In der folgenden Schritt-für-Schritt-Anleitung wird die Einrichtung im Detail erläutert.

Schritt 1: Gehen Sie auf country & rate limiting

Sie können die Ländersperre in Ihrem Dashboard konfigurieren, indem Sie auf „SMS“ → „Country & Rate Limiting“ klicken.

Schritt 2: Wählen Sie die Länder aus, in die Sie SMS senden möchten

Sie können entweder im Suchfeld nach Ländern suchen oder diese aus der Liste auswählen. Um ein Land zur Liste der zulässigen Länder hinzuzufügen, klicken Sie es an, sodass es in der rechten Spalte erscheint. Wenn Sie das falsche Land angeklickt haben, können Sie dies durch erneutes Anklicken rückgängig machen.

Schritt 3: Rate limits festlegen (optional)

• Klicken Sie auf die drei Punkte neben dem Land unter Actions → Edit Limit.
• Wechseln Sie zu Daily limit und geben Sie die gewünschte Anzahl an Nachrichten ein.
• Klicken Sie auf Save.

Hinweis: Diese Funktion wird von der REST API nicht unterstützt.

Nein, für diese Funktion fallen keine zusätzlichen Kosten an – sie ist völlig kostenfrei.

Wenn eine SMS in ein Land gesendet wird, das nicht auf der Liste der zulässigen Länder steht, führt dies zu einem HTTP-Fehlercode 422 – die SMS wird nicht zugestellt und die Nachricht wird nicht berechnet. Dasselbe gilt, wenn Sie eine SMS an eine Gruppe von Ländern senden und nur eines der Länder nicht als zulässiges Land markiert ist. In diesem Fall wird keine der Nachrichten gesendet oder berechnet.

Wenn sich der Empfänger der Nachricht auf Reisen befindet und sich in einem Land aufhält, das Sie gesperrt haben, wird die Nachricht dennoch zugestellt. Das liegt daran, dass eine eventuelle Sperrung in unserem System vor dem Versand anhand der Ländervorwahl der Handynummer (z. B. +45) erfolgt und nicht anhand des Aufenthaltsorts des Empfängers.

Sobald Ihr ausgehender SMS-Traffic das eingestellte Tageslimit für ein Ziel erreicht, stoppt unser System die Verarbeitung aller nachfolgenden Nachrichten. Für blockierte Nachrichten entstehen Ihnen keinerlei Kosten.

GatewayAPI sendet für jede blockierte Nachricht einen webhook mit einem Zustellbericht (DLR). Der webhook enthält den Fehlercode 0x1908 sowie folgende Meldung:

“Destination blocked – geo restrictions applied”

Alle Zähler werden jeden Tag automatisch um 00:00 UTC zurückgesetzt. Pünktlich um Mitternacht UTC stehen Ihre festgelegten Tageskontingente wieder zur Verfügung, sodass der reguläre Nachrichtenversand sofort fortgesetzt werden kann.

Ja. Über die Einstellung “Rest der Welt” können Sie ein einheitliches Standard-Tageslimit für alle verbleibenden Ziele auf einmal festlegen.

So sichern Sie Ihren Account effektiv gegen Betrug ab, ohne den Versand in andere Länder komplett zu unterbinden.