Thailändische Telefonverifizierung (+66) testen: Checkliste, Schritte und Lösungen

Bevor Sie starten: eine +66-Test-Checkliste

Thailändische Registrierungsabläufe haben ein paar Fallstricke, die sich auf dem Papier günstiger finden lassen als in einem fehlgeschlagenen CI-Lauf. Bestätigen Sie zuerst jeden Punkt:

• Zugangsdaten. Ein Bearer-Schlüssel mit dem Präfix or_live_ aus der Developer-Konsole, beschränkt auf die Umgebung, die ihn verwendet.
• Kennungen. Die Länder-ID von Thailand ist th; entnehmen Sie die Dienst-ID aus GET /api/v1/services, statt sie zu raten.
• Zustellungsweg. Entweder ein Webhook-Endpunkt mit gespeichertem Signatur-Secret oder ein Polling-Job, der das Limit von 300 Requests pro Minute einhält.
• Nummernbehandlung. Legen Sie fest, wie Ihr Code die nationale 0 entfernt, bevor Sie etwas speichern (siehe den Abschnitt zur Formatierung).
• Nachrichten-Parsing. Stellen Sie sicher, dass der Parser mit thailändischer Schrift um die Ziffern herum zurechtkommt.
• Budget. Ein aufgeladenes Wallet oder ein Sandbox-Konto, wenn Sie nur die Integration nachweisen wollen.

Welche thailändischen Registrierungsabläufe kann das OTP Gateway abdecken?

Thailand gehört zu den breiteren Routen, mit mehr als 1.800 Diensten in der Live-Momentaufnahme. Messaging und Handel prägen die lokale Nutzung, daher beginnen Teams meist mit LINE, Shopee, Lazada, TikTok, WhatsApp, Facebook, Instagram und Telegram. Weitere auf der Liste sind Google (Gmail & YouTube), Microsoft & Outlook, ChatGPT (OpenAI), Discord, Viber, Netflix, Amazon und Airbnb.

Die Verfügbarkeit pro Dienst ändert sich, wenn Nummern kommen und gehen; lesen Sie daher vor jedem Lauf den Preis-Endpunkt, statt Annahmen fest einzucodieren.

Eine Thailand-Verifizierungsnummer über die API bestellen

Die Basis-URL lautet https://otproute.com/api/v1.

1. Rufen Sie GET /api/v1/prices?country=th&service=<id> ab; eine leere oder „nicht verfügbar“-Antwort bedeutet, dass Sie einen anderen Zeitpunkt oder eine andere Route wählen sollten.
2. Senden Sie POST /api/v1/activations mit einem Body wie {"service": "line", "country": "th"}. Speichern Sie die zurückgegebene Aktivierungs-ID zusammen mit Ihrem Testlauf.
3. Tippen Sie die +66-Nummer in die zu testende App ein und lösen Sie die SMS aus.
4. Holen Sie den Code aus dem Ereignis activation.sms_received oder, wenn Sie per Polling arbeiten, aus GET /api/v1/activations/{id}.
5. Geben Sie nicht benötigte Bestellungen mit POST /api/v1/activations/{id}/cancel frei.

Prüfen Sie bei jeder Zustellung den Header X-OTPRoute-Signature (t=<unix>,v1=<hex>) und verwerfen Sie Ereignisse mit zu altem Zeitstempel. Ereignisse sind über die Aktivierungs-ID zugeordnet, was das Ignorieren doppelter Zustellungen einfach macht. Vollständige Request-Beispiele finden Sie in den Entwickler-Dokumenten.

Thailändische Nummernformate, die Null der Vorwahl und Nachrichten in thailändischer Schrift

National werden thailändische Mobilnummern mit einer führenden 0 und neun weiteren Ziffern geschrieben, meist beginnend mit 06, 08 oder 09. Diese 0 ist eine nationale Vorwahl: In der internationalen Form entfällt sie, sodass aus 08x xxx xxxx die Form +66 8x xxx xxxx wird. Speichern Sie die E.164-Version und normalisieren Sie jede Nutzereingabe, die noch die Null trägt, sonst behandelt Ihre Deduplizierung ein Gerät als zwei Personen.

Codes von Apps mit thailändischem Publikum kommen oft innerhalb eines thailändischen Satzes an. Extrahieren Sie den Code per Muster (eine Ziffernfolge der erwarteten Länge), statt sich an englischen Wörtern zu orientieren, und denken Sie daran, dass SMS in thailändischer Schrift Unicode-Kodierung nutzen, weshalb Nachrichten in kürzere Segmente zerfallen. Lokalisierungs-QA ist der andere Grund, warum Teams hier testen: Datumsfelder in thailändischen Oberflächen zeigen häufig das Jahr der buddhistischen Zeitrechnung, und Längenbegrenzungen bei Feldern für thailändische Namen und Adressen lassen sich leicht falsch setzen. Produkteinführungen in Südostasien, das Onboarding von Marktplatz-Verkäufern und thailändischsprachige Support-Desks runden die übliche Liste ab.

