Die passende +55-Route für SMS-Verifizierung in Brasilien wählen

Sollte ein Brasilien-Test das OTP Gateway oder eine Langzeitnummer nutzen?

Beginnen Sie mit der Form der Aufgabe, denn sie bestimmt das Produkt. Ein brasilianischer Verifizierungstest braucht meist einen Code, einmal: einen Registrierungsbildschirm auf Portugiesisch, eine Login-Abfrage, einen Schritt zum Telefonwechsel. Genau dafür ist das OTP Gateway gebaut. Sie wählen einen Dienst und Brasilien, erhalten eine +55-Nummer für einen einzelnen Code, und die Aktivierung endet nach 20 Minuten oder wenn die SMS eintrifft.

Eine Langzeitnummer ist etwas anderes. Dedicated Numbers sind ein Produkt für die USA und Kanada, sofort im Dashboard ab $1.95/Monat erhältlich, mit eingehenden SMS, ausgehenden SMS und Anrufen im Browser. Eine selbst buchbare Langzeitnummer für +55 gibt es nicht. Braucht Ihr Team wirklich eine brasilianische Nummer, die es behalten kann, schreiben Sie an [email protected] und beschreiben Sie den Anwendungsfall; ob etwas möglich ist, hängt von den lokalen Vorschriften ab, und es wird nichts zugesagt.

Eine schnelle Faustregel:

• Ein Code pro Testfall, bei jedem Lauf frischer Zustand: OTP Gateway mit br.
• Ein Staging-Konto, das sich nächsten Monat wieder anmelden muss: eine US- oder kanadische Dedicated Number, sofern der Dienst sie akzeptiert.
• Unsicher: Lesen Sie temporäre vs. dedizierte Nummern, bevor Sie etwas kaufen.

Welche Apps können jetzt Codes an eine brasilianische Nummer senden?

Die Brasilien-Route deckt derzeit mehr als 2.900 Dienste ab, und zu den beliebten im Live-Stand gehören WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, TikTok, Uber, Discord, Microsoft & Outlook, LinkedIn, Netflix, Airbnb, Shopee und AliExpress.

Verstehen Sie diese Liste als Momentaufnahme und nicht als Vertrag. Die Verfügbarkeit ändert sich im Tagesverlauf, da unsere Carrier-Partner Routen hinzufügen und rotieren, daher sollte eine Pipeline die API fragen, statt einer fest hinterlegten Liste zu vertrauen. Das Länderverzeichnis zeigt dieselben Live-Daten für alle, die den Browser bevorzugen.

Wie sieht der Brasilien-OTP-API-Ablauf in der Praxis aus?

Jeder Aufruf geht an https://otproute.com/api/v1 mit einem Bearer-Key mit dem Präfix or_live_, der in der Developer-Konsole erzeugt wird. Die Länder-ID von Brasilien ist br.

1. Lösen Sie Dienst-IDs einmal mit GET /api/v1/services auf und halten Sie sie in der Konfiguration.
2. Rufen Sie vor dem Bestellen GET /api/v1/prices?country=br&service=whatsapp auf (oder mit Ihrer Dienst-ID). Die Antwort enthält den Live-Preis und die Verfügbarkeit für diese Kombination.
3. Legen Sie die Aktivierung mit POST /api/v1/activations und dem Body {"service": "whatsapp", "country": "br"} an. Speichern Sie die Aktivierungs-ID neben Ihrem Testlauf.
4. Tippen Sie die +55-Nummer in den getesteten Ablauf ein.
5. Lauschen Sie auf das Ereignis activation.sms_received an einem Webhook; als Fallback prüfen Sie GET /api/v1/activations/{id} alle paar Sekunden.
6. Bricht der Test ab, geben Sie die Nummer mit POST /api/v1/activations/{id}/cancel frei, damit das Guthaben sofort zurückgeht.

Webhook-Zustellungen sind in X-OTPRoute-Signature als t=<unix>,v1=<hex> signiert: ein HMAC-SHA256 von <t>.<raw body> mit dem Endpoint-Secret. Prüfen Sie ihn, verwerfen Sie veraltete Zeitstempel und machen Sie den Handler über die Aktivierungs-ID idempotent. Die vollständige Referenz steht in der API-Dokumentation.

Kann das Growth-Team das ohne Code erledigen?

Ja. Das Dashboard bildet dasselbe OTP-Routing ohne Skripte ab:

1. Erstellen Sie ein Konto mit Ihrer E-Mail und einem 6-stelligen E-Mail-Code oder per Google-Anmeldung.
2. Laden Sie Guthaben auf das USD-Guthaben.
3. Wählen Sie Brasilien und den Dienst, prüfen Sie den angezeigten Preis und bestellen Sie.
4. Fügen Sie die +55-Nummer in die App ein und beobachten Sie, wie der Code auf der Aktivierungskarte erscheint.

Marketing, Support und Lokalisierungs-Reviewer nutzen diesen Weg oft, um vor einem Release zu bestätigen, dass sich ein portugiesischer Onboarding-Bildschirm korrekt verhält, während Entwickler die API für automatisierte Läufe behalten.

Wie sollten +55-Nummern gespeichert und normalisiert werden?

