Proveedores SIP

Los proveedores SIP conectan tus números de teléfono a VOCALS. Se encargan del lado PSTN (red telefónica pública) de la llamada mientras VOCALS gestiona la conversación con IA.

VOCALS soporta dos tipos de conectividad SIP:

• Twilio -- SIP gestionado con WebSocket Media Streams (configuración más sencilla)
• SIP Genérico -- Cualquier proveedor de troncal SIP estándar (Netelip, Zadarma, Telnyx, etc.) a través de Asterisk

Elegir un Tipo de Proveedor

	Twilio	SIP Genérico
Complejidad de configuración	Baja (solo credenciales API)	Media (configuración de troncal SIP)
Proveedores soportados	Solo Twilio	Cualquier proveedor de troncal SIP
Llamadas entrantes	Sí	Sí
Llamadas salientes	Sí	Sí
Protocolo de audio	WebSocket Media Streams (mulaw)	AudioSocket a través de Asterisk (slin/alaw)
Coste	Precios de Twilio	Precios de tu proveedor SIP

Configurar Twilio

Requisitos Previos

• Una cuenta de Twilio con un número de teléfono
• Tu Account SID y Auth Token de Twilio

Pasos

1. Ve a Configuración > Proveedores SIP en el panel de control de VOCALS.
2. Haz clic en Añadir Proveedor SIP.
3. Selecciona Twilio como tipo.
4. Introduce tus credenciales:
   • Account SID -- Se encuentra en el panel de tu Consola de Twilio
   • Auth Token -- Se encuentra en el panel de tu Consola de Twilio
   • Phone Number -- Tu número de teléfono de Twilio en formato E.164 (ej., +34911234567)
5. Haz clic en Guardar.

Configuración de Twilio

Después de guardar en VOCALS, configura tu número de Twilio para enrutar las llamadas a VOCALS:

1. En la Consola de Twilio, ve a Phone Numbers > Manage > Active Numbers.
2. Haz clic en tu número.
3. En Voice Configuration, configura:
   • A call comes in: Webhook
   • URL: https://api.usevocals.com/twilio/voice?tenant_id={your_tenant_id} (reemplaza {your_tenant_id} con tu ID de tenant de VOCALS, que se encuentra en Configuración en el panel de control)
   • HTTP Method: POST
4. Haz clic en Save configuration.

Twilio ahora reenviará las llamadas entrantes a VOCALS a través de WebSocket Media Streams.

Configurar Netelip

Netelip es un proveedor de troncal SIP europeo con cobertura en España y Latinoamérica.

Requisitos Previos

• Una cuenta de Netelip con un DID (número de teléfono)
• Tus credenciales SIP del panel de control de Netelip

Pasos

1. Ve a Configuración > Proveedores SIP en el panel de control de VOCALS.
2. Haz clic en Añadir Proveedor SIP.
3. Selecciona Netelip como tipo. Esto pre-rellena el servidor SIP y el puerto, pero puedes cambiarlos si es necesario.
4. Rellena los detalles de conexión:
   • SIP Server -- Pre-rellenado como sip.netelip.com. Netelip también ofrece servidores regionales como sip-eu.netelip.com -- usa el que tu cuenta tenga configurado.
   • SIP Port -- Por defecto 5060.
   • Transport -- UDP (predeterminado para Netelip).
   • Username -- Tu nombre de usuario SIP de Netelip.
   • Password -- Tu contraseña SIP de Netelip.
5. Opcionalmente configura el filtrado de llamadas entrantes:
   • Allowed IPs -- Restringe qué direcciones IP pueden enviar llamadas a tu troncal. Déjalo vacío para permitir todas. Los servidores SIP de Netelip normalmente envían desde sus rangos de IP publicados.
6. Haz clic en Guardar.

Después de guardar, VOCALS registra tu troncal con el servidor SIP. Comprueba la insignia de estado de registro en la tarjeta del proveedor SIP:

