Acheminer les codes de vérification de la République du Congo (+242) vers votre pile de test

Quels appels d'API permettent de récupérer un code +242 du début à la fin ?

Tout se trouve sous https://otproute.com/api/v1 et s'authentifie avec une clé Bearer commençant par or_live_. Générez les clés dans la console développeur ; un compte peut en détenir 10, ce qui permet de donner au staging, à la CI et à l'ordinateur d'un collègue des identifiants distincts, révocables indépendamment.

Un déroulé typique de test sur le marché de Brazzaville :

1. Récupérez GET /api/v1/services et GET /api/v1/countries et mettez les identifiants en cache. La République du Congo est cg (à ne pas confondre avec son grand voisin, qui a son propre identifiant et sa page Congo (RDC)).
2. Demandez à GET /api/v1/prices?country=cg&service=<id> le prix en direct et la disponibilité de l'application que vous testez.
3. Créez l'activation avec POST /api/v1/activations et un corps tel que {"service": "telegram", "country": "cg"}. Vous recevez un identifiant d'activation et un numéro +242.
4. Saisissez ce numéro dans l'écran d'inscription ou de connexion de votre propre produit.
5. Récupérez le code congolais depuis une livraison de webhook ou en interrogeant GET /api/v1/activations/{id}. Si le test est interrompu, libérez-le avec POST /api/v1/activations/{id}/cancel.

Exécutez GET /api/v1/balance avant le début d'une suite pour qu'un portefeuille vide fasse échouer le job d'emblée plutôt qu'à mi-parcours. La limite de 300 requêtes par minute laisse largement de la marge à quelques workers parallèles. Les formes complètes des requêtes et réponses se trouvent dans la documentation développeur.

Comment brancher un webhook signé pour les activations congolaises ?

Le polling convient à un ingénieur qui parcourt un flux à la main ; un webhook est bien plus adapté à une flotte CI. Ajoutez un point de terminaison dans la console développeur (cinq sont autorisés par compte) et abonnez-vous à activation.sms_received, activation.expired et activation.cancelled.

Chaque requête porte X-OTPRoute-Signature: t=<unix>,v1=<hex>. Reconstruisez le HMAC-SHA256 de "<t>.<raw body>" avec le secret de ce point de terminaison, comparez-le à v1 par une vérification en temps constant, et écartez tout ce dont l'horodatage est périmé. Calculez le hachage sur les octets bruts avant tout parsing JSON, car un JSON resérialisé correspond rarement octet pour octet.

Considérez les événements comme indexés sur l'identifiant d'activation. Si le même événement arrive deux fois, votre gestionnaire doit constater que l'identifiant est déjà traité et simplement renvoyer un statut de succès. Le guide de capture par webhook présente des schémas de file d'attente qui évitent aux exécuteurs de tests lents de dépasser leur délai.

Quels services un numéro de vérification congolais peut-il couvrir ?

L'instantané du jour pour cg comprend WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, LinkedIn, Signal, Viber et imo. Au total, le pays compte plus de 1 000 services sur l'OTP Gateway.

Cette liste bouge au fil de la journée à mesure que des routes s'ouvrent et se ferment : ne l'inscrivez jamais en dur. Laissez votre banc de test interroger le point de terminaison des prix pour le service précis dont il a besoin, et ignorez ou reprogrammez proprement le test quand la disponibilité est vide. Les messageries dominent généralement l'offre congolaise, ce qui correspond à la façon dont de nombreux clients découvrent un nouveau produit sur place : par un lien partagé dans un groupe de discussion plutôt que par une recherche dans une boutique d'applications.

Comment stocker et normaliser les numéros +242 ?

Les numéros de la République du Congo comptent neuf chiffres après l'indicatif du pays, et contrairement à de nombreux plans de numérotation, le 0 initial fait partie du numéro d'abonné et non d'un préfixe interurbain. Les lignes mobiles s'écrivent couramment 06… ou 05… en local et +242 06… en international. Un normaliseur copié d'une base de code européenne qui retire tout zéro initial les corrompra silencieusement : enregistrez donc exactement la chaîne E.164 renvoyée par l'API et validez la longueur pays par pays plutôt qu'avec une règle globale unique.

Le français est la langue officielle et celle des SMS de vérification le plus souvent, même si le lingala et le kituba sont très parlés au quotidien. Attendez-vous à des caractères accentués dans certains modèles et assurez-vous que votre parseur extrait les chiffres par un motif plutôt qu'en s'appuyant sur une formulation anglaise fixe.

