Recevoir des codes SMS Truecaller par programmation

À quoi ressemble la chaîne d'appels d'API pour Truecaller ?

L'identifiant de service de Truecaller est truecaller, et chacun des appels ci-dessous est effectué sur https://otproute.com/api/v1 avec une clé Bearer dont le préfixe est or_live_.

1. GET /api/v1/countries fournit les identifiants de pays ; mettez-les en cache.
2. GET /api/v1/prices?country=<id>&service=truecaller renvoie le prix en direct et indique si une route est ouverte à cet instant.
3. POST /api/v1/activations avec {"service": "truecaller", "country": "in"} (ou tout autre identifiant de pays) réserve le numéro et renvoie un identifiant d'activation.
4. Saisissez ce numéro dans l'application Truecaller sur votre appareil de test et demandez la vérification.
5. Le code arrive sous forme d'événement webhook activation.sms_received, ou vous interrogez GET /api/v1/activations/{id}.
6. Si le test est abandonné, POST /api/v1/activations/{id}/cancel le rembourse aussitôt.

Un compte accepte 10 clés d'API, 5 endpoints de webhook et 300 requêtes par minute. Le guide d'intégration de l'API couvre les nouvelles tentatives et les délais d'attente.

Comment le gestionnaire de webhook doit-il traiter les événements Truecaller ?

Chaque livraison porte X-OTPRoute-Signature: t=<unix>,v1=<hex>. Recalculez le HMAC-SHA256 de l'horodatage, d'un point et du corps brut de la requête avec le secret de votre endpoint, comparez en temps constant et rejetez les horodatages trop anciens.

Appuyez tout le traitement sur l'identifiant d'activation. Les webhooks peuvent être renvoyés : un gestionnaire qui enregistre le code deux fois ou fait avancer un test deux fois produira des résultats instables ; vérifiez si l'activation est déjà marquée comme terminée avant d'agir. Traitez activation.expired et activation.cancelled comme des états terminaux qui disent à votre exécuteur de tests d'arrêter d'attendre. L'interrogation périodique sert de solution de repli en développement local, lorsqu'aucun endpoint public n'existe.

Pourquoi Truecaller demande-t-il un numéro de téléphone ?

Truecaller est une application d'identification d'appelant et de blocage du spam, et le numéro de téléphone est le compte. L'inscription confirme que l'utilisateur contrôle le numéro avant la création du profil, et la vérification se répète lorsque l'application est réinstallée ou déplacée vers un nouvel appareil. Sur certains appareils, l'application peut essayer de vérifier par appel plutôt que par SMS. Un numéro OTP Gateway ne capte que les SMS : une vérification par appel ne produira donc aucun code sur l'activation ; la fenêtre s'écoule simplement et le portefeuille est remboursé.

Parmi les raisons légitimes de vérifier des comptes Truecaller : contrôler comment les numéros de support sortants ou de livraison d'une entreprise sont étiquetés pour les gens d'un marché donné, tester des applications qui intègrent l'identification d'appelant, et permettre au personnel d'exploitation d'avoir un profil professionnel distinct de son téléphone personnel.

Quels pays disposent de routes Truecaller ?

L'instantané en direct liste des routes Truecaller dans 198 pays, dont l'Inde, le Pakistan, le Bangladesh, le Nigeria, le Kenya, l'Égypte, l'Indonésie, le Sri Lanka, le Népal, l'Arabie saoudite, les Émirats arabes unis, le Brésil, le Mexique, l'Afrique du Sud, le Royaume-Uni et les États-Unis.

Choisissez le pays en fonction du cas de test. Les étiquettes d'appelant, les signalements de spam et la langue de l'application suivent le marché : pour vérifier comment votre ligne de support de Lagos s'affiche, utilisez une route nigériane, pas la moins chère du moment. La disponibilité change au fil de la journée ; interrogez le endpoint des prix avant chaque exécution.