• Verde (Registrado) -- La troncal está conectada y lista para llamadas.
• Rojo (No Registrado) -- El registro falló. Verifica tus credenciales y la dirección del servidor SIP.
• Amarillo (Desconocido) -- No se pudo determinar el estado. La troncal puede estar aún inicializándose.

Configuración del DID de Netelip

En tu panel de control de Netelip, configura tu DID para enrutar las llamadas a VOCALS:

1. Inicia sesión en tu cuenta de Netelip.
2. Ve a Números DID (o equivalente).
3. Establece el destino de tu número a la dirección IP de tu servidor VOCALS en el puerto 5060.
4. Asegúrate de que el códec esté configurado como G.711a (alaw) o G.711u (ulaw) -- VOCALS auto-detecta ambos.

Configurar un Proveedor SIP Genérico

Cualquier proveedor de troncal SIP que soporte registro SIP estándar puede usarse con VOCALS.

Requisitos Previos

• Una cuenta de troncal SIP con tu proveedor
• Dirección del servidor SIP, puerto y credenciales
• Un DID (número de teléfono) de tu proveedor

Pasos

1. Ve a Configuración > Proveedores SIP en el panel de control de VOCALS.
2. Haz clic en Añadir Proveedor SIP.
3. Selecciona SIP Genérico como tipo.
4. Rellena los detalles de conexión:
   • SIP Server -- El hostname o IP del servidor SIP de tu proveedor (ej., sip.provider.com).
   • SIP Port -- Normalmente 5060 para UDP/TCP o 5061 para TLS.
   • Transport -- UDP, TCP o TLS según tu proveedor.
   • Username -- Tu nombre de usuario de autenticación SIP.
   • Password -- Tu contraseña de autenticación SIP.
5. Opcionalmente configura el filtrado de llamadas entrantes:
   • Allowed IPs -- Lista blanca de IPs del servidor SIP de tu proveedor para prevenir inyección de llamadas no autorizadas.
   • Media Encryption -- Configúralo según los requisitos de tu proveedor (none, sdes o dtls).
6. Haz clic en Guardar.

Proveedores SIP Comunes

Estos proveedores se sabe que funcionan con VOCALS. La configuración es similar entre proveedores -- solo difieren la dirección del servidor SIP y las credenciales.

Proveedor	Servidor SIP	Puerto Predeterminado	Transporte	Notas
Netelip	sip.netelip.com	5060	UDP	Cobertura España/LATAM. También sip-eu.netelip.com.
Zadarma	sip.zadarma.com	5060	UDP	Cobertura global, precios competitivos.
Telnyx	sip.telnyx.com	5060	UDP/TLS	Global, orientado a desarrolladores.
VoIP.ms	atlanta.voip.ms	5060	UDP	Norteamérica, múltiples ubicaciones de servidor.
OVH	sip.ovh.net	5060	UDP	Europa, incluido con hosting OVH.

tip

Al configurar un nuevo proveedor SIP, comienza realizando una llamada de prueba saliente para verificar la calidad de audio y latencia antes de configurar el enrutamiento entrante.

Cómo Funcionan las Llamadas SIP en VOCALS

Para proveedores que no son Twilio, VOCALS usa Asterisk como gateway SIP:

Tu Proveedor SIP (PSTN)
        |
   Troncal SIP (registro + llamadas)
        |
   Asterisk (gateway SIP)
        |
   AudioSocket (protocolo de audio binario)
        |
   Servicio Bridge (conversión de códec)
        |
   WebSocket al backend de VOCALS
        |
   Pipeline STT -> LLM -> TTS

1. Asterisk se registra con tu proveedor SIP y gestiona la señalización SIP.
2. Cuando llega una llamada (o se inicia una), Asterisk abre una conexión AudioSocket al servicio bridge.
3. El bridge convierte entre el formato de audio de Asterisk (alaw/ulaw/slin) y el protocolo WebSocket del backend de VOCALS.
4. El backend ejecuta la llamada a través del mismo pipeline STT -> LLM -> TTS usado para las llamadas de Twilio.

