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 voice_call.ended evento.
Una llamada que no pasa una verificació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
Cada número de tu espacio de trabajo tiene una acción configurada para las llamadas entrantes: entregar la llamada a uno de tus trunks SIP, reenviarla a un número que hayas verificado, ejecutar una secuencia publicada o rechazarla. Los números nuevos empiezan rechazando llamadas, por lo que un número sin configurar no las acepta.
Cuando llega una llamada, Bird verifica los límites de la cuenta y el wallet 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 un trunk SIP, activa las llamadas salientes y autoriza a quienes pueden usarlo: un rango de IP o una clave API para tu propio equipo, credenciales de sesión para un navegador o el CLI.
- Elige un caller ID válido: usa un número que tu espacio de trabajo posea 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
| Página | Para qué sirve |
|---|---|
| Metrics | Volumen de llamadas y tasa de respuesta a lo largo del tiempo, resultados de llamadas, principales países y distribución entre entrantes y salientes. Consulta Métricas de Voice |
| Legs | Registros por leg de las llamadas del espacio de trabajo, con totales de uso del mes |
| Calls | Legs y participantes relacionados agrupados en una sola llamada |
| Numbers | Cada número que el espacio de trabajo puede usar para voz, y qué hace cada uno con una llamada entrante |
| SIP Trunks | Tus trunks, su dominio SIP, quién puede enviar tráfico hacia ellos y adónde se entregan las llamadas entrantes |
| Destinations | Los países a los que tu espacio de trabajo puede llamar, desactivados por defecto |
| Sequences | Crear, previsualizar y publicar flujos de llamadas, e inspeccionar sus ejecuciones |
| Phone | Un teléfono flotante que realiza llamadas desde el navegador, a través de uno de tus trunks |
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 legs: la vista por leg en la página Legs. Estado, ambos números, el trunk por el que entró el leg, la respuesta SIP con la que terminó, hora de respuesta y de fin, tiempo facturable y coste. Fíltralo y exporta el resultado como CSV.
- 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
Tres topes se aplican a tus llamadas, en ambas direcciones: cuántas puedes tener en curso a la vez, cuántas llamadas nuevas por segundo y cuánto puedes gastar en voz en un día UTC. Cada uno se establece por organización, y las cantidades dependen de tu plan. Una llamada que exceda cualquiera de ellos se rechaza al inicio, y su registro indica cuál fue, en Llamadas rechazadas.
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 solicitar más capacidad.
Próximos pasos
| Página | Qué cubre |
|---|---|
| Realiza tu primera llamada | Desde un espacio de trabajo vacío hasta un teléfono sonando |
| Phone | Llamar desde el dashboard, qué necesita y qué puedes hacer durante la llamada |
| Trunks SIP | Crear un trunk, sus datos de conexión y controlar quién puede enviar tráfico |
| Realizar llamadas | Qué espera Bird en el INVITE, y cuánto cuesta una llamada |
| Recibir llamadas | Apuntar un número a un trunk o un reenvío, y qué registra |
| Caller IDs | Registrar un número y demostrar que es tuyo con una llamada de verificación |
| Destinos de Voice | Activar los países a los que llamas y qué significa alto riesgo |
| Registro de legs | Consultar, filtrar y exportar tus registros de legs |
| Eventos de Voice | Los tres eventos de llamada y sus payloads |
| Solución de problemas | Diagnosticar una llamada que no se completa, a partir de su síntoma |
| Webhooks y eventos | Configuración de endpoint, verificación de firma, reintentos y reproducción |
Recursos relacionados
Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.