Descripción General

El enrutamiento por Troncal SIP URI permite que tu centralita Siptize se comunique directamente con el servidor de la IA sin pasar por la red telefónica pública (PSTN). Esto reduce costes, elimina latencia y permite funciones avanzadas como la transferencia de llamadas de vuelta a humanos mediante SIP REFER.

Esta guía documenta el estándar para conectar centralitas telefónicas (VPBX) Siptize con agentes de Inteligencia Artificial (ElevenLabs, Vapi, Retell AI, etc.) utilizando SIP URIs y Gateways.

Nota Importante: Algunos proveedores requieren configuraciones especiales. Por ejemplo, ElevenLabs requiere conexión TCP, mientras que Vapi/Retell AI funcionan con UDP estándar. Consulta la documentación específica de tu proveedor.

Arquitectura del Flujo de Llamada

Para que la centralita sepa "sacar" una llamada hacia la IA, seguimos este esquema de 4 pasos:

[CLIENTE MARCA NÚMERO PÚBLICO]
           ↓
[FLUJO DE ENTRADA / QUEUE / GRUPO / DIRECTO / ...]
           ↓
[EXTENSIÓN VIRTUAL - DESTINO EXTERNO]
           ↓
[RUTA DE SALIDA - PATRÓN DE MARCADO]
           ↓
[GATEWAY SIP - DOMINIO PROVEEDOR IA]
           ↓
[SERVIDOR IA - AGENTE INTELIGENTE]

Ciclo de comunicación:

1. Entrada: El cliente marca tu número público (ej. 966666666)
2. Puente: La llamada se envía internamente mediante un Flujo/Cola/Grupo a una Extensión Virtual (Destino Externo) (ej. Ext. 9999)
3. Flujo: Esa extensión tiene un desvío hacia un número externo único (E.164) que identifica al agente de IA (ej: +34966666666)
4. Salida al Gateway: Una Ruta de Salida detecta ese número y fuerza la llamada a través de un Gateway SIP que apunta a la URI del proveedor de IA

Paso 1: Configuración del Gateway SIP

Descripción Técnica

El Gateway SIP actúa como puente de comunicación entre la VPBX Siptize y el servidor del proveedor de IA. Su configuración define el dominio (realm) del proveedor, el tipo de conexión (registro o no) y los parámetros de autenticación.

Para integraciones de IA, se recomienda tipo "No Registrar" ya que la comunicación es unidireccional: la VPBX envía la llamada hacia el servidor de IA sin necesidad de registrarse contra él. El Gateway generará internamente la SIP URI final combinando el dominio del proveedor con el número identificador del agente (formato E.164).

Pasos de Configuración

1. Accede a Gateways en el menú de administración de Siptize
2. Haz clic en "Crear/editar gateway"
3. Completa los siguientes campos:

Resultado Esperado

Una vez guardado, el Gateway genera internamente una SIP URI con el formato:

sip:[NUMERO_AGENTE_E164]@[DOMINIO_PROVEEDOR]:[PUERTO];trasnport=[PROTOCOLO]

Ejemplo:

sip:+34966666666@sip.rtc.elevenlabs.io:5060;trasnport=tcp

Notas de Configuración

• No Registrar vs Registrar:

  • No Registrar (recomendado): El gateway no se autentica contra el servidor. Ideal para proveedores IA que funcionan sin registro previo.
  • Registrar: El gateway se autentica continuamente. Necesario solo si el proveedor lo requiere explícitamente.

• Protocolo SIP:

  • UDP (5060): Estándar para SIP. Recomendado para Vapi, Retell AI.
  • TCP (5060/5061): Más fiable en redes inestables. Requerido por ElevenLabs.

Paso 2: Definición de la Ruta de Salida

Descripción Técnica

La Ruta de Salida (Outbound Route) es la regla que detecta cuándo una llamada debe ser enviada hacia el Gateway configurado en el Paso 1. Actúa como selector de tráfico: cuando se marca un número que coincide con el patrón definido, la llamada es forzada automáticamente a salir por el Gateway especificado.

En el contexto de integraciones IA, el patrón típicamente es el número identificador del agente en formato E.164 (ej: +34966666666), aunque también puede configurarse como "Cualquiera" si se desea enviar todo el tráfico de esa extensión virtual hacia la IA sin restricción.

