Gestión de números WhatsApp
Abre Numbers para ver tus números WhatsApp, su estado de conexión y sus cuentas de negocio. Para añadir un número, sigue Conecta tu número.
Consultar el estado de conexión
| Estado | Qué hacer |
|---|---|
| Preparing | Espera mientras Bird verifica un número de tu espacio de trabajo. |
| Pre-verified | Selecciona Finish setting up para conectarlo a través de Meta. |
| Pending | Espera mientras Bird registra el número en Meta. |
| Connected | Tu número está listo para enviar. |
| Failed | Abre el número para consultar el motivo del fallo. |
Para verification_code_not_received o verification_rate_limited, selecciona Try again en la página del número. Consulta fallos de preverificación para los plazos de reintento. Para otros fallos de configuración, desconecta el número fallido antes de conectarlo de nuevo.
Revisar un número conectado
Abre un número para ver su Quality rating, Messaging limit y Send rate. Estos valores provienen de Meta. Not rated significa que Meta aún no tiene historial suficiente para puntuar el número.
Usa Business profile para actualizar el nombre visible, la descripción, la dirección y la foto de perfil que ven los destinatarios. La sección Activity muestra la actividad de envío.
Revisar la cuenta de negocio
Selecciona la cuenta en la columna WABA para revisar la WhatsApp Business Account propietaria del número.
- Business verification afecta el acceso a funciones como tus propias plantillas de autenticación.
- Marketing Messages API indica si Meta ha aceptado la cuenta para sus optimizaciones de entrega de marketing. Los mensajes de marketing pueden enviarse antes de la incorporación, pero los encabezados GIF la requieren.
- Last read from WhatsApp muestra cuándo Bird actualizó estos detalles por última vez.
Un espacio de trabajo puede tener varias cuentas de negocio. Verifica la cuenta vinculada al número desde el que planeas enviar.
Consulta tus números mediante la API
Usa una clave API con acceso de lectura a whatsapp_management. Listar números devuelve una página paginada con cursor de tus números:
for await (const number of bird.whatsapp.numbers.list({ limit: 25 })) {
console.log(number.id, number.phone_number, number.status);
}for number in client.whatsapp.numbers.list(limit=25):
print(number.id, number.phone_number, number.status)for number, err := range client.Whatsapp.Numbers.List(ctx, bird.WhatsappNumbersListParams{Limit: 25}) {
if err != nil {
log.Fatal(err)
}
fmt.Println(number.Id, number.PhoneNumber, number.Status)
}foreach ($bird->whatsapp->numbers->list() as $number) {
echo $number->getId(), ' ', $number->getPhoneNumber(), ' ', $number->getStatus(), PHP_EOL;
}curl -sS "https://us1.platform.bird.com/v1/whatsapp/numbers?limit=25" \
-H "Authorization: Bearer $BIRD_API_KEY"Leer un número para su estado, calificación de calidad y límites de envío. Lecturas relacionadas:
| Endpoint | Devuelve |
|---|---|
| Perfil de número | Descripción, dirección y sitios web. |
| Eventos de número | Cambios de configuración, estado, calidad, límite y nombre visible, del más reciente al más antiguo. |
| Cuentas de negocio | Las WhatsApp Business Accounts del espacio de trabajo. |
| Detalles de cuenta de negocio | Revisión de cuenta, verificación de negocio, incorporación de marketing y estado de salud en Meta. |
meta_synced_at fecha los valores leídos por última vez de Meta. No aparece en números predeterminados. meta_health_status no aparece hasta que Bird ha leído la cuenta. El campo waba de un número contiene el ID de cuenta de Meta.
Durante la configuración, status puede ser preparing o awaiting_signup. El campo next describe la siguiente acción y finish_setup_url abre el paso en el navegador. El type del evento es un enum abierto, así que maneja valores desconocidos sin fallar.
Usa el panel o la CLI para conectar, renombrar o desconectar un número; estas acciones no forman parte de la API pública ni de los SDKs. Los comandos de la CLI son bird whatsapp numbers create|update|delete y bird whatsapp numbers profile update. Crear una conexión devuelve finish_setup_url porque el paso de consentimiento de Meta requiere un navegador.
Recibir mensajes
Los mensajes a tus números conectados aparecen en el registro de WhatsApp. Las métricas de Inbound muestran el volumen recibido por número. Cada mensaje entrante abre la ventana de atención al cliente de 24 horas para respuestas libres.
Opciones de número
Para un número que tu espacio de trabajo tiene en Bird, Conecta tu número muestra la verificación automática y la configuración con Meta. Para un número alojado en otro lugar, elige I have my own number y recibe tú mismo el SMS o el código de voz de Meta. Usa la migración compatible o la ruta de coexistencia de Business app elegible para un registro existente. Introduce un Phone registration PIN solo si el número ya tiene uno en WhatsApp.
Los números predeterminados envían plantillas compatibles sin necesidad de conectar tu propio número.
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 channelComprender el conceptoWhat is the 24-hour customer service window on WhatsApp?Usar la herramientaWhatsApp message builderExplorar la funcionalidadWhatsApp
Prueba el ejercicio y obtén un resumen de implementación