Documentación
Sign inGet started
Comenzar
Guías
Referencia de API
SDKs
CLI
Base de conocimientos
Registro de cambios

Por qué falla la preverificación y cuándo reintentar

El estado de tu número indica Failed y el motivo es verification_code_not_received o verification_rate_limited. El primero significa que Bird no obtuvo un código de verificación utilizable en el intento. El segundo significa que WhatsApp limitó las solicitudes de verificación. Ninguno de los dos errores por sí solo demuestra que no controlas el número.

Qué hace la preverificación

WhatsApp debe confirmar que controlas un número antes de poder enviar. Bird solicita un código mediante llamada de voz automatizada o SMS y envía el código recibido en tu nombre.
Cada método de recepción tiene una ventana de diez minutos para el código. Bird puede probar el método alternativo cuando está disponible, por lo que el proceso completo puede durar más de diez minutos. Los reintentos de infraestructura pueden extender aún más el tiempo transcurrido. Sigue el estado actual del número en lugar de tratar los diez minutos como un plazo de finalización.

Revisa el intento fallido

Abre el número en WhatsApp > Numbers y lee el error antes de reintentar.
  • Code not received: comprueba que el número admite el método de recepción y que Bird puede recibir la llamada de verificación o el SMS. Problemas de enrutamiento o recepción pueden impedir que llegue un código utilizable.
  • Verification rate limited: evita solicitudes repetidas. Espera el tiempo de reintento que se muestra en la página del número; Meta puede seguir restringiendo solicitudes después de ese tiempo.
Si el número tiene otros errores de conexión, usa Phone number setup para investigarlos primero.

Reintentar

  1. Espera hasta que Try again esté disponible. Cuando se registra la hora de la última solicitud de código, el panel espera dos horas desde esa solicitud, no dos horas desde el fallo posterior.
  2. Selecciona Try again en la página del número. Bird inicia otro intento de verificación. No necesitas desconectar el número primero.
  3. Si falla de nuevo, conserva el error y la hora del intento y contacta a soporte. Evita solicitar códigos repetidamente mientras el problema de recepción subyacente o el límite del proveedor no estén resueltos.
Que el botón de reintento esté disponible no garantiza que Meta acepte la siguiente solicitud ni que el código llegue.

Recepción por voz o SMS

Bird prefiere la voz cuando hay un intento de voz sin usar disponible y puede usar SMS cuando es compatible, incluso cuando no puede preparar la ruta de voz. Comprueba las capacidades y la ruta de recepción del número antes de comenzar. La capacidad de voz le da al proceso otra forma de recibir un código; no garantiza una tasa de entrega más alta.

Próximos pasos

Recursos relacionados

Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.

Ver la guíaConnecting WhatsApp to Bird: from buying a number to a live channelExplorar la funcionalidadConnect WhatsAppSeguir la ruta de aprendizajeBuild your first integration
Prueba el ejercicio y obtén un resumen de implementación