La ruta define también parámetros como conservar CallerID, horario de aplicación y el Gateway de destino.

Pasos de Configuración

1. Accede a Rutas de salida en el menú de administración
2. Haz clic en "Añadir" para crear una nueva ruta
3. Completa los siguientes campos:

Resultado Esperado

Una vez guardada, cualquier llamada que coincida con el patrón será enrutada automáticamente hacia el Gateway IA. La tabla de Rutas de Salida mostrará la nueva regla con su configuración asociada.

Notas Importantes

• Patrón de Marcado:

  • Si especificas un número (ej: +34966666666), solo las llamadas a ese número serán enrutadas por esta ruta.
  • Si dejas "Cualquiera", todo el tráfico de la extensión virtual será enviado hacia la IA.

• Conservar CID:

  • Activado: El número del cliente original se envía a la IA (recomendado para identificación).
  • Desactivado: El número que se envía es el del destino externo.

Paso 3: Configuración del Destino Externo

Descripción Técnica

El Destino Externo es la extensión virtual que actúa como punto de acceso interno en la VPBX para enrutar hacia el agente IA. Se compone de dos elementos clave:

1. Número de Extensión Interna (ej: 9999 o 4001) que será usado por los flujos de entrada para dirigir llamadas.
2. Número Externo (ej: +34966666666 en formato E.164) que identifica de forma única al agente IA en el proveedor.

Este número externo, combinado con el dominio del Gateway, genera la SIP URI final. El Destino Externo también vincula la Ruta de Salida creada en el Paso 2, asegurando que las llamadas a esta extensión virtual sean enviadas automáticamente hacia el Gateway correcto.

Parámetros adicionales como nombre descriptivo, rol y desvíos permiten customizar el comportamiento según necesidades (desvío por ocupado, sin respuesta, etc.).

Pasos de Configuración

1. Accede a Extensiones → Destinos Externos
2. Haz clic en "Crear/editar destino externo"
3. Completa los siguientes campos:

Resultado Esperado

Una vez guardado, el Destino Externo estará disponible en la lista de extensiones y podrá ser utilizado como destino en Flujos de Entrada, Colas, etc.

SIP URI Generada Internamente:

sip:+34966666666@sip.rtc.elevenlabs.io:5060;trasnport=tcp

Esta URI es construida automáticamente por Siptize usando:

• Número Externo del Destino Externo
• Dominio (Realm) del Gateway
• Protocolo especificado (TCP/UDP)

Notas Importantes

• Número Externo en formato E.164:

  • Incluir el prefijo de país (+34 para España)
  • Sin espacios ni caracteres especiales
  • Recomendado usar el mismo formato que el proveedor IA espera

• Desvíos:

  • "Desvío si ocupado": Qué hacer si el agente está ocupado
  • "Desvío si no contesta": Qué hacer si la IA no responde en tiempo límite
  • Pueden redirigir a extensiones humanas, buzones de voz, colas, etc.

Paso 4: Integración en Flujo de Entrada

Descripción Técnica

El Flujo de Entrada es el mecanismo que recibe las llamadas del cliente (número público ej: 966666666) y las enruta hacia la extensión virtual del agente IA creada en el Paso 3.

Siptize permite usar Flujos, Colas, Grupos de Llamada u otros mecanismos de distribución. La secuencia es:

Llamada entra por número público (966666666)
         ↓
Procesada por el Flujo/Cola configurado
         ↓
Se transfiere a la extensión virtual (9999)
         ↓
Destino Externo desencadena la Ruta de Salida
         ↓
Gateway envía la llamada hacia el servidor IA (SIP URI)
         ↓
IA responde y comienza el prompt/conversación

Este paso cierra el ciclo de entrada/puente/salida. Parámetros configurables incluyen: timbre de entrada, horarios, locuciones, transferencia condicional (ocupado/sin respuesta), y opciones de grabación.

Pasos de Configuración

1. Accede a Flujos de llamada entrantes o Grupos de llamada
2. Selecciona o crea el flujo que manejará el número público
3. Configura la secuencia:

Estructura Típica en Flujo

Entrada (966666666)
    ↓
[Locución Fiesta] ← Saludo inicial (opcional)
    ↓
[Horario Laboral] ← Verificar si es horario laboral
    ↓ SÍ (Siempre)
[Destino Externo (4001) Agente AI-1] ← Enviar a IA
    ↓ NO / Ocupado
