Preguntas sobre voz, resueltas.

Bird Voice conecta sistemas telefónicos y aplicaciones a la red telefónica. Usa troncales SIP, llamadas desde el navegador y secuencias de llamada, o conecta un runtime de voz con IA. Sigue las llamadas a través de sus registros, sesiones y eventos.

Crea un espacio de trabajo, prepara un troncal listo para llamar y una identidad de llamante, y habilita el destino que quieras probar. El tiempo de configuración depende del acceso, la verificación y el cliente que conectes. La guía de primera llamada recorre paso a paso una llamada controlada desde el navegador.

Tres cosas de tu lado: un troncal SIP con tu equipo autorizado (por rango de IP o clave API), un identificador de llamada verificado (el número que presentas como llamante) y el país de destino habilitado. Bird asigna el enrutamiento a tu workspace, que es el cuarto requisito y se configura del lado de Bird.

No. Usa el teléfono del navegador o un softphone, PBX o aplicación SIP compatible. Haz coincidir el transporte, la autenticación y la configuración de medios soportados con la configuración del troncal.

Sí. Puedes realizar llamadas desde la aplicación Phone del panel de control utilizando WebRTC.

Por llamada, a una tarifa que depende del país de destino. Cada tarifa incluye un incremento de facturación: un tiempo mínimo facturado y luego el paso al que se redondea en adelante. Una tarifa con un mínimo de un minuto y pasos de seis segundos cobra una llamada de 10 segundos como un minuto completo.

El tiempo facturable va desde el momento en que el número llamado contesta hasta que la llamada termina. Revisa los componentes de tarifa publicados para tu caso de uso; el alquiler de número y otros servicios configurados son independientes del tiempo de llamada contestada.

Prepago, desde el saldo de tu organización. Bird verifica tu saldo antes de marcar al operador, por lo que una llamada que tu saldo no pueda cubrir se rechaza de antemano con insufficient_balance en lugar de facturarse después.

Sí. Se aplica un tope de gasto diario en voz por organización, que se restablece al inicio de cada día UTC. Una vez superado, las llamadas se rechazan con daily_spend_exceeded. El monto depende de tu plan, y Bird puede aumentarlo a solicitud.

Abre la llamada en el registro de llamadas. El costo aparece en el registro una vez que se ha tarifado, con precisión completa y sin impuestos. Para totales entre varias llamadas, exporta la lista filtrada como CSV desde la página de Llamadas, o consulta tus facturas y consumo.

Tres límites: cuántas llamadas puedes tener en curso a la vez (llamadas concurrentes), cuántas llamadas nuevas puedes iniciar por segundo (llamadas por segundo) y cuánto puedes gastar en voz en un día UTC (gasto diario). Los topes aplicables dependen de la configuración de tu cuenta.

La llamada se rechaza en la configuración, antes de que se marque a un operador. El registro de la llamada indica qué límite se alcanzó: concurrent_calls_exceeded, calls_per_second_exceeded o daily_spend_exceeded. Tu sistema telefónico recibe un SIP 503.

Contacta a soporte con tu tráfico esperado, destinos y gasto para solicitar una revisión de límites. Confirma los límites aprobados antes de aumentar el tráfico en producción.

Revisa qué motivo tiene el registro de la llamada. Un marcador puede alcanzar calls_per_second_exceeded sin estar ni cerca del tope de llamadas concurrentes, porque los dos límites son independientes. Reduce la velocidad de marcación y reintenta; reintentar de inmediato obtiene la misma respuesta.

No. El trunking SIP conecta un sistema telefónico compatible con Bird. Ajusta el transporte, la autenticación y la configuración de medios del trunk a los del cliente que uses.

Sí. Configura cada dirección por separado. Las llamadas entrantes también necesitan un número con capacidad de entrada apuntado al trunk y una pasarela de entrega.

Sí, cuando su entorno de ejecución pueda gestionar tanto la señalización SIP como la conexión de audio. La aplicación conversacional controla su habla, modelo y acciones de negocio; Bird transporta la conexión telefónica.

