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.

Rate limits gelten ausschließlich für SMS-Traffic über folgende Schnittstellen:

• Mobile Messaging API
• SMPP

Wenn Sie Traffic über unsere legacy REST API versenden, bleibt die Nachrichtenanzahl für zugelassene Länder im Rahmen der Standard-Einrichtung für country & rate limit unbegrenzt.

In unserer Anleitung erfahren Sie, wie Sie von der REST API auf unsere neue Mobile Messaging API wechseln, um das rate limit-Tool zu nutzen.

Bitte beachten Sie, dass RCS-Nachrichten von diesem Tool nicht erfasst werden und daher unbegrenzt bleiben.

Verknüpfte SMS-Nachrichten können zu einer geringfügigen, beabsichtigten Überschreitung des Limits führen. Liegt Ihr Limit beispielsweise bei 100 Nachrichten und Sie haben bereits 99 versendet, wird eine Nachricht aus zwei Segmenten noch vollständig zugestellt. Dadurch erhöht sich Ihr Tageszähler auf 101 Nachrichten. Alle darauffolgenden Zustellversuche in das jeweilige Land werden umgehend blockiert.

Nein. Durch das Erhöhen des täglichen country rate limit wird neuer Traffic sofort wieder freigegeben. Bereits abgelehnte Nachrichten werden jedoch nicht erneut gesendet, sondern bleiben dauerhaft storniert.