¿Qué es Ultravox?

Ultravox es una plataforma de infraestructura para agentes de voz con IA enfocada a gente técnica.

La diferencia técnica clave

Sistemas tradicionales (en cascada):

• Audio → ASR (convierte a texto) → LLM (procesa texto) → TTS → Audio.
• Problema: Se pierde información de tono, emoción y pausas al convertir a texto.
• Latencia: 1.5-2 segundos acumulados.

Modelo de Ultravox:

• Audio → LLM Multimodal → Texto → TTS → Audio.
• Elimina el ASR: El LLM procesa embeddings de audio directamente.
• Latencia: 500-800ms.

Ventajas

• Entiende tono, emoción y pausas del audio original.
• Latencia baja: 500-800ms vs 1.5-2s tradicional.
• Mejor manejo con ruido y múltiples hablantes.
• Infraestructura optimizada para tiempo real.

Limitaciones importantes

• No es speech-to-speech puro: La salida sigue siendo texto que va a TTS.
• Voz mono-emocional en la salida.
• Ruido extremo sigue siendo un desafío.
• Requiere infraestructura completa de Ultravox.

Imagen creada por Sonia IA

Funcionalidades disponibles: Consola web de Ultravox

Constructor de agentes (Agent Builder)

Crea y edita agentes visualmente usando herramientas como Blocky para definir personalidad y comportamiento básico.

Pruebas de agentes (Playground)

Realiza llamadas ilimitadas de prueba mediante el botón “Test Agent” para verificar prompts y voces sin coste adicional.

Explorador de voces

• Descubre voces integradas.
• Realiza clonado de voces subiendo muestras de audio (30-60 segundos).

Gestión de herramientas duraderas (Persistent Tools)

Crea, edita y prueba herramientas que pueden ser reutilizadas por múltiples agentes.

Gestión de RAG (Corpora)

Crea bases de conocimiento:

• Subiendo archivos (PDF, Word, TXT).
• Configurando rastreo de sitios web.

Historial y monitoreo

• Ver detalles de llamadas pasadas.
• Transcripciones completas.
• Resúmenes y métricas de uso.
• Monitorear llamadas en vivo.

Administración de cuenta

• Generar y gestionar API Keys.
• Configurar claves de proveedores externos de TTS.
• Revisar facturación.

Webhooks

Configura URLs para recibir notificaciones en tiempo real sobre eventos de llamadas:

• call.started.
• call.ended.
• Otros eventos del ciclo de vida de llamadas.

 Funcionalidades que requieren API o SDK

Ultravox es una plataforma “API-first“.

Las siguientes funcionalidades requieren código:

Despliegue en producción

Integrar al agente de voz en aplicaciones web, móviles o nativas requiere SDKs:

• JavaScript
• Python
• Swift
• Kotlin

Herramientas temporales (Temporary Tools)

Definir herramientas “inline” que solo existen durante una llamada específica mediante la API.

Etapas de llamada (Call Stages)

Crear conversaciones dinámicas que cambian de contexto, voz o instrucciones a mitad de sesión.

Contexto dinámico (templateContext)

Pasar información específica del usuario en el momento de crear la llamada usando variables tipo {{customerName}}.

Llamadas directas

Configurar una llamada desde cero sin usar una plantilla de agente predefinida.

Programador de llamadas salientes

Gestión de lotes masivos de llamadas con control de concurrencia automático vía API.

Integración SIP avanzada

Creación de registros SIP y manejo de encabezados personalizados mediante API.

Inyección de mensajes en vivo

Enviar mensajes de texto o forzar respuestas del agente en una llamada activa mediante send_data_message.

Descarga de grabaciones

Obtener archivos de audio (blob) de llamadas mediante el endpoint de Call Recordings.

Filtros avanzados de datos

Buscar llamadas por metadatos específicos, rangos de fecha o duraciones mediante API.

 Requisitos para la integración de Ultravoz y netelip

En netelip:

1. Cuenta activa con acceso al panel de cliente.
2. Al menos un número virtual configurado.
3. Servicio de Línea SIP contratado (imprescindible y es un servicio que no tiene coste).

En Ultravox:

1. Cuenta activa en Ultravox.
2. API Key generada.
3. Agente creado y configurado (para llamadas entrantes).

Conocimientos técnicos necesarios

• Uso de terminal/línea de comandos.
• Comprensión básica de APIs REST.
• Ejecución de comandos cURL.
• Formato JSON básico.

Información necesaria

De netelip:

• Número virtual en formato +34XXXXXXXXX.
• Contraseña de Línea SIP.
• Proxy SIP: [colocar el servidor correcto que aparece en tu cuenta de cliente]
  • sip.netelip.com.
  • sip-eu.netelip.com.
  • sip-am.netelip.com.

De Ultravox:

• API Key.
• Agent ID (para llamadas entrantes).

Configuración de llamadas entrantes

Paso 1: Obtener información necesaria

• ✓ API Key de Ultravox.
• ✓ Agent ID del agente que responderá.
• ✓ Número de netelip en formato +34XXXXXXXXX.

Paso 2: Enlazar número con agente

