Vérification SMS en Tunisie (+216) : une liste de contrôle pour les développeurs

Que mettre sur la liste de contrôle avant de commander un numéro +216 ?

Parcourez cette liste une fois et la plupart des tests pour la Tunisie se dérouleront sans accroc :

• Clé d'API prête. Créez une clé Bearer dans la console développeur ; les clés live commencent par or_live_.
• Portefeuille approvisionné. L'OTP Gateway puise dans votre solde USD prépayé ; GET /api/v1/balance le confirme depuis un script.
• Webhook joignable. Enregistrez un point de terminaison HTTPS, conservez son secret et vérifiez que l'horloge de votre serveur est exacte pour que les contrôles d'horodatage passent.
• Prix vérifié. Appelez GET /api/v1/prices?country=tn&service=<id> pour le service précis que vous comptez tester.
• Champ de téléphone testé. Assurez-vous que votre propre formulaire accepte un numéro national tunisien à huit chiffres comme un numéro international +216 collé.
• Analyseur tolérant. Confirmez que l'extraction du code fonctionne pour des messages en arabe, en français et en anglais (voir plus bas).
• Conditions relues. Vous testez votre propre produit ou exploitez votre propre compte légitime, dans le respect des règles du service et de la politique d'utilisation acceptable d'OTP Route.

Comment les numéros tunisiens sont-ils formatés en E.164 ?

La Tunisie utilise un plan de numérotation fermé : chaque numéro d'abonné compte huit chiffres et il n'y a aucun préfixe de ligne, donc rien à retirer avant d'ajouter l'indicatif pays. La forme E.164 est simplement +216 suivi de ces huit chiffres. Les habitants écrivent souvent les numéros en groupes comme xx xxx xxx : supprimez donc espaces, points et tirets lors de la normalisation. Évitez de valider selon une liste fixe de premiers chiffres ; le contrôle de longueur associé à une bibliothèque de numéros reconnue est plus sûr qu'une table de plages écrite à la main.

Dans quelles langues les SMS de vérification tunisiens arrivent-ils ?

L'arabe est la langue officielle, l'arabe tunisien est ce que l'on parle au quotidien, et le français est courant dans les affaires, l'administration et de nombreuses applications. Une même exécution de test peut donc recevoir des codes en français, en anglais ou en arabe selon l'expéditeur et les paramètres régionaux de l'appareil.

Les messages en arabe voyagent en SMS Unicode et peuvent contenir des marques de direction de droite à gauche autour des chiffres. Une expression régulière qui capte la première suite de quatre à huit chiffres ASCII, après suppression des marques invisibles, résiste aux trois langues. Les équipes ajoutent généralement la Tunisie à leur matrice pour des lancements en Afrique du Nord francophone aux côtés du Maroc et de l'Algérie, pour la QA de localisation des interfaces de droite à gauche, ou parce qu'elles servent des clients tunisiens vivant en Europe ; un numéro +216 pour les tests couvre chacun de ces cas.

Pas à pas : recevoir un OTP tunisien via l'API

L'état en direct recense plus de 1 700 services pour la Tunisie, dont Facebook, WhatsApp, Instagram, Telegram, TikTok, Google (Gmail & YouTube), Snapchat, Signal, LinkedIn, Discord, ChatGPT (OpenAI), Microsoft & Outlook, Amazon et Uber. La disponibilité évolue au fil de la journée ; laissez donc votre logique de routage d'OTP la lire depuis GET /api/v1/services et GET /api/v1/countries au début de chaque exécution.

1. Envoyez POST /api/v1/activations avec {"service": "facebook", "country": "tn"} et conservez l'identifiant d'activation.
2. Saisissez le numéro renvoyé dans l'application testée et déclenchez l'envoi du code.
3. Traitez activation.sms_received sur votre webhook : vérifiez X-OTPRoute-Signature (HMAC-SHA256 de l'horodatage, d'un point et du corps brut), rejetez les horodatages anciens et ignorez les doublons pour un identifiant d'activation déjà traité.
4. Sans webhook, interrogez GET /api/v1/activations/{id} en restant bien en dessous de la limite de 300 requêtes par minute.
5. Appelez POST /api/v1/activations/{id}/cancel si le test est interrompu.

La documentation de l'API liste tous les champs, et le guide des tests en CI montre comment l'intégrer à un pipeline.

Pas à pas depuis le tableau de bord

1. Créez un compte avec votre e-mail et un code à six chiffres, ou avec la connexion Google, et activez l'authentification à deux facteurs TOTP.
2. Ajoutez des fonds par carte ou en USDT/USDC.
3. Choisissez la Tunisie, puis le service, et vérifiez le prix affiché.
4. Commandez, copiez le numéro +216 et demandez le code dans l'application cible.
5. Copiez le code tunisien depuis le tableau de bord dès qu'il apparaît et terminez l'inscription que vous testez.

Dépannage : et si le code +216 n'arrive jamais ?

Chaque activation dure 20 minutes, et vous ne payez que lorsqu'un code arrive. Si la fenêtre se termine ou si vous annulez, la totalité du montant retourne sur le portefeuille.

• Rien n'est arrivé du tout : laissez la fenêtre expirer, puis réessayez plus tard ou avec une autre route de service si le test le permet.
• Le service a refusé le numéro : certains services rejettent les numéros virtuels ; le remboursement couvre ce cas.
• Webhook muet mais le tableau de bord montre le code : votre contrôle de signature échoue probablement ; comparez avec le corps brut, non avec un JSON resérialisé, et vérifiez la dérive d'horloge.
• Plusieurs échecs d'affilée : ajoutez un back-off ; recommander en boucle serrée aide rarement.

Lignes longue durée, facturation et sandbox pour la Tunisie

Il n'existe pas de numéro tunisien longue durée en libre-service. Les Dedicated Numbers sont un produit américain et canadien dès $1.95/month ; si vous avez besoin d'une ligne +216 durable, écrivez à [email protected], en gardant à l'esprit que la disponibilité dépend de la réglementation locale.

Le portefeuille fonctionne à l'usage, sans abonnement mensuel, et chaque recharge donne lieu à une facture PDF par e-mail. Les comptes de développement peuvent demander le mode sandbox, où des numéros et des codes simulés permettent de valider l'intégration sans dépenser de solde.

Questions fréquentes

Puis-je tester un parcours d'inscription tunisien sans carte SIM tunisienne ?

Oui. Utilisez un numéro +216 de l'OTP Gateway et récupérez le code dans le tableau de bord ou via l'API de vérification par SMS et les webhooks.

Les numéros tunisiens ont-ils un préfixe de ligne à retirer ?

Non. Les numéros tunisiens comptent huit chiffres sans préfixe de ligne : la forme E.164 est donc simplement +216 plus ces chiffres.

Quel est l'identifiant de pays de l'API OTP pour la Tunisie ?

Utilisez tn dans la requête de prix et dans le corps de POST /api/v1/activations.

Combien coûte un numéro de vérification tunisien ?

Dès $0.20 par code ; le montant exact dépend du service et apparaît dans le tableau de bord et le point de terminaison des prix avant la commande. Voir les tarifs.

Mon analyseur échoue sur les messages OTP en arabe. Que dois-je changer ?

Supprimez les marques de direction Unicode et recherchez la suite de chiffres plutôt que les mots qui l'entourent, afin que la même règle fonctionne pour des corps de message en arabe, en français et en anglais.

Puis-je garder un numéro +216 pour des connexions ultérieures ?

Pas en libre-service. Un numéro Gateway couvre un seul code, et les lignes longue durée disponibles instantanément n'existent qu'aux États-Unis et au Canada.

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.