Recibir llamadas
Un número de tu espacio de trabajo puede responder una llamada entrante de tres formas: entregarla a uno de tus trunks SIP, reenviarla a un número que hayas verificado, o rechazarla. La respuesta es un ajuste del número, y un número tiene exactamente una respuesta a la vez.
Todos los números comienzan en rechazar, así que un número que nadie ha configurado rechaza a los que llaman en lugar de quedarse sin respuesta.
Requisitos previos
Antes de apuntar un número a una respuesta:
- Un número que pueda recibir llamadas. Abre Voice > Numbers y comprueba en la columna Directions que tenga una marca de entrada. Un número que registraste como caller ID de otro operador no recibe llamadas aquí: ese operador enruta las llamadas dirigidas a él, así que no tiene respuesta.
- Para entregar a un trunk: un trunk SIP con llamadas entrantes activadas y al menos un gateway de entrega.
- Para un reenvío: un caller ID verificado al que reenviar.
- Para cambiar el ajuste a través de la API o CLI: una clave API con el alcance voice_management en nivel de escritura. Ese alcance cubre la configuración de voz; el alcance voice cubre el tráfico de llamadas y las estadísticas, así que leer el registro de llamadas requiere el otro.
Entregar llamadas a un trunk SIP
La entrega llama a tu propio sistema telefónico en las direcciones que declaras en el trunk. Activa la dirección primero, porque un número solo se puede apuntar a un trunk que ya acepte llamadas entrantes.
- Abre Voice > SIP Trunks, abre el trunk y en Inbound calling selecciona Enable inbound.
- Añade al menos un gateway en la misma sección. Un trunk sin gateway rechaza todas las llamadas entrantes a los números que responde.
- Abre Voice > Numbers, abre el número y en Inbound routing elige Deliver to a SIP trunk.
- Elige el trunk y selecciona Save. Solo aparecen en la lista los trunks con llamadas entrantes activadas.
La columna Used for en la lista de Numbers muestra entonces el número como entregado a ese trunk, y la página del trunk lista los números que responde.
Qué necesita un gateway
Un gateway es una dirección a la que se entrega una llamada, y cómo ese par quiere que se escriban los dos números de la llamada:
| Ajuste | Qué es |
|---|---|
| URI SIP | El host de tu sistema telefónico, con un puerto opcional, como en sip:pbx.example.com:5060. Indica solo el host: se rechaza un URI que incluya user part |
| Priority | El orden en que se prueban los gateways, del más bajo al más alto |
| Destination format | Cómo se escribe el número marcado para este par. Por defecto, E.164 |
| Origination format | Cómo se escribe el número que llama para este par, en la cabecera P-Asserted-Identity de la llamada entregada. Por defecto, E.164 |
Los gateways que comparten prioridad reciben una parte igual de las llamadas, y cualquiera de ellos puede ser el primero en una llamada dada. Para pasar la entrega a una segunda dirección, asigna a ese gateway un número de prioridad mayor: se prueba cuando el primero no responde.
Ambos formatos de número son plantillas sobre un marcador de posición, {number}, que representa el número sin su + inicial. El formato de destino se coloca antes del host del URI SIP, así que 1234#{number} entrega una llamada a +31201234567 como sip:1234#31201234567@pbx.example.com:5060. El valor por defecto de ambos es +{number}, que es E.164. Un formato que no contenga ningún {number} envía todos los números que el trunk responde a una única dirección fija.
Warning: turning inbound calling off on a trunk, or deleting the trunk, puts every number pointing at it back on reject. Turning inbound back on does not restore them, so each number has to be pointed at a trunk again.
Reenviar llamadas a otro número
Un reenvío responde la llamada entrante y realiza una segunda llamada a un número que hayas verificado, y luego conecta las dos.
- Abre Voice > Numbers, abre el número y en Inbound routing elige Forward to another number.
- Elige el número al que reenviar. La lista contiene tus caller IDs verificados, porque un reenvío solo puede apuntar a un número que hayas demostrado que controlas.
- Elige qué número muestra la llamada reenviada como el que llama y selecciona Save.
El destino del reenvío se comprueba cuando lo configuras y de nuevo en cada llamada que reenvía. Un caller ID que elimines después deja de reenviar en lugar de continuar, y las llamadas entrantes se rechazan a partir de ese momento.
La llamada reenviada suena durante 45 segundos antes de darse por perdida, más tiempo que una entrega a trunk, porque el extremo remoto suele ser el teléfono de una persona y no un sistema telefónico.
Un reenvío realiza una llamada, así que las reglas de salida se aplican al segundo tramo: reenviar a un país que no hayas activado en Destinations se rechaza con destination_not_enabled.
Un reenvío, dos registros de llamada
Una llamada reenviada produce dos registros que comparten un session_id:
| Registro | Qué es |
|---|---|
| La llamada entrante | direction es inbound, y route indica que el número estaba configurado para reenviar, a qué número, y qué número presentó el tramo reenviado |
| La llamada reenviada | direction es outbound, desde el número que el tramo presentó hasta el número al que reenvías. No tiene route propio |
Agrúpalos por session_id para ver la llamada completa. El registro de la llamada entrante es el que indica cómo estaba configurado el número.
Elegir qué número muestra una llamada reenviada como el que llama
Una llamada reenviada tiene dos números que podría presentar a quien responda, y la elección cambia tanto lo que ven como la probabilidad de que un operador interfiera con la llamada:
- Calling number es el número propio de quien llama, así que el teléfono suena como si hubiera marcado directamente y la llamada se puede devolver desde el registro de llamadas. Como el número no es tuyo, algunos operadores, sobre todo en EE. UU. y partes de Europa, marcan esas llamadas como no verificadas, reemplazan el número o las filtran.
- Dialed number es el número que marcó quien llama, que es uno de los tuyos. Quien responda ve cuál de tus números se marcó, en lugar de quién llamó.
No hay valor por defecto. Indica la elección en cada reenvío que escribas a través de la API o CLI.
Los valores que tu espacio de trabajo puede establecer están indicados en el propio número, en forward_as_options de su inbound_configuration. Presentar el número marcado requiere que tu espacio de trabajo esté aprobado para realizar llamadas desde números que nos compraste, y esa aprobación aún no está disponible, así que forward_as_options ofrece solo el número que llama y el reenvío presenta el número propio de quien llama. Establecer el número marcado se rechaza hasta entonces.
En una lectura, forward_as es el valor que las llamadas realmente llevan, que puede diferir del último valor escrito.
Consultar qué hizo un número con una llamada
El registro de una llamada entrante lleva un route junto a su estado, y route es lo que el número estaba configurado para hacer en el momento en que se gestionó la llamada. Cambiar el ajuste del número después no cambia lo que dicen sus llamadas anteriores.
| route.type | Qué hizo el número |
|---|---|
| trunk | La llamada se entregó al trunk SIP indicado en trunk_id |
| forward | La llamada se reenvió al número en forward_to, presentando el número en forward_as |
| reject | El número rechazó la llamada |
route indica lo que el número estaba configurado para hacer, no que haya funcionado. Una ruta trunk en una llamada que nunca se conectó es un número apuntado a un trunk que no aceptó la llamada, y el estado de la llamada es lo que refleja el resultado. route está ausente en llamadas salientes y en llamadas registradas antes de que existiera el campo.
En el panel, abre la llamada desde Voice > Calls y consulta la fila Inbound route, que enlaza al número cuya configuración la decidió. A través de la API, route está en GET /v1/voice/calls/{call_id} y GET /v1/voice/calls, y direction filtra la lista a llamadas entrantes.
Diagnosticar una llamada entrante rechazada
Una llamada entrante que fue rechazada se registra con el estado rejected. Dos cosas distintas lo producen, y rejection_reason es lo que las distingue:
- Rechazada sin rejection_reason. El propio número rechazó la llamada. La llamada no falló ninguna comprobación nuestra, por lo que no indica motivo, y route dice lo que el número estaba configurado para hacer. Una ruta reject es un número que nadie ha apuntado a ningún sitio, o uno configurado deliberadamente para rechazar.
- Rechazada con rejection_reason. La llamada falló una de nuestras comprobaciones antes de llegar a tu sistema telefónico. El motivo indica la comprobación. Rejected calls lista todos los motivos y su solución.
failed es un estado diferente y no significa rechazada: significa que se intentó la llamada y no funcionó, con sip_response_code indicando la respuesta recibida.
Lee route y rejection_reason juntos para distinguir los rechazos:
| route y motivo | Causa |
|---|---|
| reject, sin motivo | El número no está apuntado a ninguna respuesta. Eliminar un trunk, o desactivar sus llamadas entrantes, devuelve aquí todos los números que apuntaban a él, así que un número que antes funcionaba puede acabar aquí |
| trunk, no_route_found | El número está apuntado a un trunk, y ese trunk no tiene un gateway al que entregar la llamada. Añade uno en la página del trunk |
| forward, sin motivo | El destino del reenvío ya no es un caller ID verificado. Verifícalo de nuevo en Caller IDs, o reenvía a otro número |
| forward, destination_not_enabled | No se pudo realizar el segundo tramo hacia el país del destino del reenvío. Activa ese país en Destinations |
Los límites de la cuenta también se aplican a las llamadas entrantes: si superas el saldo de tu monedero, el límite diario de gasto en voz de tu organización, o tus límites de concurrencia y por segundo, la llamada entrante se rechaza con el motivo correspondiente. Voice overview cubre los propios límites.
Comprobar cuánto cuesta una llamada recibida
Recibir una llamada tiene coste. La tarifa depende del país y tipo del número que la recibe, y se publica por país en Receiving calls en la página de precios de voz, junto a las tarifas de las llamadas que realizas.
Un reenvío se factura como dos llamadas: la llamada entrante a la tarifa de recepción, y el tramo que realizamos a la tarifa de salida del número al que reenvías. Se cobra una única tarifa de gestión por la llamada, no una por tramo.
El monedero se comprueba antes de entregar una llamada entrante, así que un saldo que no pueda cubrirla significa que la llamada se rechaza en lugar de facturársete después. Cost and billing cubre cómo funcionan el tiempo facturable, las tarifas y el monedero en ambas direcciones.
Próximos pasos
| Página | Qué cubre |
|---|---|
| Trunks SIP | Crear un trunk, sus dos direcciones y controlar quién puede enviar |
| Caller IDs | Registrar un número y demostrar que lo controlas |
| Registro de llamadas | Todos los campos de un registro de llamada y todos los motivos de rechazo |
| Eventos de voz | Recibir resultados de llamadas en tus propios sistemas |
| Solución de problemas de voz | Diagnosticar una llamada que no se completa, a partir de su síntoma |
Recursos relacionados
Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.