Brasilianische Nummern bestehen aus einer zweistelligen Vorwahl (DDD) gefolgt von der Teilnehmernummer, und Mobilnummern haben neun Ziffern, die mit 9 beginnen. Innerhalb Brasiliens wählt man bei Ferngesprächen eine führende 0 plus einen Carrier-Auswahlcode, weshalb Nutzereingaben oft zusätzliche Ziffern enthalten, die nicht in die Speicherung gehören.

Speichern Sie alles im E.164-Format: +55, die Vorwahl, dann die Teilnehmernummer, ohne Leerzeichen, ohne führende 0 und ohne Carrier-Code. Normalisieren Sie bei der Eingabe, vergleichen Sie über den normalisierten Wert und formatieren Sie nur für die Anzeige. Codes brasilianischer Absender kommen meist auf Portugiesisch an, manchmal auf Englisch, werten Sie also die Ziffern aus, statt einen festen Satz abzugleichen.

Teams testen diesen Markt für einen Brasilien-Launch, für die Lokalisierungs-QA auf Portugiesisch und für Onboarding-Abläufe, die neben den Pflichten aus Brasiliens Datenschutzgesetz, der LGPD, stehen. Unsere Seite zum Fintech-Onboarding behandelt die Verifizierungsseite dieser Arbeit.

Was, wenn ein brasilianischer Code nie erscheint?

Lassen Sie zuerst das 20-Minuten-Fenster laufen; manche Absender sind langsamer als andere, und die Zustellung hängt vom Dienst und von der Route ab. Läuft es ab, wird die Abbuchung automatisch rückgängig gemacht, und Sie können etwas später oder über eine andere von der API gelistete Route erneut versuchen.

• Prüfen Sie, ob der Dienst überhaupt virtuelle Nummern akzeptiert. Manche tun es nicht, und genau dafür gibt es die Erstattungsregel.
• Bestellen Sie nicht in einer engen Schleife neu. Warten Sie zwischen den Versuchen und protokollieren Sie jede Aktivierungs-ID.
• Prüfen Sie, ob Ihre App die Nummer vollständig in internationaler Form gesendet hat und nicht in einem lokalen Format mit Netzpräfix-Ziffern.

Der Leitfaden zum Reduzieren fehlgeschlagener OTP-Zustellungen listet weitere Diagnosen auf.

Wie hängen Guthaben, Rechnungen und Sandbox zusammen?

OTP Route rechnet über ein vorausbezahltes USD-Guthaben ab: Bezahlung nach Verbrauch, keine Monatsgebühr und kein Tarif zur Auswahl. Laden Sie es per Karte oder mit USDT oder USDC auf, und zu jeder Aufladung kommt eine PDF-Rechnung per E-Mail. Alle Preise stehen auf der Seite Preise und in der API.

Für Integrationsarbeit bitten Sie den Support, ein Entwicklungskonto auf Sandbox umzustellen. Es liefert simulierte Nummern und Codes, sodass Sie den Aktivierungs- und Webhook-Pfad Ende-zu-Ende durchspielen können, ohne Guthaben anzutasten. Nutzen Sie es nur für Ihre eigenen Produkte, halten Sie sich an die Bedingungen des jeweiligen Dienstes und denken Sie daran, dass die Acceptable Use Policy für jedes Konto gilt.

Häufige Fragen

Kann ich den brasilianischen Registrierungsablauf meiner App ohne lokale SIM-Karte testen?

Ja. Bestellen Sie im OTP Gateway eine +55-Nummer für Ihre eigene App oder einen unterstützten Dienst, geben Sie sie im Ablauf ein und lesen Sie den Code im Dashboard oder über die API aus.

Wie lautet die Länder-ID von Brasilien in der OTP-Route-API?

Sie lautet br. Übergeben Sie sie als Feld country beim Anlegen einer Aktivierung oder als Query-Parameter country am Preis-Endpunkt.

Werde ich belastet, wenn WhatsApp den Code nie an meine +55-Nummer sendet?

Nein. Erreicht innerhalb von 20 Minuten keine SMS die Nummer oder brechen Sie vorher ab, geht der volle Betrag automatisch zurück auf Ihr Guthaben.

Kann ich eine brasilianische Nummer kaufen und monatelang behalten?

Nicht als selbst buchbares Produkt. Langzeit-Dedicated-Numbers werden nur für die USA und Kanada verkauft; für Brasilien können Sie an [email protected] schreiben und fragen, ohne Verfügbarkeitszusage.

Soll ich die führende Null einer brasilianischen Nummer speichern?

Nein. Entfernen Sie die Netzpräfix-0 und jeden Carrier-Auswahlcode und speichern Sie die Nummer im E.164-Format, beginnend mit +55 und der zweistelligen Vorwahl.

In welcher Sprache sind brasilianische Verifizierungsnachrichten verfasst?

Die meisten kommen auf Portugiesisch an, einige globale Dienste senden englischen Text. Extrahieren Sie den numerischen Code, statt sich auf den Wortlaut zu verlassen.

Kann ich die API ausprobieren, bevor ich das Guthaben auflade?

Fragen Sie den Sandbox-Modus für ein Entwicklungskonto an. Er simuliert Nummern und Codes, sodass die gesamte Integration getestet werden kann, ohne Guthaben auszugeben.

Dienstnamen sind Marken ihrer jeweiligen Inhaber. OTP Route steht in keiner Verbindung zu ihnen. Nutzen Sie die Nummern rechtmäßig und beachten Sie die Bedingungen des jeweiligen Dienstes sowie unsere Richtlinie zur akzeptablen Nutzung.