[Resto del Tiempo] ← Desvío a cola humana o extensión
    ↓
[Cola Soporte] ← Atender con agentes humanos

Resultado Esperado

Las llamadas entrantes al número público (966666666) serán automáticamente derivadas al Destino Externo del agente IA, generando la SIP URI hacia el proveedor.

Notas Importantes

• Flujos vs Colas:

  • Flujo (Flow): Control granular con reglas, condiciones, locuciones.
  • Cola (Queue): Distribución entre múltiples extensiones humanas.
  • Para IA, típicamente se usa Flujo con un único destino (la IA).

• Horarios:

  • Permitir que la IA atienda solo en horarios específicos.
  • Fuera de horarios, desviar a cola humana o buzón de voz.

• Grabación de Llamadas:

  • Considerar grabar las conversaciones IA-Cliente para análisis y cumplimiento normativo.

Configuración de Parámetros SIP

URI SIP Completa

La SIP URI final que se genera es el resultado de combinar información de los Pasos 1-3:

sip:[NUMERO_EXTERNO]@[DOMINIO_GATEWAY]:[PUERTO];trasnport=[PROTOCOLO]

Ejemplo desglosado:

URI Resultante:

sip:+34966666666@sip.rtc.elevenlabs.io:5060;transport=tcp

Encabezados SIP Críticos

• From: Número del cliente (para que la IA identifique quién llama)
• To: Número del agente IA (+34966666666)
• Via: Ruta de transporte (TCP/UDP)
• Contact: Dirección de respuesta de la centralita

Parámetros Recomendados

Ejemplos Prácticos por Proveedor

Escenario 1: ElevenLabs (Requiere TCP)

Características:

• Conexión obligatoria por TCP
• Requiere autenticación
• Soporta SIP REFER para transferencias

Configuración Gateway (Paso 1):

Nombre:           GW_ElevenLabs_IA
Tipo:             No registrar
Realm:            sip.rtc.elevenlabs.io
Puerto:           5060
Protocolo:        TCP
Usuario:          [Tu Cliente ID]
Contraseña:       [API Key de ElevenLabs]
CallerID Cabecera: Caller Id en cabecera From

Número Agente en ElevenLabs:

+34966666666

URI Final Generada:

sip:+34966666666@sip.rtc.elevenlabs.io:5060;transport=tcp

Pasos de Configuración Resumidos:

1. Crear Gateway GW_ElevenLabs_IA (TCP)
2. Crear Ruta de Salida → SALIDA_HACIA_IA (patrón: +34966666666)
3. Crear Destino Externo → 9999 / +34966666666 → Ruta SALIDA_HACIA_IA
4. Configurar Flujo de Entrada → Enviar a Destino Externo 9999

Escenario 2: Vapi (UDP Estándar)

Características:

• Conexión UDP estándar
• Requiere Client ID
• WebSocket para webhooks (transferencias, eventos)

Configuración Gateway (Paso 1):

Nombre:           GW_Vapi_IA
Tipo:             No registrar
Realm:            [CLIENT_ID].vapi.sip.ai
Puerto:           5060 (no requerida)
Protocolo:        UDP (no requerida)
Usuario:          NO-user
Contraseña:       (no requerida)
CallerID Cabecera: Caller Id en cabecera From

Ejemplo con Client ID real:

Nombre:           GW_Vapi_IA
Realm:            123456-789abc-def012.vapi.sip.ai

Número Agente en Vapi:

+34966666666

URI Final Generada:

sip:+34966666666@123456-789abc-def012.vapi.sip.ai

Pasos de Configuración Resumidos:

1. Crear Gateway GW_Vapi_IA (UDP con Client ID en Realm)
2. Crear Ruta de Salida → SALIDA_HACIA_IA_VAPI (patrón: +34966666666)
3. Crear Destino Externo → 9999 / +34966666666 → Ruta SALIDA_HACIA_IA_VAPI
4. Configurar Flujo de Entrada → Enviar a Destino Externo 9999

Escenario 3: Retell AI (UDP con Autenticación)

Características:

• Conexión UDP
• Requiere Client ID
• API REST para configuración

Configuración Gateway (Paso 1):

