Tester la vérification téléphonique thaïlandaise (+66) : liste de contrôle, étapes et correctifs

Avant de commencer : une liste de contrôle pour les tests +66

Les parcours d'inscription thaïlandais ont quelques pièges qu'il est moins coûteux de repérer sur le papier que dans une exécution CI en échec. Confirmez d'abord chaque point :

• Identifiants d'accès. Une clé Bearer préfixée or_live_ issue de la console Développeur, limitée à l'environnement qui l'utilisera.
• Identifiants de ressources. L'identifiant de pays de la Thaïlande est th ; prenez l'identifiant du service dans GET /api/v1/services plutôt que de le deviner.
• Mode de livraison. Soit un endpoint de webhook dont le secret de signature est enregistré, soit une tâche de polling qui respecte la limite de 300 requêtes par minute.
• Gestion des numéros. Décidez comment votre code retire le 0 national avant de stocker quoi que ce soit (voir la section sur le format).
• Analyse des messages. Assurez-vous que l'analyseur gère l'écriture thaïe autour des chiffres.
• Budget. Un portefeuille approvisionné, ou un compte sandbox si vous n'avez qu'à valider l'intégration.

Quels parcours d'inscription thaïlandais l'OTP Gateway peut-il couvrir ?

La Thaïlande est l'une des routes les plus étendues, avec plus de 1 800 services dans l'instantané en direct. La messagerie et le commerce dominent les usages locaux ; les équipes commencent donc généralement par LINE, Shopee, Lazada, TikTok, WhatsApp, Facebook, Instagram et Telegram. La liste comprend aussi Google (Gmail & YouTube), Microsoft & Outlook, ChatGPT (OpenAI), Discord, Viber, Netflix, Amazon et Airbnb.

La disponibilité par service change au gré des numéros qui vont et viennent ; lisez donc le endpoint de prix avant chaque exécution au lieu de coder en dur des hypothèses.

Commander un numéro de vérification thaïlandais via l'API

L'URL de base est https://otproute.com/api/v1.

1. Appelez GET /api/v1/prices?country=th&service=<id> ; une réponse vide ou indisponible signifie qu'il faut choisir un autre moment ou une autre route.
2. Envoyez POST /api/v1/activations avec un corps tel que {"service": "line", "country": "th"}. Enregistrez l'identifiant d'activation renvoyé avec votre exécution de test.
3. Saisissez le numéro +66 dans l'application testée et déclenchez le SMS.
4. Récupérez le code depuis l'événement activation.sms_received, ou depuis GET /api/v1/activations/{id} si vous faites du polling.
5. Libérez les commandes inutiles avec POST /api/v1/activations/{id}/cancel.

Vérifiez l'en-tête X-OTPRoute-Signature (t=<unix>,v1=<hex>) à chaque livraison et écartez les événements dont l'horodatage est trop ancien. Les événements sont indexés sur l'identifiant d'activation, ce qui permet d'ignorer facilement les livraisons en double. Des exemples de requêtes complets se trouvent dans la documentation pour développeurs.

Formats de numéros thaïlandais, zéro national et messages en écriture thaïe

Au niveau national, les numéros mobiles thaïlandais s'écrivent avec un 0 initial suivi de neuf chiffres, commençant généralement par 06, 08 ou 09. Ce 0 est un préfixe de ligne : au format international il disparaît, et 08x xxx xxxx devient +66 8x xxx xxxx. Stockez la version E.164 et normalisez toute saisie qui porte encore le zéro, faute de quoi votre déduplication comptera un seul téléphone comme deux personnes.

Les codes des applications destinées à la Thaïlande arrivent souvent au milieu d'une phrase en thaï. Extrayez le code par motif (une suite de chiffres de la longueur attendue) plutôt qu'en vous ancrant sur des mots anglais, et rappelez-vous que les SMS en écriture thaïe utilisent l'encodage Unicode, de sorte que les messages se découpent en segments plus courts. La QA de localisation est l'autre raison de tester ici : les champs de date des interfaces thaïes affichent couramment l'année de l'ère bouddhique, et les limites de longueur des champs pour les noms et adresses thaïs sont faciles à mal régler. Les lancements de produits en Asie du Sud-Est, l'intégration de vendeurs de places de marché et les services d'assistance en thaï complètent la liste habituelle.

