Descripción general de Voice

Bird Voice te permite llamar a números telefónicos y responder las llamadas hechas a números que posees. Conecta un sistema telefónico mediante SIP, realiza una llamada desde el navegador o usa el constructor de secuencias para ejecutar un flujo de llamada guardado. Bird conecta las llamadas a la red telefónica pública, la PSTN.

La conexión entre tu sistema telefónico y Bird es un trunk SIP. SIP (Session Initiation Protocol) establece llamadas entre sistemas telefónicos. Bird le da a tu espacio de trabajo una dirección de trunk, que tu sistema telefónico usa para llamadas salientes hacia la red telefónica, y que Bird usa a la inversa para entregar las llamadas que llegan a tus números.

No necesitas un sistema telefónico para hacer la primera llamada: el teléfono en el dashboard realiza una directamente desde el navegador, a través de uno de tus trunks.

También puedes crear una secuencia en el dashboard e iniciarla con la API Create Call. La secuencia gestiona las indicaciones, las opciones del teclado y el enrutamiento de la llamada después de que el destinatario conteste.

Cómo se realiza una llamada

Tu sistema telefónico envía un SIP INVITE a la dirección del trunk para iniciar una llamada. Bird comprueba el identificador de llamante, el país de destino, los límites y el saldo del monedero antes de contactar a un operador. Si la llamada pasa, Bird la enruta y retransmite el audio. Cada conexión es un leg. Cuando un leg termina, Bird escribe su registro en Voice > Legs y emite un evento voice_call.ended.

Una llamada que no pasa una comprobación se rechaza antes de involucrar a un operador, y el motivo específico queda en el registro del leg. Realizar llamadas cubre lo que Bird lee de cada llamada, y Llamadas rechazadas enumera cada motivo de rechazo y qué hacer al respecto.

Cómo se responde una llamada entrante

Un número que tiene tu espacio de trabajo lleva una única respuesta a la vez, configurada en el propio número o, cuando no tiene ninguna, tomada de la ruta predeterminada de tu espacio de trabajo: entregar la llamada a uno de tus trunks SIP, reenviarla a un número que hayas verificado, ejecutar una secuencia publicada, hacer sonar un grupo de llamada de personas conectadas en el teléfono del navegador o rechazarla. La ruta predeterminada comienza como rechazo, de modo que un número que nadie ha configurado rechaza a quienes llaman.

Cuando llega una llamada, Bird verifica los límites de la cuenta y el monedero de la misma forma que lo hace para una llamada que tú realizas, luego actúa según la respuesta del número y registra cuál fue esa respuesta en la llamada. Recibir llamadas cubre cómo apuntar un número a una respuesta, qué presenta un reenvío a quien contesta, y cómo leer un rechazo.

Antes de tu primera llamada

Para realizar llamadas con tu propio equipo SIP, prepara lo siguiente. Las llamadas por API siguen los requisitos previos de Create Call.

• Crea una troncal SIP, activa las llamadas salientes y autoriza quién puede llamar a través de ella: un rango de IP o una clave de API para tu propio equipo, o credenciales de sesión para un navegador o la CLI.
• Elige un identificador de llamante válido: usa un número que tu espacio de trabajo tenga a través de Bird, o registra un número externo y confírmalo con una llamada de verificación.
• Habilita tus destinos: activa los países a los que llamas.

Realiza tu primera llamada te guía por los tres requisitos y termina con una llamada real.

Leer registros de llamadas requiere voice:read; realizar llamadas requiere voice:write. Gestionar trunks, rutas de números, caller IDs y secuencias usa permisos voice_management. El acceso a una página no otorga permiso para cambiar su configuración ni para realizar una llamada facturable.

La app Voice en el dashboard

Visibilidad

Una llamada puede contener varios legs. El registro tiene una entrada por leg, ya sea que haya conectado, sonado sin respuesta o sido rechazada. Las llamadas reenviadas o con varias partes pueden tener, por tanto, varias entradas:

• Registro de tramos: la vista por tramo en la página Legs. Incluye el estado, ambos números, la troncal por la que entró el tramo, la respuesta SIP con la que terminó, las horas de respuesta y finalización, el tiempo facturable y el coste. Filtra el registro y exporta los registros coincidentes como CSV. El CSV incluye las duraciones y el tiempo facturable, pero no tiene una columna de coste; consulta los cargos en Uso, gasto y facturas.
• Eventos de Voice: voice_call.initiated, voice_call.answered y voice_call.ended entregados a tu propio endpoint, para que tus sistemas se enteren de una llamada sin hacer polling.

La referencia de API enumera los contratos públicos HTTP y los métodos SDK compatibles. La referencia de CLI y la referencia de la herramienta MCP describen sus operaciones publicadas. Estas superficies pueden exponer operaciones distintas; una acción del dashboard o un comando CLI no establece por sí solo un método SDK público.

Límites

Tus llamadas tienen tres límites en ambas direcciones: cuántas puedes tener en curso a la vez, cuántas puedes iniciar por segundo y cuánto puedes gastar en voz en un día UTC. Tu plan de Voice establece los límites de llamadas simultáneas y por segundo para tu organización: la modalidad de pago por uso aplica los valores predeterminados y los niveles superiores de Voice los aumentan. El límite de gasto diario funciona de otra manera. Cada espacio de trabajo establece su propio límite en Voice > Spend limit, y por país en Voice > Destinations, hasta el máximo de tu organización; los planes de Voice de mayor nivel aumentan ese máximo. Si una llamada supera cualquiera de estos límites, se rechaza al establecerla y su registro indica cuál se ha superado, en Llamadas rechazadas. Los valores de cada plan figuran en la página de precios de Voice; cambia a un plan superior en Billing and payments > Overview.

La plataforma limita la duración de las llamadas a 4 horas. Bird cuelga ambos extremos de una llamada que alcanza esa duración, así que organiza las sesiones más largas en varias llamadas. En una llamada que ejecuta una secuencia de llamadas, el tiempo cuenta desde que Bird la acepta o la recibe. Por tanto, la espera antes de marcar y el tiempo durante el que suena consumen parte de las 4 horas. Estados explica cómo aparece una llamada de este tipo en el registro.

El tope por segundo es la política voice_call en Límites de solicitudes, que también explica cómo se resuelve tu límite efectivo y cómo aumentarlo.

Próximos pasos