Eine Checkliste für den Empfang von TikTok-SMS-Codes in Tests und im Betrieb

Wofür sendet TikTok SMS-Codes?

TikTok erlaubt es, ein Konto mit einer Telefonnummer anzulegen, sich statt mit einem Passwort mit einem Einmalcode anzumelden, die Bestätigung in zwei Schritten zu aktivieren und den Zugang bei vergessenem Passwort zurückzusetzen. Jeder dieser Momente kann einen SMS-Code auslösen, und jeder ist ein Schritt, den Teams rund um TikTok womöglich nachstellen müssen: eine Agentur, die ein von ihr betreutes Markenkonto bestätigt, ein QA-Engineer, der eine Social-Login-Integration prüft, oder ein Betriebsteam, das ein Unternehmensprofil vom privaten Handy eines Mitarbeiters fernhält.

Eine virtuelle Nummer für TikTok passt zu diesen Fällen, wobei die TikTok-SMS-Verifizierung zum Testen am häufigsten vorkommt. Alle sind legitim, wenn das Konto Ihnen oder Ihrem Kunden gehört und im Rahmen der Bedingungen von TikTok bleibt.

Checkliste vor der Bestellung

Zehn Minuten für diese Punkte vor der ersten TikTok-Bestellung ersparen später Stunden bei der Suche nach fehlenden Codes:

• Den Markt wählen. Das Land der Nummer sollte zur Region des Kontos oder zum Testfall passen, den Sie nachstellen.
• Preis und Verfügbarkeit prüfen. GET /api/v1/prices?country=<id>&service=tiktok liefert beides live.
• Guthaben aufladen. GET /api/v1/balance zu Beginn eines Laufs schlägt früh fehl, statt mitten im Test.
• Die Zustellung festlegen. Webhook für CI und parallele Jobs, Polling für schnelle manuelle Prüfungen.
• An die erneute Anmeldung denken. Muss sich das Konto nächsten Monat erneut anmelden, ist eine Einmalnummer das falsche Werkzeug (siehe letzter Abschnitt).
• Die Regeln kennen. Ein Konto pro realer Person oder Unternehmen, die Bedingungen von TikTok und die Acceptable Use Policy von OTP Route.

Aus welchem Land sollte die TikTok-Telefonnummer stammen?

Die TikTok-Route ist in 202 Ländern geöffnet. Häufige Wahlen sind die USA, Kanada, das Vereinigte Königreich, Deutschland, Frankreich, Brasilien, Mexiko, Indonesien, die Philippinen, Vietnam, Thailand, die Türkei, Saudi-Arabien, Pakistan, Nigeria und Kenia.

Die Länderwahl ist nicht nur Kosmetik. TikTok passt Inhalte, Funktionen und Registrierungsprüfungen an die Region an, daher sollte ein QA-Fall für einen Brasilien-Launch eine +55-Nummer verwenden und ein Lokalisierungstest für die Philippinen eine +63-Nummer. Eine Abweichung zwischen der Nummer und dem Markt des Kontos ist ein häufiger Grund, warum sich ein Ablauf anders verhält als das, was Nutzer sehen.

Schritt für Schritt: die TikTok-Verifizierungscode-API

Authentifizieren Sie sich gegen https://otproute.com/api/v1 mit einem Bearer-Schlüssel, der mit or_live_ beginnt und aus der Developer-Konsole stammt.

1. Ermitteln Sie die Länder-ID mit GET /api/v1/countries; die Service-ID ist tiktok.
2. Lesen Sie den aktuellen Preis: GET /api/v1/prices?country=br&service=tiktok.
3. Legen Sie die Aktivierung mit POST /api/v1/activations und {"service": "tiktok", "country": "br"} an. Behalten Sie die Aktivierungs-ID aus der Antwort.
4. Geben Sie die zurückgegebene Nummer auf dem Telefonbildschirm von TikTok ein und fordern Sie den Code an.
5. Holen Sie ihn aus dem Ereignis activation.sms_received oder fragen Sie GET /api/v1/activations/{id} alle paar Sekunden ab.
6. Wird das Szenario abgebrochen, rufen Sie POST /api/v1/activations/{id}/cancel auf, damit das Guthaben sofort zurückfließt.

Das Limit pro Konto liegt bei 300 Anfragen pro Minute, reichlich für das Polling mehrerer Aktivierungen gleichzeitig. Die API-Dokumentation listet die vollständigen Anfrage- und Antwortformate auf.

Den Webhook-Empfänger aufbauen

Registrieren Sie einen HTTPS-Endpunkt in der Developer-Konsole (bis zu 5 pro Konto) und abonnieren Sie activation.sms_received, activation.expired und activation.cancelled. Härten Sie ihn dann ab:

