Checklist avant le départ pour recevoir des codes de connexion Telegram sur un numéro de test

Que faut-il préparer avant de commander un numéro Telegram ?

Parcourez d'abord cette liste ; la plupart des tests Telegram qui échouent viennent de l'un de ces points.

• Un objectif clair. Vous testez un bot, une Mini App, un widget de connexion ou un workflow de support exploité par votre propre équipe, et il vous faut un compte Telegram neuf qui n'est relié au téléphone personnel d'aucun salarié.
• Un pays cible. Décidez à quel marché le compte doit sembler appartenir. La langue par défaut et certains écrans d'accueil suivent le pays du numéro.
• Des fonds ou le sandbox. Un portefeuille prépayé approvisionné, ou un compte de développement passé en sandbox par le support pour les essais à blanc.
• Une clé API, si vous automatisez. Créez-en une avec le préfixe or_live_ dans la console Développeur.
• Un appareil ou un émulateur propre. Telegram envoie les codes dans l'application à toute session déjà connectée ; un appareil sans session existante rend donc le parcours SMS prévisible.
• Du temps. Chaque activation reste ouverte 20 minutes ; n'en lancez pas une avant que le testeur soit prêt à saisir le numéro.

Quand Telegram envoie-t-il réellement un code par SMS ?

Telegram identifie chaque compte par son numéro de téléphone. Il demande un code lors de la création d'un nouveau compte et lorsqu'un compte existant se connecte sur un nouvel appareil. Si ce compte est déjà actif ailleurs, Telegram envoie généralement le code de connexion sous forme de message dans la session existante plutôt que par SMS ; c'est pourquoi un tout nouveau numéro sur un appareil vierge est le moyen le plus propre de tester l'étape SMS. Il peut aussi proposer un appel ou un nouvel envoi après une courte attente.

La vérification en deux étapes de Telegram est un mot de passe cloud distinct, défini dans l'application. Ce n'est pas un facteur SMS ; stockez donc ce mot de passe dans le gestionnaire de secrets de votre équipe si vous l'activez sur un compte de test.

Quels pays puis-je choisir pour Telegram, et pourquoi est-ce important ?

Le service telegram est actuellement proposé dans 199 pays, dont l'Inde, l'Allemagne, le Brésil, le Nigeria, l'Indonésie, le Royaume-Uni, l'Ukraine, le Kazakhstan, l'Ouzbékistan, la Turquie, l'Espagne, le Mexique, les Philippines, le Vietnam et l'Égypte.

Alignez le pays sur le cas de test. Un bot qui répond en portugais doit être essayé depuis un compte brésilien ; une équipe de support couvrant l'Asie centrale voudra peut-être un numéro kazakh. Telegram peut aussi traiter avec plus de prudence les numéros de certains pays, donc si une route échoue sans cesse, un marché voisin est un repli raisonnable. La disponibilité en direct évolue au fil de la journée ; lisez-la donc depuis l'API plutôt que dans une liste enregistrée.

Comment automatiser le code Telegram avec l'API ?

1. Vous pouvez confirmer le coût avec GET /api/v1/prices?country=<id>&service=telegram.
2. Créez la commande : POST /api/v1/activations avec {"service": "telegram", "country": "<id>"}, où l'identifiant du pays provient de GET /api/v1/countries (par exemple br ou de).
3. Transmettez le numéro renvoyé à votre exécuteur de tests, qui le saisit dans le client Telegram ou l'émulateur.
4. Attendez le code. Avec un webhook, écoutez activation.sms_received ; sinon, interrogez GET /api/v1/activations/{id} à intervalle raisonnable.
5. Nettoyez avec POST /api/v1/activations/{id}/cancel si le test est interrompu.

Pour les webhooks, vérifiez X-OTPRoute-Signature en recalculant un HMAC-SHA256 sur <t>.<raw body> avec le secret du endpoint, rejetez les horodatages trop anciens et consignez chaque identifiant d'activation déjà traité afin qu'un événement renvoyé soit ignoré. Chaque compte dispose de 5 endpoints de webhook au maximum et de 300 requêtes par minute. Le guide du pipeline CI traite des exécutions en parallèle.

