Configura un trunk SIP para recibir y realizar llamadas
Esta página recorre la configuración completa de un trunk en el orden que exige el panel. Cuando saltarse un paso produce un síntoma visible, el paso lo indica, así que también puedes usar la página como lista de comprobación cuando falla una llamada de prueba. Para saber qué significa cada ajuste, sigue los enlaces a Trunks SIP, Recibir llamadas y Realizar llamadas.
Antes de empezar
- Un espacio de trabajo de Bird. Las llamadas, los números y los trunks pertenecen a un único espacio de trabajo, así que haz todos los pasos en el mismo.
- Las direcciones públicas de tus equipos: los hosts a los que Bird debe entregar las llamadas y las direcciones desde las que tus equipos envían SIP.
- Para las llamadas entrantes, un número de Bird en ese espacio de trabajo. Para las llamadas salientes, un identificador de llamada: un número de Bird del espacio de trabajo o un número que hayas verificado.
- Un número de Bird cuyo
statusseaactive. Un número que aún espera su documentación de titularidad o su registro no cursa llamadas entrantes ni salientes: consulta Presentar la documentación de titularidad de un número.
1. Crea el trunk
Abre Voice > SIP Trunks, selecciona Add new SIP trunk, introduce un nombre y selecciona Create trunk.
Un trunk nuevo no cursa llamadas en ninguna dirección hasta que actives cada una.
2. Activa las llamadas entrantes
En Inbound calling, selecciona Enable inbound. Debajo aparece la sección Inbound routing.
Si omites este paso, no podrás dirigir números al troncal, porque el troncal no aparece en la lista de troncales del número.
3. Añade tus pasarelas
En Inbound routing, abre la pestaña Gateways y selecciona Add gateway para cada dirección a la que Bird debe entregar las llamadas:
| Campo | Qué introducir |
|---|---|
| Name | Una etiqueta que reconozcas, como Primary SBC |
| Host | El nombre de host o la dirección IP pública de tu equipo, sin sip: ni parte de usuario |
| Port | Déjalo vacío para usar el puerto predeterminado del transporte, o introduce el puerto en el que escucha tu equipo |
| Transport | UDP, TCP o TLS, según lo que use tu equipo |
| R-URI user part | Cómo se escribe el número marcado en la Request-URI. El valor predeterminado es E.164 con + |
| Origination format | Cómo se escribe el número que llama. El valor predeterminado es E.164 con + |
| Priority | La posición del gateway en All gateways (automatic): los números más bajos suenan primero y los números iguales se reparten las llamadas. El valor predeterminado es 0 |
Si tu equipo espera los números sin el + inicial, abre la lista del formato y elige Without the plus, o un prefijo internacional 00 o 011. En Qué necesita un gateway se explican los formatos de número.
Bird transmite la cabecera To tal como la envió el operador de quien llama. Si tu equipo lee el número marcado de To, selecciona Rewrite To user part y construye el mismo formato que en R-URI user part. Así, Bird sustituye la parte de usuario de To en las llamadas a ese gateway.
Tu gateway debe aceptar las llamadas de Bird sin un desafío Digest de SIP, porque Bird no responde a ese desafío.
4. Elige el grupo en el que se buscan las llamadas
Bird entrega cada llamada a un grupo de gateways. Todos los gateways están en All gateways (automatic), que los prueba en el orden de su Priority en la pestaña Gateways, empezando por el más bajo. Para la conmutación por error con este grupo, asigna al gateway de respaldo un número de Priority más alto que al principal. Si la pestaña Groups no muestra All gateways (automatic), el enrutamiento guardado del trunk contiene en su lugar un grupo propio, y Priority no ordena ese grupo; consulta Usar el grupo automático.
Cuando añades el primer gateway a un trunk cuyo enrutamiento nunca se ha guardado, el panel apunta la ruta predeterminada a All gateways (automatic).
Si quieres otros tiempos de timbrado, otros pesos o solo algunos de los gateways, crea tu propio grupo: en la pestaña Groups, selecciona Add group, ponle un nombre y usa Add gateway to group para cada gateway. En Conmutar por error y repartir las llamadas entrantes se explica cada orden, el tiempo de timbrado y cuándo se detiene la búsqueda.
5. Apunta la ruta predeterminada al grupo
En la pestaña Rules, busca Default route (No rule above matched). Establece Then en Route to group y elige tu grupo. Selecciona Review and save y luego confirma.
La ruta predeterminada atiende todas las llamadas que no coinciden con ninguna regla, así que, si no hay reglas, atiende todas las llamadas. Si está configurada en Reject, esas llamadas se rechazan antes de llegar a tu equipo, aunque haya gateways en un grupo.
En la revisión, el panel muestra la advertencia Calls never reach some gateways cuando una gateway no está en ningún grupo al que una regla o la ruta predeterminada envíe llamadas. Corrige esa advertencia antes de hacer pruebas.
Esta ruta predeterminada pertenece al trunk. Es distinta del ajuste del espacio de trabajo Calls to numbers without their own route de la página Numbers, que decide qué ocurre con los números que no tienen ruta propia.
6. Apunta tus números al trunk
Abre Voice > Numbers, abre el número y, en Inbound routing, elige Deliver to a SIP trunk. Selecciona el trunk y guarda.
Un número sin ruta propia sigue la ruta predeterminada del espacio de trabajo, que inicialmente rechaza las llamadas. Para enviar todos esos números a este trunk de una vez, establece Calls to numbers without their own route en el trunk. Consulta Configurar una ruta predeterminada.
Si omites este paso mientras la ruta predeterminada del espacio de trabajo sigue rechazando llamadas, las llamadas entrantes se rechazan y el campo Inbound route del registro de la llamada muestra Reject the leg.
7. Activa las llamadas salientes e indica quién puede enviarlas
En Outbound calling, selecciona Enable outbound. Aparece la sección Connection con el SIP domain del trunk. Bird identifica tu trunk por este dominio, así que cópialo completo.
Después, añade al menos una forma de reconocer tu equipo:
- Allowed IP addresses: las direcciones públicas desde las que tu equipo envía SIP. Si estás detrás de NAT, usa la dirección pública del router.
- Allowed API keys: para equipos que responden a un desafío Digest, con el nombre de usuario
birdy el secreto de una clave de API como contraseña.
Mientras las llamadas salientes no estén activadas, el trunk rechaza todas las llamadas salientes. Mientras el trunk no pueda reconocer tu equipo, las llamadas se rechazan antes de que exista un registro de llamada. Consulta Controlar quién puede enviar llamadas.
8. Configura tu PBX o SBC
En tu PBX o SBC:
- Envía las llamadas salientes al dominio SIP del trunk. Pon el dominio SIP como host de la Request-URI. Usa el puerto
5060(UDP o TCP) o5061(TLS). Se rechaza cualquier llamada cuyo host de la Request-URI sea otro nombre. - Marca en formato internacional. Pon el número llamado en la parte de usuario de la Request-URI con
+y el código de país, por ejemplo+442071234567. No añadas un prefijo técnico. Consulta Qué espera Bird en el INVITE. - Presenta un identificador de llamada válido en la cabecera
From. - Ofrece G.711 (ley A o ley µ) y envía los DTMF como eventos telefónicos RFC 4733. La misma sección de esa página trata el audio.
- Permite las direcciones de Bird. Si tu firewall o SBC solo acepta direcciones de una lista, permite las direcciones de señalización y de audio de la región de tu trunk, que se indican en Requisitos de red de los trunks SIP.
9. Activa los países a los que llamas
Abre Voice > Destinations, marca cada país al que llamas y selecciona Save changes. Un espacio de trabajo nuevo empieza sin ningún país habilitado, y una llamada a un país deshabilitado se rechaza con destination_not_enabled. Consulta Destinos de voz.
10. Prueba ambas direcciones
- Entrantes: llama a tu número de Bird desde un teléfono normal y, después, abre Voice > Legs en el mismo espacio de trabajo.
- Salientes: haz una llamada desde tu equipo a cualquier número accesible de un país habilitado, presentando como identificador de llamada tu número de Bird o un número verificado. No necesitas un segundo número de Bird para esto.
- Abre cada tramo. Inbound route indica qué estaba configurado para hacer el número. Una llamada rechazada muestra su motivo y, cuando la solución es un ajuste tuyo, un enlace a ese ajuste. Una llamada que funcionó muestra Answered. Guarda el Leg ID si contactas con soporte.
Si falta una llamada, se rechaza o nunca llega a tu equipo, sigue la solución de problemas de voz, que parte del síntoma.
Próximos pasos
| Página | Qué trata |
|---|---|
| Troncales SIP | Todos los ajustes de la troncal, la autenticación y Digest |
| Recibir llamadas | Rutas de números, gateways, grupos y la ruta predeterminada del espacio de trabajo |
| Realizar llamadas | Qué espera Bird en el INVITE |
| Solución de problemas de voz | Cómo diagnosticar una llamada a partir de su síntoma |
Recursos relacionados
Continúa con la documentación, guías y ejemplos de este tema.