Un operatore può mettere in vendita un numero anche quando WhatsApp non lo accetterà. Controllare il candidato prima dell'ordine evita di pagare un numero che non puoi collegare tramite il flusso di configurazione previsto.
Come eseguo il precheck del numero di Bird?
Usa bird whatsapp numbers precheck con il numero candidato prima di acquistarlo.
bird whatsapp numbers precheck +31612345678Fornisci il numero in formato internazionale con + iniziale e prefisso nazionale. La richiesta API lo trasporta in phone_number. Non è necessario possederlo già.
L'endpoint è POST /v1/whatsapp/numbers/precheck. Usa una sessione CLI autenticata o un grant MCP con whatsapp_management:write, come richiesto dal riferimento al comando.
| Flag | Cosa permette di ispezionare |
|---|---|
--example | Il corpo della richiesta senza credenziali |
--dry-run | La richiesta risolta senza inviarla |
--response-schema | I campi della risposta |
Un client MCP richiama la stessa operazione tramite whatsapp_numbers_precheck.
Cosa significano available e unavailable?
available indica che il controllo non ha trovato ostacoli al collegamento del numero in quel momento. unavailable indica che WhatsApp lo ha rifiutato.
| Esito | Cosa fare con un candidato all'acquisto |
|---|---|
available | Prosegui con i controlli di acquisto, sapendo che il risultato non riserva il numero |
unavailable | Scarta quel candidato; verifica la sua registrazione se lo possiedi già |
Un numero unavailable potrebbe essere già registrato su WhatsApp oppure essere un numero che WhatsApp non può servire. Il risultato non distingue queste ragioni, quindi non dedurne una dal solo esito.
Un errore di richiesta è diverso da un risultato unavailable. Gestisci l'errore API restituito prima di considerare il candidato inadatto.
Il controllo modifica qualcosa?
Sì. Invia il candidato a WhatsApp. Meta può creare una voce temporanea nell'account business di Bird.
Non collega il numero al tuo spazio di lavoro né lo riserva per l'acquisto. Controlla il candidato che intendi acquistare, perché scorrere un elenco può lasciare voci temporanee per numeri inutilizzati.
Riutilizza un Idempotency-Key quando riprovi lo stesso controllo. Durante la finestra di risposta di tre ore di Bird, la stessa chiave restituisce la risposta memorizzata invece di interrogare nuovamente WhatsApp.
L'header di risposta Idempotency-Replay identifica quel replay. Terminata la finestra di risposta, la stessa chiave può avviare un nuovo controllo.
In quale punto del processo di acquisto si colloca il controllo?
Verifica la disponibilità presso l'operatore e l'accettazione da parte di WhatsApp prima di effettuare l'ordine del numero.
- Cerca con
bird numbers available list --country-code US. - Ricontrolla il candidato selezionato con
bird numbers available get. - Esegui il precheck WhatsApp su quel candidato.
- Ordina solo dopo
available, usandobird numbers orders create.
Un 404 dal ricontrollo di disponibilità dell'operatore indica che serve un altro candidato. Completa l'eventuale verifica dell'organizzazione nella dashboard prima di ordinare.
Un ordine pending necessita comunque che l'operatore completi il provisioning. Attendi che l'ordine si concluda prima di fare affidamento sul numero.
E se possiedo già il numero?
Usa l'esito per verificare la prontezza al collegamento, non per prendere una decisione di acquisto.
La configurazione del proprio numero di Bird non può connettere un numero finché la sua registrazione consumer o nell'app WhatsApp Business è attiva. Risolvi quella registrazione con il titolare dell'account prima di tentare la connessione.
Un numero che supera il controllo deve comunque completare il flusso di collegamento. Conferma che il suo stato raggiunga Connected prima di usarlo come mittente del tuo brand.
I mittenti gestiti da Bird sono un'opzione separata per i template gestiti di autenticazione e utilità. Non inviano i tuoi contenuti in formato libero né ricevono le risposte dei clienti nel tuo spazio di lavoro.
In breve
Controlla prima di acquistare.
Una ricerca di numeri non stabilisce la compatibilità con WhatsApp. Esegui il precheck sul candidato che intendi acquistare.
Interpreta unavailable senza inventare una causa.
Il numero potrebbe essere già registrato oppure non supportato. Il risultato non distingue i due casi.
Tratta il precheck come una scrittura.
Invia il numero a WhatsApp e può creare una voce temporanea. Non riserva né collega il numero.
Riutilizza le chiavi di ripetizione per lo stesso controllo.
Un replay di idempotenza restituisce la risposta memorizzata. Quella risposta descrive il controllo precedente, non una garanzia aggiornata di disponibilità.