# Visión general de los números

Un número de teléfono es el origen de tus mensajes y llamadas. Bird vende números en los países que cubre, y un número asignado a tu espacio de trabajo puede transportar SMS, MMS o voz según lo que el número admita. La página [**Numbers**](https://bird.com/dashboard/w/numbers) en el panel muestra los números asignados a ti, y el mismo ciclo de vida está disponible a través de la API: busca qué hay en venta, pide uno, consulta los que tienes y libera los que ya no necesitas.

## Números dedicados y compartidos

Cada número asignado a ti tiene un `kind`, y este decide qué puedes hacer con el número.

Un número `dedicated` pertenece exclusivamente a tu espacio de trabajo. Lo compraste, se te factura un cargo mensual por él y puedes liberarlo cuando termines. Esto es lo que obtienes al pedir un número.

Un número `shared` es un código corto en infraestructura gestionada por Bird. Se te concede el uso en lugar de comprarlo, así que no hay un cargo mensual propio y no puedes liberarlo. Intentar liberarlo falla con [`E14002`](/docs/api/errors/E14002).

## Qué puede transportar un número

Dos campos describen qué es un número y responden a preguntas distintas.

`number_type` es el tipo físico del número: `mobile`, `local`, `national`, `toll_free` o un código corto. Determina cómo se comporta el número en la red y, en varios países, qué documentación necesita.

`capabilities` es lo que el número puede hacer realmente: `sms`, `mms`, `voice` o una combinación. Un número que incluye `voice` puede transportar llamadas; uno que no, no puede. Filtra una búsqueda por capacidad cuando necesites una específica y comprueba el campo antes de construir sobre un número que ya tengas.

Un número asignado no siempre basta para enviar desde él. Algunos países de destino también requieren un registro aprobado para el remitente, que es una aprobación independiente del propio número.

## El estado de un número asignado

`status` indica si un número puede transportar tráfico.

`active` significa que el número está asignado a ti y es utilizable.

`pending_ownership_registration` significa que el número está asignado a ti y se factura, pero un país exige documentación de titularidad que aún no ha sido aceptada. El campo `ownership` indica qué falta y qué llamada lo resuelve. La mayoría de los números nunca entran en este estado, porque la mayoría de los países no exigen nada: su `ownership` es `null`.

`released` significa que el número ya no está asignado a ti.

## El pedido es asíncrono

Pedir un número crea un pedido, y el pedido es lo que rastreas. La mayoría se completan dentro de la solicitud y devuelven el número de inmediato. Uno que necesita esperar al operador regresa aún en curso, y lo consultas periódicamente hasta que alcanza `completed` o `failed`.

Esto importa por dos razones. Un número solo es tuyo cuando su pedido está en `completed`, así que nada debe asumir que el número existe antes de ese momento. Y una tarifa de configuración que ya se cobró no se reembolsa cuando un pedido falla, por eso la búsqueda y el pedido son llamadas separadas: la búsqueda te dice qué hay disponible antes de que te comprometas a comprarlo.

## Próximos pasos

- [Comprar y liberar un número](/docs/guides/numbers/buying-numbers) recorre el ciclo de vida completo a través de la API.
- [Referencia de la API de Numbers](/docs/api/reference/list-available-numbers) documenta cada operación y campo.
- [Idempotencia](/docs/guides/idempotency) explica cómo hacer que un pedido reintentado sea seguro.

## Related resources

- [What is a virtual phone number (VMN)?](/explained/numbers/what-is-a-virtual-phone-number) (answer)
- [SMS numbers](/sms-api/features/numbers) (product)
- [Number types](/docs/guides/numbers/number-types) (docs)

[Get an implementation brief](/learn/workspace?topic=phone-numbers)