Los números apuntados a ese trunk vuelven a una ruta de rechazo. Reactivar el trunk no restaura sus asignaciones anteriores; revisa los números antes de reanudar el tráfico.

Bird Voice no transporta llamadas de emergencia. Usa un servicio telefónico diseñado para ese requisito.

Un SIP trunk es la conexión entre tu sistema telefónico y Bird. SIP (Session Initiation Protocol) es el lenguaje que usan los sistemas telefónicos para establecer llamadas, y un trunk es la línea por la que viajan esas llamadas. Bird asigna a tu workspace una dirección de trunk, y tú apuntas tu sistema telefónico hacia ella.

La mayoría de los workspaces solo necesitan uno. Crea más cuando quieras reglas de acceso separadas por sede o por sistema, ya que la lista de IPs permitidas, las API keys autorizadas y la configuración de Digest son por trunk.

El dominio SIP del trunk (copiado desde la página del trunk), el nombre de usuario bird y la contraseña (el secreto de una clave API autorizada en el trunk). Envíe las llamadas al dominio SIP en el puerto 5060 (UDP o TCP) o 5061 (TLS).

Sí, con una lista de IPs permitidas, API keys autorizadas, o ambas. Agrega las direcciones públicas desde las que tu equipo envía SIP, o exige que cada llamada se autentique con una API key mediante SIP Digest. Ambas opciones se aplican en la siguiente llamada.

El dominio SIP del trunk deja de aceptar nuevas llamadas inmediatamente. Las llamadas en curso continúan, y los registros de llamadas realizados a través del trunk permanecen en tu registro de llamadas.

Su PBX envía la llamada, Bird responde con un desafío 407 y su PBX reenvía la llamada con un encabezado Proxy-Authorization calculado a partir del nombre de usuario bird y el secreto de su API key como contraseña. Su PBX envía un hash de la contraseña, nunca la contraseña en sí.

SHA-256 y MD5. Bird ofrece SHA-256 primero y MD5 segundo de forma predeterminada, y su PBX elige el primero que admita. Si su equipo solo maneja MD5 y gestiona incorrectamente un desafío que comienza con SHA-256, configure el trunk solo para MD5.

Sí. Cuando un trunk tiene ambos, la dirección de origen se verifica antes de que Bird solicite una contraseña, por lo que una llamada desde una dirección no incluida en la lista se rechaza independientemente de las credenciales que lleve.

Añada la nueva clave al trunk primero, migre su equipo y luego revoque la antigua. Revocar o eliminar una clave elimina su capacidad de autenticación de inmediato en todos los trunks que la permitían.

Un caller ID es un número de teléfono que tu espacio de trabajo puede presentar como origen en llamadas salientes. Bird compara el número de origen que tu equipo coloca en el encabezado From de SIP con esta lista en cada llamada, usando las identidades habilitadas para tu espacio de trabajo, incluidos los números elegibles en Bird y los números externos verificados.

Añade el número en formato internacional E.164 y sigue el flujo de verificación. Contesta la llamada de verificación e introduce el código en el panel. Usa el estado que aparece en el número para confirmar que está listo antes de llamar.

Si se agotaron los intentos, utilice Obtener un nuevo código en la fila del número para recibir una nueva llamada de verificación. Si el número aún está esperando su código, elimine el identificador de llamada y añada el número de nuevo.

Prepárate para contestar la llamada de verificación desde el sistema que recibe llamadas para ese número. Si el número no puede recibir la verificación, contacta a soporte sobre las comprobaciones de titularidad disponibles.

Desde ese momento, cualquier llamada que presente ese número se rechaza con caller_id_not_verified. Las llamadas ya en curso continúan y los registros de llamadas que usaron el número permanecen tal como están.

El fraude de peaje funciona marcando países costosos a los que nunca tuvo intención de llamar. Los países que habilita son en los que puede acumular cargos, así que dejar todo lo demás desactivado limita su exposición si alguien compromete su sistema telefónico.

