Eine Checkliste vor dem Start: Telegram-Login-Codes auf einer Testnummer empfangen

Was sollte vor der Bestellung einer Telegram-Nummer bereit sein?

Gehen Sie zuerst diese Liste durch; die meisten fehlgeschlagenen Telegram-Tests lassen sich auf einen dieser Punkte zurückführen.

• Ein klarer Zweck. Sie testen einen Bot, eine Mini App, ein Login-Widget oder einen Support-Workflow, den Ihr eigenes Team betreibt, und brauchen ein frisches Telegram-Konto, das an kein privates Handy eines Mitarbeiters gebunden ist.
• Ein Zielland. Legen Sie fest, zu welchem Markt das Konto gehören soll. Spracheinstellungen und einige Onboarding-Bildschirme richten sich nach dem Land der Nummer.
• Guthaben oder Sandbox. Ein aufgeladenes Prepaid-Guthaben oder ein Entwicklungskonto, das der Support für Probeläufe in den Sandbox-Modus versetzt hat.
• Ein API-Schlüssel bei Automatisierung. Erstellen Sie einen mit dem Präfix or_live_ in der Developer-Konsole.
• Ein sauberes Gerät oder ein Emulator. Telegram liefert Codes innerhalb der App an jede bereits angemeldete Sitzung, daher macht ein Gerät ohne bestehende Sitzung den SMS-Weg vorhersehbar.
• Zeit. Jede Aktivierung ist 20 Minuten offen; starten Sie erst, wenn der Tester bereit ist, die Nummer einzutippen.

Wann sendet Telegram tatsächlich einen SMS-Code?

Telegram identifiziert jedes Konto über die Telefonnummer. Ein Code wird verlangt, wenn sich jemand neu registriert und wenn sich ein bestehendes Konto auf einem neuen Gerät anmeldet. Ist dieses Konto bereits anderswo aktiv, schickt Telegram den Login-Code meist als Nachricht in die bestehende Sitzung statt per SMS. Deshalb ist eine brandneue Nummer auf einem frischen Gerät der sauberste Weg, den SMS-Schritt zu testen. Nach kurzer Wartezeit kann auch ein Anruf oder ein erneuter Versand angeboten werden.

Die Bestätigung in zwei Schritten bei Telegram ist ein separates Cloud-Passwort, das in der App festgelegt wird. Es ist kein SMS-Faktor; speichern Sie dieses Passwort daher im Secret-Manager Ihres Teams, wenn Sie es für ein Testkonto aktivieren.

Welche Länder kann ich für Telegram wählen, und warum ist das wichtig?

Der Dienst telegram ist derzeit in 199 Ländern gelistet, darunter Indien, Deutschland, Brasilien, Nigeria, Indonesien, das Vereinigte Königreich, die Ukraine, Kasachstan, Usbekistan, die Türkei, Spanien, Mexiko, die Philippinen, Vietnam und Ägypten.

Passen Sie das Land an den Testfall an. Ein Bot, der auf Portugiesisch antwortet, sollte mit einem brasilianischen Konto ausprobiert werden; ein Support-Team für Zentralasien möchte vielleicht eine kasachische Nummer. Telegram behandelt Nummern aus manchen Ländern zudem vorsichtiger als aus anderen. Scheitert eine Route immer wieder, ist ein Nachbarmarkt ein vernünftiger Ausweg. Die Verfügbarkeit ändert sich im Tagesverlauf, lesen Sie sie daher aus der API aus, statt eine gespeicherte Liste zu verwenden.

Wie automatisiere ich den Telegram-Code mit der API?

1. Bestätigen Sie optional die Kosten mit GET /api/v1/prices?country=<id>&service=telegram.
2. Legen Sie die Bestellung an: POST /api/v1/activations mit {"service": "telegram", "country": "<id>"}, wobei die Länder-ID aus GET /api/v1/countries stammt (zum Beispiel br oder de).
3. Übergeben Sie die zurückgegebene Nummer an Ihren Test-Runner, der sie in den Telegram-Client oder Emulator eingibt.
4. Warten Sie auf den Code. Bei einem Webhook lauschen Sie auf activation.sms_received; andernfalls fragen Sie GET /api/v1/activations/{id} in sinnvollen Abständen ab.
5. Räumen Sie mit POST /api/v1/activations/{id}/cancel auf, falls der Durchlauf abbricht.

Prüfen Sie bei Webhooks X-OTPRoute-Signature, indem Sie HMAC-SHA256 über <t>.<raw body> mit dem Endpunkt-Secret neu berechnen, lehnen Sie alte Zeitstempel ab und merken Sie sich jede verarbeitete Aktivierungs-ID, damit ein erneut zugestelltes Ereignis ignoriert wird. Pro Konto stehen bis zu 5 Webhook-Endpunkte und 300 Anfragen pro Minute zur Verfügung. Der Leitfaden für CI-Pipelines behandelt parallele Läufe.