Wie nutzen Support- und Betriebsmitarbeitende stattdessen das Dashboard?

Nicht jede Prüfung braucht ein Skript. Jemand aus dem Betriebsteam kann sich registrieren, Guthaben aufladen, das OTP Gateway öffnen, einen Dienst und Thailand wählen, den genannten Preis prüfen und die Nummer erhalten. Der Code erscheint auf der Aktivierungskarte im Browser. Es gilt dasselbe 20-Minuten-Fenster, und die Erstattung erfolgt von selbst, wenn das Fenster leer abläuft.

Fehlersuche bei Codes, die die +66-Nummer nie erreichen

Bleibt eine Aktivierung leer, arbeiten Sie diese Liste ab:

• Geben Sie ihr das volle Fenster, bevor Sie abbrechen; verzögerte erneute Zustellungen sind üblich.
• Bestätigen Sie, dass der Dienst virtuelle Nummern für Thailand akzeptiert. Manche tun es nicht, und genau das deckt die automatische Erstattung ab.
• Versuchen Sie es später erneut oder wechseln Sie zu einer anderen Länderroute, falls Ihr Testfall das zulässt. Der Artikel zum Länder-Routing erklärt, wie Teams Ausweichrouten wählen.
• Staffeln Sie Wiederholungen zeitlich. Neubestellen in enger Schleife hilft selten und füllt Ihre Logs.

Bei einem fehlgeschlagenen Versuch geht kein Geld verloren: Eine abgelaufene oder abgebrochene Aktivierung bringt den vollen Betrag zurück ins Wallet.

Langzeitleitungen, Wallet und Sandbox für thailändische Projekte

OTP Route verkauft in Thailand keine langfristige Nummer im Self-Service. Teams, die eine dauerhafte thailändische Leitung brauchen, können per E-Mail an [email protected] anfragen; die lokalen Vorschriften entscheiden, ob etwas möglich ist. Dedizierte Nummern, die Sie behalten und verlängern, gibt es nur in den USA und Kanada, ab $1.95/month.

Alles andere läuft über ein vorausbezahltes USD-Wallet ohne Abonnement. Laden Sie per Karte oder USDT/USDC auf; für jede Aufladung wird eine PDF-Rechnung per E-Mail verschickt. Für Integrationsarbeit kann ein Entwicklungskonto in die Sandbox versetzt werden, sodass simulierte Nummern und Codes kostenlos durch Ihren Code laufen. Aktuelle Preise finden Sie unter Preise; halten Sie sich an die Bedingungen des jeweiligen Dienstes und denken Sie daran, dass die Acceptable Use Policy von OTP Route jede Aktivierung abdeckt.

Häufige Fragen

Kann ich die thailändische Registrierung meiner App ohne thailändische SIM-Karte verifizieren?

Ja. Bestellen Sie eine +66-Nummer im OTP Gateway, geben Sie sie in Ihrer App ein und lesen Sie den Code im Dashboard oder über die API und Webhooks aus.

Sollte ich beim Speichern einer thailändischen Mobilnummer die führende 0 behalten?

Nein. Lassen Sie die nationale 0 weg und speichern Sie die Nummer als +66 gefolgt von den restlichen neun Ziffern.

Welche ID erwartet die API für Thailand?

Verwenden Sie th als Länderwert, zum Beispiel in GET /api/v1/prices?country=th&service=<id>.

Warum kommt die Nachricht von LINE oder Shopee auf Thai an?

Viele Dienste lokalisieren ihre SMS-Vorlage nach dem Land der Nummer oder der Kontosprache; parsen Sie daher Ziffern statt englischer Schlüsselwörter.

Was kostet eine fehlgeschlagene Thailand-Aktivierung?

Nichts. Endet das 20-Minuten-Fenster ohne SMS oder brechen Sie ab, geht der volle Betrag automatisch auf Ihr Wallet zurück.

Gibt es eine Möglichkeit, thailändische OTP-Tests in CI ohne Kosten durchzuführen?

Ja, fordern Sie den Sandbox-Modus für ein Entwicklungskonto an. Er liefert simulierte Nummern und Codes, sodass die Pipeline durchgängig getestet werden kann, wie auf der CI/CD-Lösungsseite beschrieben.

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.