Nombre:           GW_Retell_IA
Tipo:             No registrar
Realm:            [CLIENT_ID].sip.retellai.com
Puerto:           5060 (no requerida)
Protocolo:        UDP (no requerida)
Usuario:          NO-user
Contraseña:       (no requerida)
CallerID Cabecera: Caller Id en cabecera From

Número Agente en Retell:

+34966666666

URI Final Generada:

sip:+34966666666@abc123def456.sip.retellai.com

Pasos de Configuración Resumidos:

1. Crear Gateway GW_Retell_IA (UDP con Client ID en Realm)
2. Crear Ruta de Salida → SALIDA_HACIA_IA_RETELL
3. Crear Destino Externo → 9999 / +34966666666
4. Configurar Flujo de Entrada → Enviar a Destino Externo 9999

Configuración del SIP REFER (IA a Humano)

Descripción General

El SIP REFER es un mecanismo que permite a la IA transferir la llamada hacia una extensión humana cuando sea necesario (ej: "espera, te paso con un agente"). Esto requiere configuración adicional en ambos lados.

Cómo Funciona

[CLIENTE] -- SIP INVITE --> [IA - VPBX]
   ↓
[IA ejecuta prompt y detecta: "transferir a extensión 103"]
   ↓
[IA envía SIP REFER] --> sip:103@cliente.centralita.vpbx.me
   ↓
[VPBX recibe REFER y conecta con extensión 103]
   ↓
[CLIENTE conecta con AGENTE HUMANO]
   ↓
[IA libera el canal]

Configuración en Siptize

1. Habilitar permisos en la centralita:

• Accede a Configuración → Editar panel de centrales
• Busca la opción: "PERMITIR LLAMADAS A EXTENSIONES"
• Actívala (checkmark)
• Guarda cambios

2. Configurar la extensión de destino humano:

Asegúrate de que la extensión a la que transfiere la IA (ej: 103) existe y está activa en la centralita.

3. Configurar el callback URI en el proveedor IA:

Cada proveedor requiere que configures en su panel la URI de callback: 

Si el transporte es UDP ó el puerto es el 5060 según el estandar no es necesario indicarlo

sip:[EXTENSION_DESTINO]@
[DOMINIO_CENTRALITA];[PUERTO];[TRANSPORT=TCP]

Ejemplos por proveedor [Asumiendo la extensión 100 como ejemplo]:

ElevenLabs:

sip:100@cliente.centralita.vpbx.me;7060;transport=tcp

Vapi:

Configurar en Dashboard → Transferring → SIP URI
sip:100@cliente.centralita.vpbx.me

Retell AI:

Configurar en API → Transfer Settings
sip:100@cliente.centralita.vpbx.me

Prueba de Funcionamiento

1. Realiza una llamada de prueba al número público
2. Solicita verbalmente la transferencia a un agente humano
3. La IA debe enviar un SIP REFER hacia la extensión humana
4. Verifica en los logs de Siptize que el REFER fue recibido (cdrs)
5. Comprueba que la llamada se conecta con el agente humano

Referencias

Documentación Oficial Siptize

• Portal de Soporte Siptize
• Documentación VPBX Siptize
• API y Webhooks

Documentación de Proveedores IA

ElevenLabs:

• SIP Integration Guide
• Requiere: TCP, API Key, Client ID

Vapi:

• SIP Configuration
• Requiere: Client ID, API Key

Retell AI:

• SIP Setup Documentation
• Requiere: Client ID, API Key

Notas Finales

Esta documentación cubre la configuración estándar de integración entre Siptize y agentes de IA. Cada proveedor puede tener requisitos específicos:

• ElevenLabs: Requiere TCP, API Key válida
• Vapi: Requiere Client ID, URL de callback para transferencias
• Retell AI: Requiere Client ID, configuración de webhooks
• Otros proveedores: Consultar su documentación específica de SIP

Importante: Consulta siempre la documentación técnica del proveedor IA seleccionado antes de la implementación, ya que algunos detalles pueden variar según actualizaciones de sus servicios.

Para soporte adicional, contacta con:

• Soporte Siptize: soporte@siptize.com
• Soporte del Proveedor IA:
  (según proveedor seleccionado)
  
  
  
  

  En Caso de Necesitar ayuda completa adicional con soporte de un técnico puede contratar con comercial@siptize.com y contratar el tiempo que necesite de soporte de pago con exclusividad del tiempo factura-ble.

Versión: 1.0
Última actualización: 2026/06