--- title: "Configura un trunk SIP para recibir y realizar llamadas" description: "Conecta tu PBX o SBC a Bird en este orden: crea el trunk, entrega las llamadas entrantes a tus gateways, habilita las llamadas salientes y prueba ambas direcciones." canonical: "https://bird.com/es-es/documentacion/guides/voice/sip-trunk-setup" --- # 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](/docs/guides/voice/sip-trunks), [Recibir llamadas](/docs/guides/voice/receiving-calls) y [Realizar llamadas](/docs/guides/voice/placing-calls). ## 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](/docs/guides/voice/caller-ids). - Un número de Bird cuyo `status` sea `active`. 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](/docs/guides/numbers/ownership-paperwork). ## 1. Crea el trunk Abre **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/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](/docs/guides/voice/receiving-calls#what-a-gateway-needs) 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](/docs/guides/voice/hunt-groups#use-the-automatic-group). 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](/docs/guides/voice/hunt-groups) 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**](https://bird.com/dashboard/w/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](/docs/guides/voice/receiving-calls#set-a-default-route). 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 `bird` y 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](/docs/guides/voice/sip-trunks#controlling-who-may-send-calls). ## 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) o `5061` (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](/docs/guides/voice/placing-calls#what-bird-expects-on-the-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](/docs/guides/voice/network-requirements). ## 9. Activa los países a los que llamas Abre **Voice** > [**Destinations**](https://bird.com/dashboard/w/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](/docs/guides/voice/destinations). ## 10. Prueba ambas direcciones 1. **Entrantes:** llama a tu número de Bird desde un teléfono normal y, después, abre **Voice** > [**Legs**](https://bird.com/dashboard/w/voice/legs) en el mismo espacio de trabajo. 2. **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. 3. 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](/docs/guides/voice/troubleshooting), que parte del síntoma. ## Próximos pasos | Página | Qué trata | | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- | | [Troncales SIP](/docs/guides/voice/sip-trunks) | Todos los ajustes de la troncal, la autenticación y Digest | | [Recibir llamadas](/docs/guides/voice/receiving-calls) | Rutas de números, gateways, grupos y la ruta predeterminada del espacio de trabajo | | [Realizar llamadas](/docs/guides/voice/placing-calls) | Qué espera Bird en el `INVITE` | | [Solución de problemas de voz](/docs/guides/voice/troubleshooting) | Cómo diagnosticar una llamada a partir de su síntoma | ## Related resources - [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer) - [Voice](/voice-api) (product) - [Voice overview](/docs/guides/voice/overview) (docs) [Get an implementation brief](/learn/workspace?topic=voice)