Uma operadora pode oferecer um número à venda mesmo quando WhatsApp não o aceitará. Verificar esse candidato antes de fazer o pedido evita pagar por um número que você não consegue conectar pelo fluxo de configuração pretendido.
Como executo o precheck de número de Bird?
Use bird whatsapp numbers precheck com o número candidato antes de comprá-lo.
bird whatsapp numbers precheck +31612345678Forneça o número em formato internacional com + inicial e código de país. A solicitação API o transporta em phone_number. Você não precisa já ser proprietário dele.
O endpoint é POST /v1/whatsapp/numbers/precheck. Use uma CLI autenticada ou uma concessão MCP com whatsapp_management:write, conforme exigido pela referência do comando.
| Flag | O que permite inspecionar |
|---|---|
--example | O corpo da solicitação sem credenciais |
--dry-run | A solicitação resolvida sem enviá-la |
--response-schema | Os campos da resposta |
Um cliente MCP chama a mesma operação por meio de whatsapp_numbers_precheck.
O que significam available e unavailable?
available significa que o check não encontrou obstáculo para conectar o número naquele momento. unavailable significa que WhatsApp o recusou.
| Resultado | O que fazer com um candidato a compra |
|---|---|
available | Continue as verificações de compra, sabendo que o resultado não reserva o número |
unavailable | Descarte esse candidato e escolha outro número |
Um número unavailable pode já estar registrado em WhatsApp ou pode ser um número que WhatsApp não consegue atender. O resultado não distingue esses motivos, portanto não deduza um deles apenas pelo resultado.
Uma falha de solicitação é diferente de um resultado unavailable. Trate o erro API retornado antes de considerar o candidato como inadequado.
O check reserva o número?
Não. Ele não conecta o número ao seu espaço de trabalho nem o reserva para compra. Outra pessoa pode ficar com um número available antes que você faça o pedido.
Verifique o candidato que você pretende comprar, em vez de percorrer uma lista inteira de números.
Reutilize uma Idempotency-Key ao tentar novamente o mesmo check. Durante a janela de resposta de três horas de Bird, a mesma chave retorna a resposta armazenada em vez de consultar WhatsApp novamente.
O cabeçalho de resposta Idempotency-Replay identifica esse replay. Quando a janela de resposta termina, a mesma chave pode disparar um novo check.
Onde o check se encaixa na compra de um número?
Verifique a disponibilidade na operadora e a aceitação de WhatsApp antes de fazer o pedido do número.
- Pesquise com
bird numbers available list --country-code US. - Reconfirme o candidato selecionado com
bird numbers available get. - Execute o precheck WhatsApp nesse candidato.
- Faça o pedido somente após
available, usandobird numbers orders create.
Um 404 na reverificação de disponibilidade da operadora significa que você precisa de outro candidato. Conclua qualquer verificação de organização necessária no painel antes de fazer o pedido.
Um pedido pending ainda precisa que a operadora conclua o provisionamento. Aguarde o pedido ser finalizado antes de depender do número.
Posso verificar um número que já possuo?
Não. O precheck serve para números que você pretende comprar de Bird. Ele não serve para um número que você já possui nem para números de coexistência. Para conectar um número que você já possui, use a configuração de número próprio de Bird.
Essa configuração não consegue conectar um número enquanto o registro pessoal dele no WhatsApp permanecer ativo. Um número no aplicativo WhatsApp Business se conecta por meio da coexistência. Confirme que o status do número chega a Connected antes de usá-lo como seu remetente de marca.
Remetentes gerenciados por Bird são uma opção separada para os modelos gerenciados de autenticação e utilidade. Eles não enviam seu conteúdo de formato livre nem recebem respostas de clientes no seu espaço de trabalho.
Em resumo
Verifique antes de comprar.
Uma busca de números não estabelece compatibilidade com WhatsApp. Execute o precheck no candidato que você pretende comprar.
Interprete unavailable sem inventar um motivo.
O número pode já estar registrado ou pode não ser suportado. O resultado não distingue esses casos.
Não trate a resposta como uma reserva.
O check não reserva nem conecta o número. Faça o pedido enquanto a resposta ainda for recente.
Reutilize as chaves ao tentar novamente o mesmo check.
Um replay de idempotência retorna a resposta armazenada. Essa resposta descreve o check anterior, não uma garantia de disponibilidade atualizada.