Les non-développeurs peuvent-ils le faire depuis le tableau de bord ?

Oui. Connectez-vous, ouvrez l'OTP Gateway, choisissez Truecaller et un pays, confirmez le prix affiché, et le numéro apparaît sur une carte d'activation. Saisissez-le dans Truecaller, demandez le code, et il s'affiche sur la même carte à l'arrivée du SMS. La fenêtre de 20 minutes est visible sur la carte. Si aucun code n'arrive, ou si vous annulez, le montant total retourne automatiquement dans votre portefeuille. Les recharges se font par carte ou en USDT/USDC, avec une facture PDF par e-mail pour chacune ; voir les tarifs.

Pourquoi un code Truecaller peut-il ne pas arriver ?

Causes courantes :

• Truecaller a refusé le numéro parce qu'il le considère comme virtuel. Certains services le font ; c'est pourquoi vous êtes remboursé.
• L'application a choisi une vérification par appel plutôt que par SMS.
• La route a été brièvement congestionnée. Réessayez plus tard ou avec un autre pays qui convient à votre test.
• Le numéro a été saisi sans son indicatif pays, ou avec un 0 de préfixe national en trop.

Ne martelez pas le endpoint de commande en boucle. Espacez les tentatives et consignez chaque identifiant d'activation pour repérer des tendances.

Quand un numéro dédié est-il plus pertinent pour Truecaller ?

Un numéro à usage unique disparaît après l'activation. Si un profil Truecaller doit être revérifié plus tard, par exemple l'appareil professionnel d'une équipe de support qui est réinitialisé, utilisez plutôt un numéro dédié. Ceux-ci sont disponibles instantanément aux États-Unis et au Canada à partir de $1.95/mois, reçoivent les SMS dans le tableau de bord et via le webhook number.sms_received, et se renouvellent depuis le portefeuille jusqu'à ce que vous les libériez. Consultez les numéros virtuels.

N'utilisez OTP Route que pour vos propres comptes et produits légitimes : un compte par personne réelle ou par entreprise, aucun signalement ni changement d'étiquette visant les numéros d'autrui, et un plein respect des conditions de Truecaller et de la politique d'utilisation acceptable d'OTP Route. Truecaller est une marque de son propriétaire, et OTP Route n'y est pas affilié.

Questions fréquentes

Quel est l'identifiant de service de Truecaller dans l'API ?

C'est truecaller. Associez-le à un identifiant de pays dans GET /api/v1/prices et dans le corps de POST /api/v1/activations.

Puis-je recevoir un OTP Truecaller sur un numéro virtuel ?

Souvent, mais pas toujours ; Truecaller peut refuser les numéros qu'il classe comme virtuels. Si aucun code n'arrive en 20 minutes, le montant est remboursé automatiquement.

Pourquoi Truecaller a-t-il appelé au lieu d'envoyer un SMS ?

Sur certains appareils, l'application peut choisir une vérification par appel. Les numéros OTP Gateway ne captent que les SMS : demandez donc l'option SMS si l'application la propose.

Quel pays choisir pour tester la vérification SMS de Truecaller ?

Choisissez le marché sur lequel porte votre test, car les étiquettes d'appelant et la langue suivent le pays du numéro. Vérifiez d'abord la disponibilité en direct avec le endpoint des prix.

Puis-je conserver le même numéro Truecaller pour de futures connexions ?

Oui, avec un numéro dédié aux États-Unis ou au Canada à partir de $1.95/mois. Les numéros Gateway à usage unique ne sont pas réutilisables.

Comment éviter que les livraisons de webhook en double ne perturbent mes tests ?

Rendez le gestionnaire idempotent sur l'identifiant d'activation et vérifiez la signature avant de faire quoi que ce soit du contenu.

OTP Route est-il affilié à Truecaller ?

Non. Truecaller est une marque de son propriétaire ; OTP Route fournit des numéros pour tester et exploiter vos propres comptes légitimes.

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.