--- title: "Conmutación por error y reparto de llamadas entrantes entre tus gateways" description: "Usa grupos de búsqueda en un trunk SIP para enviar las llamadas entrantes a un gateway de respaldo cuando falla el primero, o para repartir las llamadas entre gateways según su peso." canonical: "https://bird.com/es-es/documentacion/guides/voice/hunt-groups" --- # Conmutación por error y reparto de llamadas entrantes entre tus gateways El enrutamiento de un trunk SIP decide qué ocurre con cada llamada entrante: recorrer un grupo de tus gateways, rechazar la llamada o desviarla a un número verificado. Un grupo de búsqueda es una lista de gateways que Bird prueba uno tras otro hasta que uno responde. El orden, las prioridades, los pesos y los tiempos de timbre del grupo deciden qué gateway suena primero y qué ocurre si no responde. Esta página muestra cómo configurarlos para la conmutación por error y para el reparto de carga. ## Antes de empezar - Un trunk SIP con las llamadas entrantes activadas y al menos un gateway. [Configurar un trunk SIP](/docs/guides/voice/sip-trunk-setup) explica ambas cosas. Cuando añades el primer gateway a un trunk cuyo enrutamiento nunca se ha guardado, el panel dirige la ruta predeterminada a **All gateways (automatic)**, el grupo que contiene todos los gateways del trunk. - Los gateways que quieres combinar, añadidos en la pestaña **Inbound routing** > **Gateways** del trunk. ## Cómo recorre un grupo sus gateways Cada llamada entrante inicia una búsqueda. Bird ordena los gateways del grupo para esa llamada, hace sonar el primero y pasa al siguiente cuando falla: - Un gateway suena durante su **Ring time**, de 1 a 120 segundos (30 de forma predeterminada). Si nadie responde en ese tiempo, Bird pasa al siguiente. - Un gateway que no envía ninguna respuesta se omite tras un breve intervalo, para que un gateway caído no retenga a la persona que llama durante todo su tiempo de timbre. - Si un gateway rechaza la llamada con un código de error SIP, la búsqueda pasa al siguiente gateway, salvo que ese código figure en **Stop the hunt on** del grupo. - La búsqueda termina cuando un gateway responde o cuando se han probado todos los gateways del grupo. Bird ordena cada llamada por separado y no mantiene ninguna rotación entre llamadas, así que no hay round-robin. El reparto uniforme se obtiene con el orden aleatorio o ponderado a lo largo de muchas llamadas. | Orden | Cómo ordena los gateways en cada llamada | Para qué usarlo | | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- | | **Sequential** | El orden de la lista, de arriba abajo | Un gateway principal fijo y gateways de respaldo | | **Random** | Un orden aleatorio nuevo | Repartir las llamadas de forma uniforme | | **Weighted** | Primero la **Priority** más baja. Dentro de una misma prioridad, un orden aleatorio en el que la probabilidad de cada gateway de ir primero es su parte del total de pesos | Conmutación por error y reparto ponderado a la vez | ## Usar el grupo automático Todos los gateways de un trunk están en **All gateways (automatic)**, salvo que el enrutamiento guardado del trunk tenga un grupo propio en su lugar (consulta el final de esta sección), y cada gateway que añades o eliminas entra en él o sale de él. Usa el orden **Weighted**, pesos iguales y un tiempo de timbre de 30 segundos, y prueba los gateways según la **Priority** que estableces en la pestaña **Gateways**. En el propio grupo no se pueden editar su nombre, **Order**, los tiempos de timbre ni los miembros. Para la conmutación por error con este grupo, asigna al gateway principal una **Priority** más baja que al de respaldo en la pestaña **Gateways**. Los gateways con la misma **Priority** se reparten las llamadas de forma uniforme. Si quieres otros tiempos de timbre, pesos o códigos en **Stop the hunt on**, añade un grupo propio con los mismos gateways, como muestran las secciones siguientes. Un grupo llamado **All gateways** que el panel creó al añadir tu primer gateway es un grupo propio: solo contiene los gateways con los que se guardó. Si la pestaña **Groups** no muestra **All gateways (automatic)**, el enrutamiento guardado del trunk tiene un grupo propio en el lugar de ese grupo, normalmente llamado **All gateways**. Si lo eliminas, el grupo automático vuelve a ocupar su lugar: las llamadas que iban a él hacen sonar entonces todos los gateways, en orden de **Priority** y con un tiempo de timbre de 30 segundos. Consérvalo si contiene los gateways, los tiempos de timbre o los códigos de **Stop the hunt on** que quieres. ## Configurar la conmutación por error 1. Abre **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/voice/sip-trunks), abre el trunk y ve a **Inbound routing** > **Groups**. 2. Abre un grupo propio o selecciona **Add group** y ponle un nombre. **All gateways (automatic)** no se puede editar. 3. Añade tu gateway principal y tu gateway de respaldo con **Add gateway to group**. 4. Establece **Order** en **Sequential** y mantén el gateway principal arriba con **Move up** y **Move down**. También puedes establecer **Order** en **Weighted** y asignar al principal **Priority** 1 y al de respaldo **Priority** 2. 5. Configura el **Ring time** de cada gateway. Con un tiempo de timbrado más corto en el principal, las llamadas sin respuesta pasan antes al de respaldo. 6. En la pestaña **Rules**, establece **Then** de la **Default route** en **Route to group** y elige el grupo, o haz que una regla apunte a él. Un grupo que no usa ninguna ruta no recibe llamadas. 7. Selecciona **Review and save** y confirma. ## Repartir llamadas entre gateways 1. Abre **Inbound routing** > **Groups** del trunk. Abre un grupo propio o selecciona **Add group**, ponle un nombre y añade los gateways con **Add gateway to group**. 2. Establece **Order** en **Weighted**, asigna a los gateways la misma **Priority** y fija el **Weight** de cada uno entre 1 y 100. Con pesos de 70 y 30, cada gateway recibe aproximadamente el 70 % y el 30 % de las llamadas. Para un reparto equitativo, usa pesos iguales o establece **Order** en **Random**. 3. Para mantener también un respaldo, asigna **Priority** 1 a las pasarelas que comparten llamadas y **Priority** 2 a la de respaldo. La pasarela de respaldo solo suena cuando han fallado todas las pasarelas de prioridad 1. 4. En la pestaña **Rules**, establece **Then** de la **Default route** en **Route to group** y elige el grupo, o haz que una regla apunte a él. 5. Selecciona **Review and save** y confirma. ## Detener la búsqueda ante una señal de ocupado Bird prueba la siguiente pasarela ante cualquier fallo, salvo que cambies este comportamiento. Cuando un fallo indica que otra pasarela no va a ayudar, añade su código en **Stop the hunt on** del grupo. Por ejemplo, añade `486` (Busy Here) para que a una persona que ya está en una llamada no se la vuelva a llamar a través de una segunda pasarela. Puedes introducir cualquier código entre 400 y 699. ## Enviar distintas llamadas a distintos grupos Un trunk puede tener varios grupos. La **Default route** envía a un grupo las llamadas que no coinciden con ninguna regla, y las reglas de la pestaña **Rules** pueden enviar otras llamadas a otros grupos. En [Entregar llamadas a un trunk SIP](/docs/guides/voice/receiving-calls#deliver-calls-to-a-sip-trunk) se explican las reglas y la ruta predeterminada. ## Solución de problemas | Lo que ves | Qué comprobar | | ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | La pasarela de respaldo nunca suena | Comprueba que la pasarela de respaldo está en el grupo que usa la ruta predeterminada (o la regla que coincide). Con **Weighted**, su número de **Priority** debe ser mayor que el de la principal. Un código en **Stop the hunt on** puede terminar la búsqueda antes de llegar al respaldo | | Una sola pasarela recibe todas las llamadas con **Weighted** | Las pasarelas con prioridades distintas no se reparten las llamadas. Asígnales la misma **Priority** | | Las llamadas suenan demasiado tiempo antes de llegar a la pasarela de respaldo | Reduce el **Ring time** de la pasarela principal | | Una pasarela nunca suena | No está en ningún grupo que use una regla o la ruta predeterminada. Al guardar, el panel muestra la advertencia **Calls never reach some gateways** | ## Próximos pasos | Página | Qué explica | | ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- | | [Configurar un troncal SIP](/docs/guides/voice/sip-trunk-setup) | La configuración completa de un troncal paso a paso, desde su creación hasta una llamada de prueba | | [Recibir llamadas](/docs/guides/voice/receiving-calls) | Rutas de números, reglas, la ruta predeterminada y las llamadas rechazadas | | [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)