Ejecuta en terminal:

bash

curl -X PATCH https://api.ultravox.ai/api/sip \

-H “X-API-Key: TU_API_KEY” \

-H “Content-Type: application/json” \

-d ‘{

  “allowAllAgents”: false,

  “allowedCidrRanges”: [

    “185.8.244.0/24”,

    “194.140.135.0/24”

  ],

  “allowedAgents”: [{

    “agentId”: “ID_DE_TU_AGENTE”,

    “toUserPattern”: “^\\+?34XXXXXXXXX$”

  }]

}’

Valores a sustituir

• TU_API_KEY: Tu API Key de Ultravox.
• ID_DE_TU_AGENTE: El Agent ID copiado de Ultravox.
• 34XXXXXXXXX: Tu número SIN el símbolo + (ejemplo: si es +34951223344, pon 34951223344).

Paso 3: Configurar servidor SIP en netelip

Al ejecutar el comando, Ultravox te responde con el servidor SIP asignado.

En tu panel de netelip:

1. Ve a configuración de tu número virtual.
2. Configura desvío SIP.
3. Introduce el servidor proporcionado por Ultravox.
4. Activa el desvío.

Verificación

Llama a tu número de netelip.

El agente de Ultravox debe responder automáticamente.

Configuración de llamadas salientes

Paso 1: Registrar número en Ultravox

Ejecuta en terminal:

bash

curl –request POST \

–url https://api.ultravox.ai/api/sip/registrations \

–header ‘Content-Type: application/json’ \

–header ‘X-API-Key: TU_API_KEY’ \

–data ‘{

  “username”: “+34XXXXXXXXX”,

  “password”: “TU_CONTRASEÑA_LINEASIP”,

  “proxy”: “sip.netelip.com”,

  “outboundProxy”: “sip.netelip.com”,

  “authUser”: “+34XXXXXXXXX”

}’

Valores a sustituir

• TU_API_KEY: Tu API Key de Ultravox
• +34XXXXXXXXX: Tu número CON el símbolo + (ejemplo: +34951223344)
• TU_CONTRASEÑA_LINEASIP: Contraseña del servicio de Línea SIP de netelip

Paso 2: Realizar llamada saliente

bash

curl -X POST “https://api.ultravox.ai/api/calls” \

-H “X-API-Key: TU_API_KEY” \

-H “Content-Type: application/json” \

-d ‘{

  “systemPrompt”: “Llamas para contarle una historia.”,

  “firstSpeakerSettings”: { “user”: {} },

  “medium”: {

    “sip”: {

      “outgoing”: {

        “to”: “sip:+34XXXXXXXXX@sip.netelip.com:5060;transport=udp”,

        “from”: “+34YYYYYYYYY”,

        “username”: “+34YYYYYYYYY”,

        “password”: “TU_CONTRASEÑA_LINEASIP”

      }

    }

  }

}’

Valores a sustituir

• TU_API_KEY: Tu API Key de Ultravox.
• +34XXXXXXXXX (en “to”): Número al que quieres llamar.
• +34YYYYYYYYY (en “from” y “username”): Tu número de netelip.
• TU_CONTRASEÑA_LINEASIP: Contraseña de Línea SIP.

Nota importante:

Este es un ejemplo básico sin agente asignado. Para usar un agente específico creado en la consola, consulta la documentación oficial de Ultravox para añadir el parámetro agentId.

 Solución a posibles problemas

Llamadas entrantes no funcionan

Verificar:

• Desvío SIP activado en netelip.
• Servidor SIP correcto en configuración de netelip.
• Patrón toUserPattern coincide exactamente con tu número.
• Agent ID existe y está activo

Llamadas salientes no funcionan

Verificar:

• Registro SIP completado correctamente.
• Credenciales de Línea SIP correctas.
• Formato del número exacto (+34XXXXXXXXX).
• Contraseña de Línea SIP válida.

Errores en comandos cURL

Verificar:

• API Key correcta y activa.
• Formato JSON válido (usa validador online).
• IDs de agente existen.
• Formato de número exacto.

Notas importantes

Sobre rangos IP

Los rangos CIDR configurados son los oficiales de netelip:

• 185.8.244.0/24
• 194.140.135.0/24

No los modifiques a menos que recibas instrucciones del equipo de netelip.

Sobre el servicio de Línea SIP

Es imprescindible contratar el servicio de Línea SIP en netelip para obtener las credenciales necesarias.

Sobre facturación

Los costes se facturan por separado:

• netelip: Según tu plan y consumo de llamadas.
• Ultravox: Según su plan de precios.

Consulta las tarifas actualizadas en cada plataforma.

Recursos y soporte

Documentación oficial

• Ultravox: https://docs.ultravox.ai
• netelip – Centro de ayuda: https://ayuda.netelip.com

Soporte técnico

Para cuestiones de netelip:

• Escribe un tickets desde tu panel privado de netelip.

Para cuestiones de Ultravox:

• Documentación: https://docs.ultravox.ai

Comunidad de Sonia IA

• Curso completo de como crear agentes de voz con IA con Ultravox: https://sl1nk.com/0ApCd