• Zerlegen Sie X-OTPRoute-Signature in t und v1, berechnen Sie HMAC-SHA256 von <t>.<raw body> mit dem Endpunkt-Secret und vergleichen Sie in konstanter Zeit.
• Lehnen Sie Zeitstempel ab, die mehr als ein paar Minuten alt sind, um Replays zu verhindern.
• Behandeln Sie die Aktivierungs-ID als Idempotenzschlüssel, damit ein erneut zugestelltes Ereignis nichts doppelt aktualisiert.
• Antworten Sie schnell mit 2xx und übergeben Sie aufwendige Arbeit an eine Warteschlange.

Behalten Sie Polling als Ausweichweg für die lokale Entwicklung, wo keine öffentliche URL existiert. Unser Leitfaden zum Absichern von OTP-Webhooks geht den Verifizierungscode durch.

Fehlersuche bei einem TikTok-Code, der nie erscheint

Schweigen von TikTok hat meist eine gewöhnliche Ursache:

1. Das Fenster abwarten. Die Aktivierung bleibt 20 Minuten offen; kommt nichts an, wird die volle Gebühr automatisch erstattet.
2. Hinnehmen, dass manche Nummern abgelehnt werden. TikTok kann virtuelle Nummern in manchen Regionen oder Situationen ablehnen, und die Erstattungsregel deckt diesen Fall ab.
3. Nur eine Variable ändern. Versuchen Sie es später erneut oder mit einem anderen Land, das weiterhin zu Ihrem Test passt.
4. Langsamer vorgehen. Wiederholte Code-Anforderungen in kurzer Zeit können die eigenen Rate-Limits von TikTok auslösen; verteilen Sie die Versuche.
5. Die eigene Seite prüfen. Vergewissern Sie sich, dass die Nummer im vollständigen internationalen Format eingegeben wurde und dass Ihr Webhook ein 2xx zurückgegeben hat.

Wann ist eine dedizierte US- oder Kanada-Leitung besser?

Eine einmalige Aktivierung genügt für eine einzelne Verifizierung. Ein Markenkonto, das sich Monate später erneut anmelden, den Zugang wiederherstellen oder Zwei-Schritt-Prüfungen bestehen muss, braucht eine Nummer, die Ihr Team behält. Dedicated Numbers decken diesen Fall in den USA und Kanada ab $1.95/Monat ab, mit eingehenden SMS im Dashboard und auf Ihrem Webhook über number.sms_received; siehe virtuelle Nummern. In anderen Ländern sind Self-Service-Langzeitleitungen nicht verfügbar.

Alle Ausgaben kommen aus einem Prepaid-USD-Guthaben, das per Karte oder USDT/USDC aufgeladen wird, mit einer PDF-Rechnung für jede Aufladung. Für Integrationstests mit simulierten Codes kann auf Anfrage ein Sandbox-Konto aktiviert werden.

Häufige Fragen

Wie bekomme ich einen TikTok-Code automatisch an mein Backend geliefert?

Bestellen Sie eine Aktivierung mit der Service-ID tiktok und empfangen Sie den Code dann über den signierten Webhook activation.sms_received oder durch Abfrage von GET /api/v1/activations/{id}.

Kann ich die TikTok-SMS-Verifizierung für ein bestimmtes Land testen?

Ja. Wählen Sie das Land beim Anlegen der Aktivierung; die TikTok-Route deckt derzeit 202 Länder ab, und die Live-Verfügbarkeit kommt vom Prices-Endpunkt.

Was kostet ein TikTok-OTP?

Ab $0.20 pro Code, je nach Land. Der genaue Wert erscheint vor der Bestellung im Dashboard und in GET /api/v1/prices.

Was passiert, wenn TikTok die virtuelle Nummer ablehnt?

Es kommt keine SMS an, die Aktivierung läuft nach 20 Minuten ab oder Sie brechen sie ab, und der volle Betrag geht zurück in Ihr Guthaben.

Reicht eine Einmalnummer für ein Markenkonto, das wir langfristig betreuen?

In der Regel nicht. Für wiederholte Anmeldungen und die Wiederherstellung nutzen Sie eine Dedicated Number aus den USA oder Kanada, die Ihr Team behält, solange sie sich verlängert.

Kann ich OTP Route nutzen, um viele TikTok-Konten anzulegen?

Nein. OTP Route dient dazu, Ihre eigenen legitimen Konten und Produkte zu testen und zu betreiben; halten Sie sich an die Bedingungen von TikTok und bleiben Sie bei einem Konto pro realer Person oder Unternehmen.

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.