Les équipes testent ici lorsqu'elles déploient un produit en Afrique centrale francophone, assistent le personnel d'exploitation à Brazzaville ou Pointe-Noire, ou servent des clients congolais à l'étranger qui s'inscrivent encore avec un numéro du pays. Contrôler tout le flux sur une vraie route +242 révèle des problèmes de format et de texte qu'un simulateur laisserait passer.

Et si aucun code n'atteint le numéro +242 ?

Le silence relève le plus souvent d'un problème de route ou d'acceptation, pas d'un bug d'intégration. Une marche à suivre raisonnable :

• Laissez la fenêtre de 20 minutes aller à son terme avant de conclure quoi que ce soit ; certains expéditeurs regroupent leur trafic sortant.
• Confirmez que le service cible accepte les numéros virtuels. Plusieurs ne le font pas, ce qui est précisément la raison pour laquelle un code non reçu ne coûte rien.
• Réessayez plus tard, ou passez à une autre route de service, plutôt que de lancer de nouvelles commandes en boucle serrée qui épuisent la limite de débit.
• Annulez les numéros dont vous n'avez plus besoin pour que les fonds reviennent immédiatement au lieu d'attendre l'expiration.

Notre article sur la réduction des échecs de livraison OTP traite plus en profondeur du backoff et des budgets de nouvelles tentatives.

Puis-je conserver une ligne congolaise longue durée ?

Il n'existe pas de numéro longue durée en libre-service pour la République du Congo. L'OTP Gateway délivre un numéro par code de vérification, et c'est le seul produit proposé pour cg actuellement.

Les Dedicated Virtual Numbers d'OTP Route sont un produit États-Unis et Canada à partir de $1.95/month, avec SMS entrants et sortants ainsi qu'appels depuis le navigateur. Si votre équipe a vraiment besoin d'une ligne congolaise persistante, écrivez à [email protected] ; ce qui peut être arrangé dépend de la réglementation locale, considérez donc cela comme une question et non une promesse. Les compromis sont résumés dans numéros temporaires ou dédiés.

Comment un montage de routage OTP Congo est-il facturé et testé en toute sécurité ?

La facturation repose sur un seul portefeuille prépayé en USD, sans abonnement ni palier. Rechargez par carte ou en stablecoins USDT/USDC ; chaque recharge produit une facture PDF envoyée par e-mail à votre service financier.

Avant d'engager de l'argent réel dans un pipeline, demandez au support de basculer un compte de développement en mode sandbox. Il renvoie des numéros et des codes simulés, ce qui vous permet d'exercer tout le chemin de l'API de vérification SMS de bout en bout sans rien dépenser. N'utilisez OTP Route que sur vos propres produits et les comptes que vous avez le droit d'exploiter ; les conditions de chaque service et notre politique d'utilisation acceptable restent applicables. Consultez les tarifs pour voir comment débits et remboursements apparaissent dans le portefeuille.

Questions fréquentes

Quel est l'identifiant de pays de la République du Congo dans l'API OTP Route ?

C'est cg. La République démocratique du Congo est un pays distinct avec son propre identifiant : vérifiez donc bien lequel figure dans votre configuration.

Puis-je tester le parcours d'inscription congolais de mon application sans SIM locale ?

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

Dois-je retirer le zéro initial en enregistrant un numéro +242 ?

Non. En République du Congo, le 0 appartient au numéro d'abonné à neuf chiffres : conservez donc la valeur E.164 exactement telle que l'API la renvoie.

Dans quelle langue seront les SMS de vérification congolais ?

La plupart arrivent en français, parfois en anglais pour les applications internationales. Extrayez les chiffres avec un motif au lieu de chercher des mots précis.

Suis-je facturé si le code n'apparaît jamais ?

Non. Si la fenêtre se ferme sans SMS, ou si vous annulez avant, la totalité du montant retourne automatiquement sur votre portefeuille.

Combien coûte la réception d'un SMS OTP du Congo ?

À partir de $0.20 par code ; le prix +242 de chaque application est indiqué en direct, interrogez-le donc avant de commander.

Existe-t-il un sandbox pour construire l'intégration ?

Oui, sur demande. Le support peut passer un compte de développement en mode sandbox, qui renvoie des numéros et des codes simulés sans toucher aux fonds du 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.