Puis-je faire la même chose à la main dans le tableau de bord ?

Oui. Connectez-vous, ouvrez l'OTP Gateway, choisissez Telegram et le pays, vérifiez le prix, puis commandez. Copiez le numéro dans l'écran de téléphone de Telegram, sélectionnez l'indicatif de pays correspondant et demandez le code. Quand le SMS arrive, il s'affiche à côté de la commande, prêt à être collé.

Le code Telegram n'est pas arrivé. Que contient la liste de dépannage ?

• Existe-t-il une session ouverte ? Si le numéro a déjà servi, Telegram a peut-être envoyé le code dans l'application. Une nouvelle activation évite ce cas.
• La fenêtre est-elle terminée ? Laissez le minuteur de 20 minutes aller au bout. Vous ne payez que si le code arrive ; l'expiration ou l'annulation rembourse automatiquement la totalité du montant.
• La route est-elle acceptée ? Telegram peut refuser certains numéros virtuels. Cela échappe à notre contrôle et c'est précisément la raison d'être de la règle de remboursement.
• Réessayez en espaçant. Commandez à nouveau plus tard ou dans un autre pays ; ne recommandez pas en boucle serrée, ce qui n'aide ni la livraison ni votre limite de débit.
• Vérifiez l'indicatif pays sur l'appareil. Une incohérence entre le pays sélectionné et le numéro est une erreur facile dans les tests manuels.

Quand un Numéro dédié convient-il mieux pour Telegram ?

Un numéro OTP Gateway à usage unique convient aux tests d'inscription. Si le compte Telegram doit se reconnecter le mois prochain, par exemple un compte d'équipe qui gère un canal de support ou la connexion administrateur d'un bot, il lui faut un numéro que votre équipe contrôle encore. Les Numéros dédiés aux États-Unis et au Canada, à partir de $1.95/mois, restent à vous tant qu'ils se renouvellent et transmettent les SMS entrants au tableau de bord ainsi qu'à votre webhook sous la forme number.sms_received. La comparaison entre numéros temporaires et numéros dédiés explique l'arbitrage.

À quoi ressemble un test Telegram responsable ?

Respectez les conditions d'utilisation de Telegram. Créez un compte par personne réelle ou par usage professionnel, utilisez-le pour vos propres produits, bots et opérations, et jamais pour du spam, la création de comptes en masse ou le contournement d'un bannissement. Chaque commande Telegram que vous passez est aussi couverte par la politique d'utilisation acceptable d'OTP Route. Telegram est une marque de son propriétaire, et OTP Route n'y est pas affilié.

Questions fréquentes

Puis-je obtenir un code de vérification Telegram sans utiliser mon téléphone personnel ?

Oui. Commandez un numéro Telegram dans l'OTP Gateway d'OTP Route, saisissez-le dans l'application, puis lisez le code SMS dans le tableau de bord ou via l'API.

Quel est l'identifiant du service Telegram dans l'API ?

C'est telegram. Associez-le à un identifiant de pays issu de GET /api/v1/countries lors de la création d'une activation.

Combien coûte une vérification SMS Telegram pour des tests ?

À partir de $0.20 par code ; le prix exact dépend du pays et est renvoyé en direct par le endpoint des prix.

Pourquoi Telegram a-t-il envoyé le code dans l'application plutôt que par SMS ?

Telegram envoie les codes de connexion à une session existante lorsqu'il y en a une. Utilisez un numéro neuf et un appareil sans session connectée pour tester le parcours SMS.

Puis-je réutiliser un numéro à usage unique pour me reconnecter à Telegram plus tard ?

Non, les numéros OTP Gateway ne servent que pour un seul code. Pour des connexions répétées, utilisez un Numéro dédié aux États-Unis ou au Canada.

Suis-je facturé si Telegram rejette le numéro ?

Non. Si aucun code n'arrive sur le numéro en 20 minutes, ou si vous annulez, la totalité du montant retourne dans votre portefeuille.

Les noms de services sont des marques déposées de leurs propriétaires respectifs. OTP Route n'est affilié à aucun d'entre eux. Utilisez les numéros de manière licite et respectez les conditions de chaque service ainsi que notre Politique d'utilisation acceptable.