Bob SMS pilote ton propre compte TextVerified : les numéros sont achetés avec tes crédits, sur ton compte, et rien ne passe par le compte de quelqu’un d’autre. Compte 2 minutes pour la clé API, 2 de plus pour les webhooks (le code en direct).
1Compte et crédits TextVerified
Crée ou ouvre ton compte sur textverified.com ↗ et charge du crédit (la plupart des vérifications coûtent moins d’un dollar, une location de 30 jours quelques dollars). Bob SMS ne vend rien : il dépense les crédits de ton compte, sur tes ordres.
2Créer la clé API
Connecté chez TextVerified, ouvre API Settings ↗ (menu API).
Génère ou copie ta clé API principale (primary API key). Elle sert à obtenir des jetons courts : Bob SMS ne la montre jamais et la garde chiffrée.
Note aussi ton identifiant : c’est l’e-mail avec lequel tu t’es inscrit chez TextVerified.
Si tu as plusieurs comptes TextVerified, répète l’opération pour chacun : Bob SMS les affiche côte à côte avec leur solde.
3La coller dans Bob SMS
Dans le tableau de bord, onglet Comptes TextVerified → Connecter un compte : colle l’e-mail et la clé. Bob SMS demande aussitôt un jeton à TextVerified pour vérifier qu’ils sont bons, lit le solde, puis chiffre la clé sur le serveur (AES-256-GCM, clé maître hors base).
4Webhooks : le code en direct (recommandé)
Sans webhook, Bob SMS relit les SMS toutes les quelques secondes : ça marche. Avec, TextVerified prévient Bob SMS à la seconde où le SMS arrive, et le code s’affiche sans recharger.
Dans Bob SMS, fiche du compte → Webhooks : copie l’adresse de webhook du compte (unique, de la forme https://sms-validator.bob-yt.com/hooks/…).
Chez TextVerified, ouvre API → Webhooks ↗ : colle cette adresse, abonne-toi au moins à v2.sms.received (et aux autres événements si tu veux : réservations, commandes en attente, cycles).
TextVerified affiche un secret de signature (whsec_…) : colle-le dans Bob SMS, même fiche → Secret de webhook. Sans lui, Bob SMS refuse les webhooks du compte (tout est vérifié en HMAC-SHA512).
Tu peux régénérer l’adresse de webhook à tout moment (l’ancienne ne reçoit plus rien) ; pense alors à la recoller chez TextVerified.
5Premier numéro
Onglet Nouveau numéro : cherche le service (par exemple telegram), garde SMS, regarde le prix et le stock.
Demander un numéro : le numéro s’affiche. Colle-le dans l’application à vérifier.
Le code apparaît dès que le SMS arrive. Pas de SMS dans le délai : Bob SMS annule la vérification pour récupérer les crédits quand TextVerified l’accepte (réglable : signaler, ou garder).
Pour essayer sans dépenser : le service test_success renvoie un faux numéro et le code 123456, test_delayed_success le même au bout de 30 s, test_timeout rien du tout. Aucun crédit n’est débité.
6Avec Claude ou Codex
Onglet Connecteur MCP : ajoute https://sms-validator.bob-yt.com/mcp dans Claude (connecteur personnalisé, connexion OAuth) ou avec une clé API pour Codex et Claude Code. Ensuite : « donne-moi un numéro pour Discord et attends le code », « loue un numéro 30 jours pour WhatsApp », « quels SMS sont arrivés sur le +1 415… ? », « rembourse la location de lundi ».
Les outils qui dépensent des crédits ne s’exécutent que sur ta demande explicite ; une clé « lecture seule » ne peut rien acheter du tout.
Dépannage
« TextVerified refuse cet identifiant ou cette clé API »
L’identifiant est l’e-mail d’inscription TextVerified (pas un pseudo), et la clé est la clé principale de la page API Settings. Si tu l’as régénérée, recolle la nouvelle.
Un compte passe « à reconnecter »
TextVerified a refusé la clé (révoquée ou régénérée). Reconnecte le compte avec la nouvelle clé : l’historique reste.
« Solde insuffisant »
Recharge le compte chez TextVerified. Le solde affiché dans Bob SMS se rafraîchit au clic.
« Aucun numéro disponible »
Plus de stock pour cette combinaison (service, SMS/vocal, type, indicatif). Enlève l’indicatif, change le type de numéro ou réessaie plus tard ; le stock se consulte avant d’acheter.
Le code n’arrive pas
Certains services bloquent les numéros virtuels : signale la vérification (crédits récupérés selon les règles TextVerified) et réessaie avec un autre type de numéro. Vérifie aussi que le webhook est bien configuré, sinon Bob SMS relit les SMS toutes les quelques secondes.
Les webhooks ne passent pas
Fiche du compte → Webhooks : le compteur de webhooks reçus doit bouger. Vérifie l’adresse collée chez TextVerified, l’abonnement à v2.sms.received et le secret whsec_. Le journal (onglet Compte) montre les webhooks refusés et pourquoi.
« TextVerified limite le débit »
Leur API renvoie 429 quand on l’appelle trop vite. Bob SMS réessaie tout seul avec une pause ; les listes de services et les prix sont gardés en cache.