Busque el país en la página de Destinos usando el cuadro de búsqueda (busca por nombre o código de dos letras) y active su interruptor. El cambio se aplica desde ese momento.

Las llamadas a países de alto riesgo son costosas, y quien opera el número que marca recibe una parte del costo. Estos son los países que un atacante apunta si compromete un sistema telefónico. Déjelos desactivados a menos que tenga negocios allí, y revise la tarifa antes de habilitar uno.

Contacte a soporte para que lo habiliten en su cuenta. Available significa que puede habilitarlo; Not supported significa que Bird actualmente no puede realizar llamadas a ese país desde su cuenta.

Un país disponible puede tener destinos específicos dentro de él que el enrutamiento aún no alcanza. Comparte el ID de la llamada con soporte para investigar la cobertura de destino y el rechazo.

Dos encabezados: To (el número al que se llama) y From (el número que presentas como llamante, que debe ser una identidad de llamante elegible). Ambos deben ser números internacionales completos en formato E.164: un + inicial seguido del código de país y el número nacional. No se necesitan encabezados personalizados.

STIR/SHAKEN permite a los proveedores firmar la información de identidad del llamante. La atestación refleja lo que el proveedor puede verificar sobre el llamante y el número. No garantiza que el operador de destino conecte la llamada ni que retire una etiqueta de spam.

Abre la llamada en el registro de llamadas. Tu sistema telefónico solo ve un SIP 503 genérico, pero el motivo específico queda en el registro de la llamada, donde solo tú puedes leerlo. Un panel sobre los detalles indica la causa y enlaza a la configuración que la corrige.

Solo cuando la causa haya desaparecido. Una llamada rechazada por calls_per_second_exceeded obtiene la misma respuesta hasta que reduzcas la velocidad de marcación. Lee el motivo de rechazo antes de reintentar.

No. Significa que la llamada se conectó. Vincula un evento de negocio confirmado, como una reserva o un caso resuelto, para evaluar el éxito de la tarea.

Una llamada activa aún no ha completado la tarificación. Lee el registro final después de que la llamada y el ciclo de tarificación terminen; un valor ausente no es un precio de cero.

Verifica la firma, deduplica usando el identificador del webhook y tolera la llegada en orden diferente. Reconcilia el resultado final contra el registro de la llamada.

Revisa la dirección y los filtros del informe de forma explícita. La composición del tráfico y los componentes tarificados aplicables pueden diferir.

Vincula las llamadas tarificadas y sus sesiones con los resultados confirmados en tu aplicación. Incluye cada tramo de llamada relevante y usa un periodo y una definición de completitud consistentes.

Cinco: Answered (el número llamado contestó), No answer (sonó sin respuesta), Failed (la llamada no se completó, ya sea porque Bird la rechazó o un operador falló), Rejected (el operador rechazó la llamada directamente) y Unknown (no se pudo determinar el resultado).

Ambos aparecen como Failed. El motivo de rechazo es lo que los diferencia: solo un rechazo de Bird incluye uno. Una llamada fallida con motivo de rechazo apunta a una configuración de su lado o del de Bird; una sin motivo de rechazo generalmente apunta al número que marcó.

Sí. La pestaña En vivo en la página de Llamadas muestra las llamadas en sus trunks en ese momento, con un contador. Una llamada en vivo se muestra como Ringing (esperando que el otro lado conteste) o In progress (conectada). La pestaña se actualiza cada pocos segundos.

La duración total va desde el momento en que Bird recibió la llamada hasta el cuelgue. El tiempo facturable va desde la respuesta hasta el cuelgue. La diferencia es el tiempo de timbre que nadie contestó, así que una diferencia grande merece revisar qué estás marcando. Las llamadas sin respuesta no tienen tiempo de llamada contestada. Consulta la tarifa aplicable para otros componentes y cargos de la llamada.

Tres formas: descargar CSV desde la página de Llamadas (exporta todos los registros que coincidan con sus filtros actuales, no solo la página visible), leerlos a través de la API con una API key con permisos de voice:read, o usar el Bird CLI con bird voice list.