Esta arquitectura significa que todos los proveedores -- Twilio y SIP genérico -- comparten el mismo pipeline de IA. La única diferencia es la capa de transporte de telefonía.

Llamadas Salientes

Tanto Twilio como los proveedores SIP genéricos soportan llamadas salientes:

1. Ve a Llamadas en el panel de control, o usa la API POST /api/v1/calls.
2. Selecciona el agente y el número de teléfono desde el que llamar.
3. Introduce el número de destino.
4. Haz clic en Llamar.

Para proveedores SIP genéricos, las llamadas salientes se enrutan a través de Asterisk. El identificador de llamada se establece como el número de teléfono asignado al agente que realiza la llamada.

Detección de Contestador Automático (AMD)

Para llamadas salientes a través de SIP genérico, VOCALS incluye detección de contestador automático:

• Asterisk analiza los primeros segundos de audio para determinar si respondió un humano o una máquina.
• Si se detecta una máquina (saludo de buzón de voz), la llamada se cuelga automáticamente.
• Si se detecta un humano (o el resultado es inconcluso), la llamada continúa normalmente.
• Como alternativa, el LLM también monitorea patrones de buzón de voz durante la conversación.

AMD es automático para llamadas salientes -- no se necesita configuración adicional.

Estado de Registro

Después de configurar un proveedor SIP genérico, el panel de control muestra el estado de registro de la troncal:

• Registrado -- La troncal está conectada a tu proveedor SIP y lista para llamadas.
• No Registrado -- El registro falló. Causas comunes:
  • Dirección o puerto del servidor SIP incorrectos
  • Nombre de usuario o contraseña incorrectos
  • Firewall bloqueando el tráfico SIP (puerto 5060)
  • Cuenta del proveedor suspendida
• Desconocido -- No se pudo determinar el estado.

El estado de registro se actualiza automáticamente. Después de guardar o editar un proveedor SIP, permite 10-30 segundos para que la troncal se registre.

Solución de Problemas

El Registro Falla

1. Verifica las credenciales: Comprueba que tu nombre de usuario y contraseña SIP coincidan con el panel de control de tu proveedor.
2. Verifica la dirección del servidor: Asegúrate de que el hostname del servidor SIP resuelva correctamente. Prueba con la dirección IP directamente si sospechas de DNS.
3. Verifica el puerto y transporte: La mayoría de proveedores usan UDP en el puerto 5060. Algunos requieren TCP o TLS en el puerto 5061.
4. Verifica el firewall: Tu servidor debe permitir tráfico saliente en el puerto SIP y puertos UDP 10000-10100 (media RTP).

Sin Audio (Llamadas Unidireccionales o Silenciosas)

1. Verifica los puertos RTP: Asegúrate de que los puertos UDP 10000-10100 estén abiertos en el firewall de tu servidor para el tráfico de media.
2. Verifica NAT: Si tu servidor está detrás de NAT, asegúrate de que la IP pública esté correctamente configurada. VOCALS la auto-detecta desde la variable de entorno EXTERNAL_IP.
3. Verifica el códec: VOCALS soporta G.711a (alaw), G.711u (ulaw) y signed linear (slin). La mayoría de proveedores usan G.711a por defecto en Europa y G.711u en Norteamérica.

Las Llamadas Conectan pero el Agente No Responde

1. Verifica la asignación del agente: Asegúrate de que un número de teléfono esté asignado al agente y que el DID coincida.
2. Verifica los proveedores: Comprueba que el agente tenga proveedores STT, LLM y TTS válidos configurados con API keys funcionales.
3. Verifica los registros de llamadas: El panel de control muestra registros detallados de cada llamada, incluyendo cualquier error de proveedor.

Eco o Retroalimentación

1. Verifica el jitter buffer: VOCALS aplica un jitter buffer adaptativo automáticamente. Si el eco persiste, puede ser del lado del proveedor SIP.
2. Reduce el volumen TTS: Algunos proveedores TTS producen audio a alto volumen que puede causar eco en el lado PSTN. Reduce la ganancia si tu proveedor lo soporta.