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 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.

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.

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.

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.

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.