Un opérateur peut proposer un numéro à la vente même si WhatsApp ne l'acceptera pas. Vérifier ce candidat avant de commander évite de payer pour un numéro impossible à connecter via le flux de configuration prévu.
Comment exécuter la prévérification de numéro de Bird ?
Utilisez bird whatsapp numbers precheck avec le numéro candidat avant de l'acheter.
bird whatsapp numbers precheck +31612345678Fournissez le numéro au format international avec un + initial et l'indicatif pays. La requête API le transmet dans phone_number. Vous n'avez pas besoin d'en être déjà propriétaire.
Le point de terminaison est POST /v1/whatsapp/numbers/precheck. Utilisez une session CLI connectée ou un grant MCP avec whatsapp_management:write, comme l'exige la référence de commande.
| Indicateur | Ce qu'il permet d'inspecter |
|---|---|
--example | Le corps de la requête sans identifiants |
--dry-run | La requête résolue sans l'envoyer |
--response-schema | Les champs de la réponse |
Un client MCP appelle la même opération via whatsapp_numbers_precheck.
Que signifient available et unavailable ?
available signifie que la vérification n'a trouvé aucun obstacle à la connexion du numéro à cet instant. unavailable signifie que WhatsApp l'a refusé.
| Résultat | Action à effectuer avec un candidat à l'achat |
|---|---|
available | Poursuivez les vérifications d'achat, sachant que le résultat ne réserve pas le numéro |
unavailable | Écartez ce candidat ; examinez son enregistrement si vous en êtes déjà propriétaire |
Un numéro unavailable est peut-être déjà enregistré sur WhatsApp ou peut être un numéro que WhatsApp ne peut pas prendre en charge. Le résultat ne distingue pas ces raisons : ne déduisez pas l'une d'elles du seul résultat.
Un échec de requête est différent d'un résultat unavailable. Traitez l'erreur API renvoyée avant de considérer le candidat comme inadapté.
La vérification modifie-t-elle quelque chose ?
Oui. Elle envoie le candidat à WhatsApp. Meta peut créer une entrée temporaire sous le compte professionnel de Bird.
Elle ne connecte pas le numéro à votre espace de travail et ne le réserve pas pour achat. Vérifiez le candidat que vous comptez acheter, car un balayage de liste peut laisser des entrées temporaires pour des numéros inutilisés.
Réutilisez un Idempotency-Key lorsque vous réessayez la même vérification. Pendant la fenêtre de réponse de trois heures de Bird, la même clé renvoie la réponse stockée au lieu d'interroger WhatsApp à nouveau.
L'en-tête de réponse Idempotency-Replay identifie ce rejeu. Une fois la fenêtre de réponse expirée, la même clé peut déclencher une nouvelle vérification.
Où la vérification s'insère-t-elle dans l'achat d'un numéro ?
Vérifiez la disponibilité opérateur et l'acceptation WhatsApp avant de passer la commande du numéro.
- Recherchez avec
bird numbers available list --country-code US. - Revérifiez le candidat sélectionné avec
bird numbers available get. - Exécutez la prévérification WhatsApp sur ce candidat.
- Commandez uniquement après
available, en utilisantbird numbers orders create.
Un 404 lors de la revérification de disponibilité opérateur signifie que vous avez besoin d'un autre candidat. Effectuez toute vérification d'organisation requise dans le tableau de bord avant de commander.
Une commande pending nécessite encore que l'opérateur finalise le provisionnement. Attendez que la commande soit réglée avant de compter sur le numéro.
Et si je possède déjà le numéro ?
Utilisez le résultat pour examiner l'état de connexion plutôt que pour prendre une décision d'achat.
La configuration de numéro propre de Bird ne peut pas connecter un numéro tant que son inscription à l'application grand public ou WhatsApp Business reste active. Résolvez cette inscription avec le propriétaire du compte avant de tenter la connexion.
Un numéro qui passe la vérification doit encore compléter le flux de connexion. Confirmez que son statut atteint Connected avant de l'utiliser comme expéditeur de marque.
Les expéditeurs gérés par Bird sont une option distincte pour les modèles d'authentification et utilitaires gérés. Ils n'envoient pas votre contenu libre et ne reçoivent pas les réponses des clients dans votre espace de travail.
En bref
Vérifiez avant d'acheter.
Une recherche de numéro n'établit pas la compatibilité avec WhatsApp. Exécutez la prévérification sur le candidat que vous comptez acheter.
Interprétez unavailable sans inventer de raison.
Le numéro est peut-être déjà enregistré ou non pris en charge. Le résultat ne distingue pas ces cas.
Traitez la prévérification comme une écriture.
Elle envoie le numéro à WhatsApp et peut créer une entrée temporaire. Elle ne réserve ni ne connecte le numéro.
Réutilisez les clés de réessai pour la même vérification.
Un rejeu d'idempotence renvoie la réponse stockée. Cette réponse décrit la vérification précédente, pas une garantie de disponibilité actualisée.