Caller IDs

Un caller ID es un número que tu espacio de trabajo puede presentar en una llamada saliente. Bird comprueba la cabecera SIP From en cada llamada comparándola con los números de Bird que este espacio de trabajo puede presentar y con sus números externos verificados. Las llamadas que presentan un número no admitido se rechazan.

Gestiona los caller IDs en Voice > Numbers, que lista todos los números que tu espacio de trabajo puede usar para voz. Un número que nos compraste y un número que verificaste aparecen en la misma lista, una fila por número. Un número que es ambos aparece una sola vez. Un número que nos compraste está listo para presentar en cuanto lo tienes asignado, sin llamada de verificación: tenerlo asignado es la prueba. El procedimiento a continuación es para un número que posees en otro lugar.

Cada fila muestra el nombre, el número y su país, su Proveedor, las direcciones que admite y para qué se utiliza. Un número que espera su código muestra Verificando; uno cuyo código caducó o cuyos intentos se agotaron muestra Fallido. Cada página contiene hasta 25 números. Selecciona una fila para abrir la página de ese número.

Registrar un número

1. Selecciona Add number > Verify a number you own.
2. Introduce el número en formato E.164: un + inicial, código de país y número nacional. Un número solo se puede registrar una vez en tu espacio de trabajo.
3. Guárdalo. Se realiza una llamada de verificación al número de inmediato.
4. Contesta la llamada y escucha el código de seis dígitos.
5. Introduce el código en el panel. Tienes cinco intentos; un código aceptado cambia el estado a Verified.

La verificación del caller ID no cobra a tu espacio de trabajo por la llamada de verificación. El registro sigue requiriendo permiso de gestión de Voice y la aprobación de la cuenta para registrar números verificados. Ponle nombre al número después en su propia página. Consulta Dar nombre a un número.

Tras la verificación, comprueba el país al que pretendes llamar en Voice > Destinations. La verificación intenta habilitar el país del número verificado, pero países no disponibles o una actualización de configuración fallida pueden dejarlo deshabilitado. Un caller ID verificado y un destino habilitado son requisitos independientes.

Registrar y verificar mediante la API

Registra un número para iniciar su llamada de verificación y luego envía el código con el ID que devuelve el registro. Lista tus identificadores de llamante para encontrar un número registrado en el dashboard. También puedes cambiar el nombre de un identificador de llamante o eliminarlo. Las lecturas requieren voice_management:read; el registro, la verificación, el cambio de nombre y la eliminación requieren voice_management:write. La referencia de la API incluye ejemplos de SDK, la línea de comandos de Bird y MCP.

Si no se pudo iniciar la llamada de verificación original, enviar el código puede iniciar otra llamada al número registrado. Tu organización debe seguir cumpliendo los requisitos de registro. Si el código caduca o se agotan los intentos, elimina el identificador de llamante y vuelve a registrar el número, lo que realiza una nueva llamada de verificación; después envía el nuevo código con el ID que devuelve ese registro. Si el código se acepta pero la activación devuelve 412 o 503, la titularidad sigue demostrada y el identificador de llamante aparece como verified con outbound_enabled: false. Un 412 significa que la verificación de identidad está incompleta, y la completas en el panel, o que hay una revisión o denegación de elegibilidad, que requiere soporte. Un 503 significa que la evaluación de elegibilidad está pendiente o no está disponible, así que vuelve a intentarlo más tarde. Una vez resuelto, envía una solicitud de verificación vacía al mismo ID; no lo elimines ni lo vuelvas a registrar.

Después de la verificación, revisa tus destinos de Voice y habilita el país del número cuando esté admitido y sea necesario. La verificación intenta habilitarlo, pero una verificación correcta del identificador de llamante puede dejar el destino deshabilitado y bloquear las llamadas salientes a ese país.

Una verificación a la vez

El registro puede devolver E21036 cuando el proveedor de verificación ya tiene un desafío para ese número perteneciente a otro espacio de trabajo u otro propósito. Espera a que esa verificación termine o expire y luego registra el número de nuevo. Una prueba obtenida para otro espacio de trabajo no verifica el número en el tuyo.

El mismo rechazo aplica a un número que está ocupado por otro motivo: un código de inicio de sesión o una verificación de Trust Hub ya en curso hacia él. Si ningún otro espacio de trabajo está verificando el número, esa suele ser la razón, y la espera es la misma.

Una verificación que ya terminó en otro lugar no te bloquea: el mismo número puede ser un caller ID verificado en más de un espacio de trabajo, y cada uno lo demuestra por separado.

Estados

Get a new code registra el número de nuevo y lo llama con un código nuevo. Si la primera llamada nunca llegó y el número sigue pendiente, elimina el caller ID y añade el número otra vez.

Si lees estos valores desde tus propias herramientas, reconoce los que manejas y trata cualquier otro como un estado que no manejas en lugar de un error.

Verificación de CLI y aviso sobre la entrega

Bird realiza la verificación CLI (Calling Line Identification) para confirmar que un A-number es válido y está autorizado para su uso antes de que se puedan realizar llamadas salientes desde la plataforma. Esta verificación garantiza que el número es legítimo y está bajo el control del cliente.

Sin embargo, la verificación no garantiza la entrega de extremo a extremo del CLI ni la conexión de la llamada cuando el CLI no es un número adquirido a través de Bird. Los operadores intermedios e internacionales aplican sus propias regulaciones nacionales y políticas de tráfico, que están fuera del control de Bird. Estas pueden incluir:

• Marcos de autenticación de caller ID y anti-suplantación (p. ej., STIR/SHAKEN en EE. UU., directrices CLI de Ofcom en el Reino Unido)
• Requisitos de que el CLI sea un número registrado localmente o del mismo país
• Filtrado de spam y fraude aplicado por operadores de terminación
• Restricciones sobre categorías de tráfico específicas, como juegos de azar, promociones financieras, cobro de deudas o mensajería política
• Bloqueo de llamadas internacionales que presentan un CLI nacional (restricciones de "origin-based")
• Listas de no originar y bloqueos exigidos por reguladores

Por estos motivos, Bird puede verificar un CLI pero no puede garantizar que (1) el CLI se conserve y se muestre a la parte llamada, o (2) la llamada se conecte a través de troncales nacionales o socios y operadores internacionales de nivel 1. Para maximizar la entrega del CLI y las tasas de completación de llamadas, recomendamos usar números adquiridos a través de Bird, que están aprovisionados y enrutados de acuerdo con los requisitos regulatorios locales.

Dar nombre a un número

Un nombre identifica el número en el panel y en la lista Call from del marcador. No se envía con la llamada.

Selecciona el número en la lista Numbers para abrir su página, establece Name y guarda. Deja el campo vacío para mostrar solo el número. Asignar un nombre funciona en cualquier estado y no cambia el número ni su verificación.

Verificar un número que no puedes contestar

Alguien debe contestar la llamada de verificación y escuchar su código. Si el número normalmente llega a un sistema desatendido, redirige temporalmente a un teléfono que puedas contestar y luego restáuralo. Contacta con soporte si el número no puede recibir llamadas.

Eliminar un caller ID

Usa Remove caller ID en la fila del número. Eliminar la verificación retira esa prueba para nuevas llamadas. Un número asignado a tu espacio de trabajo a través de Bird puede seguir siendo elegible gracias a su asignación; un número externo que pierde su prueba se rechaza con caller_id_not_verified. Las llamadas en curso continúan y los registros de llamadas existentes no cambian.

Próximos pasos