Un operador puede ofrecer un número a la venta incluso cuando WhatsApp no lo aceptará. Verificar ese candidato antes de comprarlo evita pagar por un número que no puedes conectar a través del flujo de configuración previsto.
¿Cómo ejecuto la verificación previa de número de Bird?
Usa bird whatsapp numbers precheck con el número candidato antes de comprarlo.
bird whatsapp numbers precheck +31612345678Proporciona el número en formato internacional con un + inicial y el código de país. La solicitud API lo incluye en phone_number. No necesitas ser su propietario.
El endpoint es POST /v1/whatsapp/numbers/precheck. Usa una sesión CLI iniciada o un grant MCP con whatsapp_management:write, como exige la referencia de comandos.
| Flag | Qué te permite inspeccionar |
|---|---|
--example | El cuerpo de la solicitud sin credenciales |
--dry-run | La solicitud resuelta sin enviarla |
--response-schema | Los campos de la respuesta |
Un cliente MCP llama a la misma operación a través de whatsapp_numbers_precheck.
¿Qué significan available y unavailable?
available significa que la verificación no encontró obstáculo para conectar el número en ese momento. unavailable significa que WhatsApp lo rechazó.
| Resultado | Qué hacer con un candidato a compra |
|---|---|
available | Continúa las verificaciones de compra, sabiendo que el resultado no reserva el número |
unavailable | Descarta ese candidato; investiga su registro si ya lo posees |
Un número unavailable puede estar ya registrado en WhatsApp o ser un número que WhatsApp no puede servir. El resultado no distingue esas razones, así que no deduzcas una solo a partir del resultado.
Un fallo en la solicitud es distinto de un resultado unavailable. Gestiona el error API devuelto antes de tratar al candidato como no apto.
¿La verificación cambia algo?
Sí. Envía el candidato a WhatsApp. Meta puede crear una entrada temporal en la cuenta de negocio de Bird.
No conecta el número a tu espacio de trabajo ni lo reserva para la compra. Verifica solo el candidato que piensas comprar, porque recorrer una lista puede dejar entradas temporales de números no utilizados.
Reutiliza un Idempotency-Key cuando reintentes la misma verificación. Durante la ventana de respuesta de tres horas de Bird, la misma clave devuelve la respuesta almacenada en lugar de consultar a WhatsApp de nuevo.
El encabezado de respuesta Idempotency-Replay identifica esa repetición. Cuando la ventana de respuesta termina, la misma clave puede iniciar una verificación nueva.
¿Dónde encaja la verificación en el proceso de compra de un número?
Verifica la disponibilidad del operador y la aceptación de WhatsApp antes de realizar el pedido del número.
- Busca con
bird numbers available list --country-code US. - Vuelve a verificar el candidato seleccionado con
bird numbers available get. - Ejecuta la verificación previa de WhatsApp sobre ese candidato.
- Realiza el pedido solo después de
available, usandobird numbers orders create.
Un 404 en la reverificación de disponibilidad del operador significa que necesitas otro candidato. Completa cualquier verificación de organización requerida en el dashboard antes de realizar el pedido.
Un pedido pending aún necesita que el operador complete el aprovisionamiento. Espera a que el pedido se resuelva antes de depender del número.
¿Qué pasa si ya soy propietario del número?
Usa el resultado para investigar si el número está listo para conectarse, en lugar de tomar una decisión de compra.
La configuración de número propio de Bird no puede conectar un número mientras su registro de app de consumidor o de WhatsApp Business siga activo. Resuelve ese registro con el propietario de la cuenta antes de intentar la conexión.
Un número que pasa la verificación aún necesita completar el flujo de conexión. Confirma que su estado llega a Connected antes de usarlo como tu remitente de marca.
Los remitentes gestionados por Bird son una opción aparte para las plantillas gestionadas de autenticación y utilidad. No envían tu contenido de formato libre ni reciben respuestas de clientes en tu espacio de trabajo.
En resumen
Verifica antes de comprar.
Una búsqueda de números no establece compatibilidad con WhatsApp. Ejecuta la verificación previa sobre el candidato que piensas comprar.
Interpreta unavailable sin inventar una razón.
El número puede estar ya registrado o no ser compatible. El resultado no distingue entre esos casos.
Trata la verificación previa como una escritura.
Envía el número a WhatsApp y puede crear una entrada temporal. No reserva ni conecta el número.
Reutiliza las claves de reintento para la misma verificación.
Una repetición por idempotencia devuelve la respuesta almacenada. Esa respuesta describe la verificación anterior, no una garantía de disponibilidad nueva.