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; investigue o registro dele se você já o possui |
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 altera alguma coisa?
Sim. Ele envia o candidato para WhatsApp. A Meta pode criar uma entrada temporária na conta comercial de Bird.
Ele não conecta o número ao seu espaço de trabalho nem o reserva para compra. Verifique o candidato que você pretende comprar, pois varrer uma lista pode deixar entradas temporárias para números não utilizados.
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.
E se eu já possuo o número?
Use o resultado para investigar a prontidão de conexão em vez de tomar uma decisão de compra.
A configuração de número próprio do Bird não consegue conectar um número enquanto o registro do aplicativo de consumidor ou WhatsApp Business permanecer ativo. Resolva esse registro com o proprietário da conta antes de tentar a conexão.
Um número que passa ainda precisa completar o fluxo de conexão. Confirme que o status dele atinge 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.
Trate o precheck como uma escrita.
Ele envia o número para WhatsApp e pode criar uma entrada temporária. Ele não reserva nem conecta o número.
Reutilize chaves de tentativa para 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.