Por que a pré-verificação falha e quando tentar novamente
O status do seu número indica Failed e o motivo é verification_code_not_received ou verification_rate_limited. O primeiro significa que Bird não obteve um código de verificação utilizável na tentativa. O segundo significa que WhatsApp limitou as solicitações de verificação. Nenhum dos erros, isoladamente, comprova que você não controla o número.
O que a pré-verificação faz
WhatsApp precisa confirmar que você controla um número antes de poder enviar. Bird solicita um código por chamada de voz automatizada ou SMS e envia o código recebido em seu nome.
Cada método de recebimento tem uma janela de dez minutos para o código. Bird pode tentar o método alternativo quando ele estiver disponível, então o processo completo pode levar mais de dez minutos. Novas tentativas de infraestrutura podem estender ainda mais o tempo decorrido. Acompanhe o status atual do número em vez de tratar dez minutos como um prazo de conclusão.
Verifique a tentativa que falhou
Abra o número em WhatsApp > Numbers e leia o erro antes de tentar novamente.
- Code not received: verifique se o número suporta o método de recebimento e se Bird consegue receber a chamada de verificação ou SMS. Problemas de roteamento ou recepção podem impedir a chegada de um código utilizável.
- Verification rate limited: evite solicitações repetidas. Aguarde o tempo de nova tentativa exibido na página do número; a Meta pode continuar restringindo solicitações após esse período.
Se o número tiver outros erros de conexão, use Phone number setup para investigá-los primeiro.
Tentar novamente
- Aguarde até que Try again fique disponível. Quando o horário da última solicitação de código é registrado, o painel aguarda duas horas a partir dessa solicitação, e não duas horas a partir da falha posterior.
- Selecione Try again na página do número. Bird inicia outra tentativa de verificação. Você não precisa desconectar o número antes.
- Se falhar novamente, guarde o erro e o horário da tentativa e entre em contato com o suporte. Evite solicitar códigos repetidamente enquanto o problema de recepção subjacente ou o limite do provedor não for resolvido.
O botão de nova tentativa ficar disponível não garante que a Meta aceitará a próxima solicitação nem que o código chegará.
Recebimento por voz ou SMS
Bird prefere voz quando uma tentativa de voz não utilizada está disponível e pode usar SMS quando suportado, inclusive quando não consegue preparar a rota de voz. Verifique as capacidades e o caminho de recepção do número antes de começar. A capacidade de voz oferece ao processo outra forma de receber um código; não garante uma taxa de entrega mais alta.
Próximos passos
- Phone number setup: conectar um número e recuperar outras falhas
- Number quality and messaging limit: o que uma conta conectada pode enviar
- WhatsApp business verification: análise separada de identidade comercial da Meta
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.
Assista ao guiaConnecting WhatsApp to Bird: from buying a number to a live channelExplore a funcionalidadeConnect WhatsAppSiga o percurso de aprendizagemBuild your first integration
Experimente na prática e obtenha um resumo de implementação