Tres: voice_call.initiated (Bird aceptó la llamada y comenzó el enrutamiento), voice_call.answered (el número llamado contestó) y voice_call.ended (la llamada terminó, con el resultado). Una llamada no contestada nunca emite el evento answered.

Usa el evento ended para su estado y duraciones reportados, y después reconcilia el resultado final con el registro de llamada. La publicación de eventos puede fallar, y una solicitud rechazada antes de la admisión puede no tener registro de llamada ni eventos. Una actualización faltante no establece que una llamada siga activa.

Sí. Las entregas no están ordenadas, por lo que answered puede llegarte después de ended. Ordena por el campo timestamp y haz que un evento que llega después con un timestamp anterior pierda.

Deduplica usando el encabezado HTTP webhook-id. Un reintento de entrega o señalización puede repetir un evento. La misma llamada y etapa del ciclo de vida conservan su identidad de webhook. Reconcilia una actualización faltante contra el registro de llamada.

Están en el registro de la llamada, no en el evento. Un estado failed en voice_call.ended no indica si lo causó Bird o un operador. Abre la llamada en el registro de llamadas para ver el motivo del rechazo; el costo aparece allí una vez que la llamada ha sido tarifada.

Una llamada que Bird no puede admitir se rechaza en la capa SIP, antes de que exista un registro. Verifica cuatro cosas: el trunk tiene un rango de IPs o una API key que autorice tu equipo, la llamada llegó desde una dirección en la lista de IPs permitidas del trunk (detrás de NAT, esa es la dirección pública del router), las credenciales Digest son correctas (nombre de usuario bird, el secreto de API key correcto, un algoritmo que el trunk ofrezca), y el dominio SIP coincide exactamente con el dominio del trunk.

Abre la llamada en el registro de llamadas. El panel sobre los detalles indica la causa y enlaza a la configuración que la corrige. Las siete razones que puedes solucionar son source_not_allowed, caller_id_not_verified, destination_not_enabled, insufficient_balance, daily_spend_exceeded, concurrent_calls_exceeded y calls_per_second_exceeded.

Algunos equipos gestionan mal un desafío que comienza con SHA-256. Configura el algoritmo Digest del trunk solo como MD5, y tu PBX recibirá un desafío que pueda procesar.

Revisa las direcciones de medios, las reglas de firewall y los códecs soportados. Una causa común es que NAT envíe los medios hacia una dirección privada inalcanzable. Configura el manejo de NAT o STUN del cliente y verifica el audio en ambas direcciones.

Puede serlo. Bird admite TLS en el puerto 5061 para la señalización SIP, de modo que la configuración de la llamada se cifra en tránsito. UDP y TCP en el puerto 5060 no están cifrados. Elija el transporte que se ajuste a sus requisitos de seguridad.

Cada evento se firma con HMAC. Verifica la firma con el secreto de tu endpoint antes de actuar sobre el payload, y rota ese secreto desde el panel de control cuando lo necesites.

Los registros de voz siguen la región de servicio configurada. Revisa los términos aplicables de procesamiento de datos y retención para tu despliegue; el enrutamiento de endpoints de la API por sí solo no describe todas las ubicaciones de procesamiento o almacenamiento.

Usa acceso de voz con nivel de escritura en una clave permitida para autenticar llamadas, y acceso de lectura de voz para leer registros de llamada. El scope voice_management separado cubre la configuración. El troncal también aplica su clave configurada y las reglas de origen.

La razón específica se registra en el registro de llamada, donde solo tú puedes leerla. Devolver un 503 genérico en la capa SIP evita que alguien que explore tu trunk descubra qué trunks, números y destinos existen.

Las certificaciones y la documentación de seguridad están en el Trust Center en trust.bird.com. El acuerdo de procesamiento de datos, la declaración de privacidad y la política de uso aceptable se publican en bird.com/legal. Para un cuestionario de proveedor, tu equipo de cuenta de Bird se encarga.