Comment le support et les équipes d'exploitation utilisent-ils plutôt le tableau de bord ?

Toutes les vérifications ne nécessitent pas un script. Un membre de l'équipe d'exploitation peut s'inscrire, ajouter des fonds, ouvrir l'OTP Gateway, choisir un service et la Thaïlande, consulter le prix annoncé et recevoir le numéro. Le code arrive sur la carte d'activation dans le navigateur. La même fenêtre de 20 minutes s'applique, et le remboursement se fait tout seul si la fenêtre se ferme à vide.

Dépanner les codes qui n'atteignent jamais le numéro +66

Quand une activation reste vide, parcourez cette liste :

• Laissez-lui toute la fenêtre avant d'annuler ; les renvois différés sont fréquents.
• Confirmez que le service accepte les numéros virtuels pour la Thaïlande. Certains ne le font pas, et c'est ce que couvre le remboursement automatique.
• Réessayez plus tard, ou passez à une autre route pays si votre cas de test le permet. L'article sur le routage par pays explique comment les équipes choisissent leurs solutions de repli.
• Espacez les nouvelles tentatives. Recommander en boucle serrée aide rarement et encombre vos journaux.

Une tentative qui échoue ne coûte rien : une activation expirée ou annulée remet le montant total dans le portefeuille.

Lignes longue durée, portefeuille et sandbox pour les projets thaïlandais

OTP Route ne vend pas de numéro longue durée en libre-service en Thaïlande. Les équipes qui ont besoin d'une ligne thaïlandaise persistante peuvent écrire à [email protected] pour se renseigner ; la réglementation locale décide de ce qui est possible. Les numéros dédiés que vous conservez et renouvelez ne sont disponibles qu'aux États-Unis et au Canada, à partir de $1.95/month.

Tout le reste fonctionne avec un portefeuille USD prépayé, sans abonnement. Rechargez par carte ou en USDT/USDC, et une facture PDF est envoyée par e-mail pour chaque recharge. Pour le travail d'intégration, un compte de développement peut passer en sandbox afin que des numéros et des codes simulés traversent votre code sans frais. Consultez la tarification pour les tarifs en vigueur, respectez les conditions de chaque service, et rappelez-vous que la politique d'utilisation acceptable d'OTP Route couvre chaque activation.

Questions fréquentes

Puis-je vérifier l'inscription thaïlandaise de mon application sans carte SIM thaïlandaise ?

Oui. Commandez un numéro +66 depuis l'OTP Gateway, saisissez-le dans votre application et lisez le code dans le tableau de bord ou via l'API et les webhooks.

Dois-je garder le 0 initial en stockant un mobile thaïlandais ?

Non. Supprimez le 0 de ligne et stockez le numéro sous la forme +66 suivi des neuf chiffres restants.

Quel identifiant l'API attend-elle pour la Thaïlande ?

Utilisez th comme valeur de pays, par exemple dans GET /api/v1/prices?country=th&service=<id>.

Pourquoi le message de LINE ou de Shopee arrive-t-il en thaï ?

Beaucoup de services localisent leur modèle de SMS selon le pays du numéro ou la langue du compte ; analysez donc les chiffres plutôt que des mots-clés anglais.

Combien coûte une activation thaïlandaise qui échoue ?

Rien. Si la fenêtre de 20 minutes se termine sans SMS, ou si vous annulez, le montant total retourne automatiquement sur votre portefeuille.

Existe-t-il un moyen d'exécuter des tests OTP thaïlandais en CI sans dépenser d'argent ?

Oui, demandez le mode sandbox pour un compte de développement. Il renvoie des numéros et des codes simulés afin de tester le pipeline de bout en bout, comme l'explique la page de la solution CI/CD.

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.