Realiza tu primera llamada
Realiza una llamada telefónica real desde el dashboard. El teléfono del dashboard es un cliente SIP que usa el mismo trunk, identificador de llamadas y configuración de destino que tu sistema telefónico.
Después de la llamada, puedes inspeccionar su registro en el dashboard o a través de la API de Voice.
Requisitos previos
Antes de empezar, asegúrate de tener:
- Un espacio de trabajo con Phone en Voice. El dashboard lo muestra cuando la región de tu espacio de trabajo admite llamadas desde el navegador y tienes acceso a Voice en el nivel Write.
- Un número de teléfono de tu propiedad y un teléfono que pueda contestar las llamadas de verificación y de prueba.
- Un navegador con un micrófono funcional.
1. Abre el teléfono
Selecciona Voice > Phone en el dashboard. El teléfono se abre en una ventana flotante y permanece abierto mientras navegas.
Si tu espacio de trabajo no está listo para realizar llamadas, el teléfono muestra Finish setup to place calls. Su lista de verificación identifica cada requisito pendiente y enlaza a la acción necesaria. Crear un trunk listo para llamadas y verificar un identificador de llamadas completa la lista.
2. Crea un trunk listo para llamadas
Selecciona Create a trunk en la lista de verificación. Ingresa un nombre y luego selecciona Create trunk.
El dashboard habilita las llamadas salientes y las credenciales de sesión cuando crea el trunk. El trunk también ofrece el digest MD5 que usa el navegador. La lista de verificación marca todos los requisitos del trunk como completados.
3. Verifica tu identificador de llamadas
Selecciona Verify a number you own en la lista de verificación. Ingresa un número de tu propiedad en el campo Phone number con formato E.164: un + inicial, el código de país y el número nacional. Luego selecciona Send verification call.
Contesta la llamada de verificación y escucha el código de seis dígitos. Ingrésalo en el campo Verification code y luego selecciona Verify caller ID.
El dashboard muestra Caller ID verified, elimina el aviso de configuración y agrega el número a la fila From del teléfono.
4. Habilita el país de destino
Abre Voice > Destinations. Busca el país al que planeas llamar y activa su interruptor.
Las llamadas a países deshabilitados se rechazan antes de que la plataforma marque a un operador.
5. Realiza la llamada
Ingresa el número que verificaste en la fila To y luego selecciona Call. Si tu navegador solicita acceso al micrófono, permítelo.
Tu teléfono suena y muestra el identificador de llamadas verificado. Contesta la llamada y confirma que tienes audio bidireccional. Para finalizar la llamada desde el dashboard, selecciona Hang up.
6. Inspecciona el registro de llamada
Abre Voice > Calls. La página lista las llamadas por hora de inicio, de la más reciente a la más antigua, así que tu llamada aparece en la primera fila. Selecciónala para inspeccionar cuándo fue contestada, su duración facturable y su costo una vez que se complete la tarificación.
Los mismos registros de llamada están disponibles a través de la API:
for await (const call of bird.voice.list({ status: ["ringing", "in_progress"] })) {
console.log(call.id, call.status);
}for call in client.voice.list(status=["ringing", "in_progress"]):
print(call.id, call.status)for call, err := range client.Voice.List(context.Background(), bird.VoiceListParams{
Status: []bird.VoiceCallStatus{"ringing", "in_progress"},
}) {
if err != nil {
log.Fatal(err)
}
fmt.Println(call.Id, call.Status)
}foreach ($bird->voice->list(['status' => ['ringing', 'in_progress']]) as $call) {
echo $call->getId(), ' ', $call->getStatus(), "\n";
}bird voice list{
"name": "voice_list"
}curl -X GET "https://{region}.platform.bird.com/v1/voice/calls" \
-H "Authorization: Bearer $TOKEN" \
--url-query "limit=25"Usa el registro de llamada para investigar fallos de llamadas futuros. Una llamada rechazada almacena su causa en rejection_reason. Para filtros del dashboard, campos de registro y acceso a la API, consulta la guía del registro de llamadas.
Soluciona problemas de la llamada de prueba
- El teléfono sigue mostrando Finish setup to place calls: Completa cada requisito pendiente usando el enlace en su fila de la lista de verificación.
- El teléfono muestra un motivo de rechazo: destination_not_enabled significa que el país de destino está deshabilitado. caller_id_not_verified significa que el número en la fila From no está verificado. La referencia de llamadas rechazadas cubre cada motivo y su resolución.
- La llamada conecta, pero un lado no tiene audio: Verifica el permiso del micrófono en tu navegador y el selector de micrófono en el teléfono. La guía de controles en llamada cubre los selectores de dispositivos.
Solución de problemas de Voice aborda los mismos síntomas para cualquier cliente.
Próximos pasos
- Llamadas de prueba desde la terminal: realiza la misma llamada con bird voice tools test-call.
- Configura un cliente SIP: conecta Asterisk, FreePBX, Zoiper u otro cliente al trunk.
- Configura trunks SIP: revisa los ajustes habilitados por el trunk listo para llamadas y otros métodos de admisión.
- Realiza llamadas: comprende cómo la plataforma enruta y tarifica las llamadas.
- Inspecciona el registro de llamadas: filtra registros, revisa campos, recupera llamadas a través de la API o exporta datos en CSV.
- Suscríbete a eventos de voz: envía los resultados de las llamadas a tus sistemas en lugar de consultar periódicamente.
Recursos relacionados
Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.
Comprender el conceptoWhat is a voice API?Explorar la funcionalidadVoiceGuía de implementaciónVoice overview
Obtener un resumen de implementación