Kann ich dieselben Schritte von Hand im Dashboard ausführen?

Ja. Melden Sie sich an, öffnen Sie das OTP Gateway, wählen Sie Telegram und das Land, prüfen Sie den Preis und bestellen Sie. Kopieren Sie die Nummer in den Telefonbildschirm von Telegram, wählen Sie die passende Landesvorwahl und fordern Sie den Code an. Sobald die SMS eintrifft, erscheint sie neben der Bestellung und lässt sich direkt einfügen.

Der Telegram-Code kam nicht an. Was steht auf der Fehlersuche-Liste?

• Gibt es eine bestehende Sitzung? Wurde die Nummer schon einmal verwendet, hat Telegram den Code womöglich in der App zugestellt. Eine frische Aktivierung vermeidet das.
• Ist das Fenster abgelaufen? Lassen Sie den 20-Minuten-Timer durchlaufen. Sie zahlen nur, wenn der Code ankommt; bei Ablauf oder Abbruch wird der volle Betrag automatisch erstattet.
• Wird die Route akzeptiert? Telegram kann manche virtuellen Nummern ablehnen. Das liegt außerhalb unseres Einflusses und ist genau der Grund für die Erstattungsregel.
• Mit Abstand erneut versuchen. Bestellen Sie später oder in einem anderen Land erneut; bestellen Sie nicht in einer schnellen Schleife nach, das hilft weder der Zustellung noch Ihrem Rate-Limit.
• Landesvorwahl am Gerät prüfen. Eine Abweichung zwischen dem gewählten Land und der Nummer ist ein leicht passierender Fehler bei manuellen Tests.

Wann passt eine Dedicated Number besser zu Telegram?

Eine einmalige OTP-Gateway-Nummer eignet sich für Registrierungstests. Muss sich das Telegram-Konto nächsten Monat erneut anmelden, etwa ein Teamkonto, das einen Support-Kanal betreibt, oder der Admin-Login eines Bots, braucht es eine Telefonnummer, die Ihr Team weiterhin kontrolliert. Dedicated Numbers in den USA und Kanada ab $1.95/Monat bleiben bei Ihnen, solange sie sich verlängern, und leiten eingehende SMS an das Dashboard und als number.sms_received an Ihren Webhook weiter. Der Vergleich temporäre und dedizierte Nummern erklärt die Abwägung.

Wie sieht verantwortungsvolles Telegram-Testen aus?

Halten Sie sich an die Nutzungsbedingungen von Telegram. Erstellen Sie ein Konto pro realer Person oder geschäftlichem Zweck, verwenden Sie es für Ihre eigenen Produkte, Bots und Abläufe und niemals für Spam, Massenregistrierungen oder das Umgehen einer Sperre. Jede Telegram-Bestellung unterliegt außerdem der Acceptable Use Policy von OTP Route. Telegram ist eine Marke seines Inhabers, und OTP Route steht in keiner Verbindung dazu.

Häufige Fragen

Kann ich einen Telegram-Verifizierungscode erhalten, ohne mein privates Handy zu benutzen?

Ja. Bestellen Sie eine Telegram-Nummer im OTP Gateway von OTP Route, geben Sie sie in der App ein und lesen Sie den SMS-Code im Dashboard oder über die API.

Wie lautet die Service-ID für Telegram in der API?

Sie lautet telegram. Kombinieren Sie sie beim Anlegen einer Aktivierung mit einer Länder-ID aus GET /api/v1/countries.

Was kostet eine Telegram-SMS-Verifizierung zum Testen?

Ab $0.20 pro Code; der genaue Preis hängt vom Land ab und wird vom Prices-Endpunkt live zurückgegeben.

Warum hat Telegram den Code in der App statt per SMS gesendet?

Telegram stellt Login-Codes in einer bestehenden Sitzung zu, wenn eine vorhanden ist. Testen Sie den SMS-Weg mit einer frischen Nummer und einem Gerät ohne angemeldete Sitzung.

Kann ich eine Einmalnummer wiederverwenden, um mich später erneut bei Telegram anzumelden?

Nein, OTP-Gateway-Nummern gelten nur für einen einzigen Code. Für wiederholte Anmeldungen nutzen Sie eine Dedicated Number in den USA oder Kanada.

Werde ich belastet, wenn Telegram die Nummer ablehnt?

Nein. Erreicht die Nummer innerhalb von 20 Minuten kein Code oder brechen Sie ab, geht der volle Betrag zurück in Ihr Guthaben.

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.