Una secuencia de llamada controla indicaciones, opciones del teclado y grabación dentro de una llamada telefónica. Un flujo de automatización coordina un proceso de negocio más amplio. Mantén los dos flujos de trabajo y sus decisiones de publicación por separado.

Sí. Combina una indicación hablada o grabada con entrada de teclado y ramas para dígitos reconocidos, tiempo de espera agotado y entrada no coincidente.

No. La captura de teclado lee dígitos DTMF. Un agente de voz con lenguaje natural necesita un entorno conversacional con su propio comportamiento de habla y turnos.

Las llamadas que usan una versión publicada conservan el contenido inmutable de esa versión. Las llamadas nuevas usan la versión recién publicada. Las llamadas de prueba en borrador leen la última secuencia guardada en cada transición y pueden observar las ediciones del borrador.

No. Identifica trabajo aceptado. Sigue el timbre, la respuesta y el resultado final de la llamada por separado, y vincula los reintentos inciertos a la misma operación.

No. Un menú telefónico sigue opciones predefinidas como dígitos del teclado. Una conversación de voz con IA interpreta el lenguaje y genera respuestas a través de un motor conversacional. Ambos necesitan un diseño completo de enrutamiento de llamadas y gestión de resultados.

Un runtime compatible con SIP puede conectarse a través de Bird cuando su señalización, autenticación y comportamiento de medios son compatibles. Valida la integración con una llamada real en ambas direcciones antes de mover tráfico.

No. MCP permite que un agente de software autorizado opere herramientas de la cuenta. Un agente de voz en vivo necesita además audio, procesamiento de voz, gestión de turnos y una aplicación conversacional.

Conecta esas acciones a través de las herramientas autorizadas de tu aplicación. Trata el estado que devuelven como la fuente de verdad y exige la confirmación adecuada del cliente antes de realizar un cambio.

Mide la conexión y finalización de la llamada por separado del éxito de la tarea. Rastrea el resultado de negocio confirmado, la tasa de escalamiento y las razones de fallo observadas; una transcripción o una llamada contestada por sí sola no puede demostrar la conversión.

No. Configura la ruta entrante del número. Una ruta que rechaza es un resultado explícito, no una conexión automática a un equipo o agente.

Sí, a través de la aplicación de llamadas o el entorno de ejecución SIP que configures para recibirla. El número, el trunk entrante, la pasarela y el entorno de ejecución de conversación deben estar listos.

Inspecciona ambos tramos correlacionados de la llamada. Verifica el destino verificado, el destino habilitado, el enrutamiento disponible y los límites de cuenta aplicables.

No. La ruta registra el comportamiento de gestión seleccionado. El estado de la llamada y los eventos relacionados te indican si ese comportamiento se completó con éxito.

El reenvío crea un tramo saliente además del tramo entrante. Consulta las tarifas publicadas y los componentes finales tarifados de la llamada.

No. El teléfono del panel usa el navegador y un trunk SIP de Bird configurado.

El teléfono del panel realiza llamadas salientes. Dirige las llamadas entrantes al sistema telefónico o la aplicación diseñada para contestarlas.

Sí. Usa el teclado para opciones DTMF como un menú IVR o una extensión.

Se transportan y tarifican como llamadas de voz. Consulta las tarifas publicadas para el destino y revisa el registro final de la llamada.

No. Bird Voice no admite llamadas de emergencia.

No. La grabación es una parte explícita del flujo de trabajo configurado. Decide qué fuente compatible capturar y cuándo empieza y termina la captura.

La captura de audio y la transcripción son operaciones separadas. Solicita la transcripción cuando corresponda e inspecciona el resultado de su procesamiento.

Sí. El procesamiento de voz puede finalizar después de la llamada telefónica. Mantén separados el resultado de la llamada y el estado de procesamiento de los artefactos.

No. Una sesión puede correlacionar varios tramos de llamada, y cada uno puede tener sus propios artefactos. Inspecciona la llamada de origen y la identidad de captura.

Úsala como evidencia de la conversación. Confirma una reserva, cambio de pedido o pago en el sistema de negocio que ejecutó esa acción.