Saltar al contenido principal

SIP URI forwarding hacia Ocular

Cómo un carrier o un socio (un contact center, un proveedor de telefonía del cliente) entrega llamadas de su red a un agente de voz de Ocular por SIP, qué opciones existen, qué debe configurar cada parte y qué aprendimos del primer caso real: la integración de un socio en Estados Unidos a través de su carrier (Bandwidth), que reenvía la llamada de un número del cliente a Ocular por SIP sobre TLS.

Esta página no contiene direcciones IP, nombres de host, números ni credenciales reales. Los valores concretos de su integración se los entrega Customer Success por el canal seguro.

Opciones para entregar llamadas a Ocular​

OpciónCómo funcionaCuándo convieneTrabajo del socioTrabajo de Ocular
A. SIP URI forwarding (TLS + SRTP)El socio configura en su carrier un reenvío del número hacia un URI SIP de Ocular: sip:<DID>@sip.<entorno>.getocular.ai:5061;transport=tls. El carrier abre la llamada directamente contra el borde SIP de Ocular.Socio con carrier moderno (Bandwidth, Twilio, Telnyx…) que exige cifrado y resolución por DNS. Es el caso implementado.Crear la "Location"/destino SIP con el FQDN, puerto 5061 y TLS; entregar la lista de IPs de señalización y de media de su carrier; probar.Nombre de dominio público, certificado de autoridad pública, perfil SIP cifrado dedicado, autorización de las direcciones del carrier, alta del número.
B. SIP trunk plano (UDP/TCP 5060) a IPIgual que A, pero sin TLS y contra la IP pública del borde.Carriers que no soportan TLS o entornos de laboratorio. Es como operan algunos trunks tradicionales (registro con credenciales).Destino IP:5060, IPs de origen.Autorización de las direcciones del carrier; sin certificado.
C. Reenvío PSTN a un DID de OcularEl socio desvía su número (call forwarding en su carrier o en su PBX) a un número que Ocular ya tiene en su propio carrier.Cuando el socio no quiere o no puede tocar SIP. Es lo más rápido para una prueba.Un desvío de llamada.Nada nuevo si el DID ya existe; el llamante llega con el ANI original solo si el carrier del socio lo preserva.
D. Ocular se registra como extensión del PBX del socioEl borde de Ocular se registra (REGISTER) en el PBX del socio y recibe llamadas como una extensión más.Clientes con PBX propio (Asterisk, 3CX, Teams Direct Routing vía SBC).Crear una extensión/trunk con credenciales.Registro desde el borde de Ocular; las credenciales se reciben por el canal seguro.

La opción A es la recomendada para producción: cifrado extremo a extremo de la señalización y el audio, resolución por DNS (permite cambiar de IP sin tocar al socio) y aislamiento por perfil SIP dedicado. El resto de la página se centra en ella; B y D reutilizan los mismos pasos sin la parte de TLS.

Qué pedir al socio antes de empezar​

El formulario completo para el cliente está en Insumos que necesitamos del cliente. Reunir esto por escrito evita la mayor parte de los ciclos de prueba y error:

  1. IPs de señalización SIP (origen de los INVITE) y rangos de media RTP (origen del audio), por sitio y por entorno. Si el carrier tiene "pares" de SBC o un rango distinto para TLS, pedir ambos. En el primer caso real las IPs de señalización reales no coincidían con el rango "confirmado" inicialmente por el carrier; la señalización salía de un par de SBC distinto.
  2. Transporte y puerto que usarán: UDP/TCP 5060 o TLS 5061. Y si la "Location" admite FQDN o solo IP.
  3. Requisitos de TLS: versión (TLS 1.2 es lo habitual), cifrados que ofrece su SBC, si envía SNI, si exige certificado de CA pública, si verifica el nombre contra el FQDN.
  4. SRTP: obligatorio, opcional o no soportado, y el perfil (AES_CM_128_HMAC_SHA1_80).
  5. Códecs: G.711 µ-law (PCMU) para Norteamérica, G.711 a-law (PCMA) para Latinoamérica y Europa. G.729 solo si hay licencia en ambos lados.
  6. Formato del número marcado en el Request-URI y en To: E.164 con +, NANP de 10 u 11 dígitos, nacional. Ocular normaliza en el borde, pero hay que saber qué llega.
  7. Identidad del llamante (ANI): en From, P-Asserted-Identity o Remote-Party-ID. Es lo que el agente recibe como caller_e164.
  8. DTMF: RFC 2833/4733 (telephone-event) es el esperado.
  9. Keepalives: OPTIONS cada N segundos, o keepalive TLS. Hay que contarlos aparte en el monitoreo.
  10. Failover: si configuran un destino secundario, debe existir algo detrás o el failover enmascara errores con timeouts.
  11. Horario y contacto para pruebas conjuntas, y evidencia que pueden entregar de cada intento (Call-ID, código SIP, destino resuelto).

Qué hace Ocular con esa información​

Con la ficha del carrier, Ocular prepara su lado en unos pocos pasos y le devuelve, por el canal seguro, el URI SIP de destino y las direcciones que su carrier debe autorizar:

  1. Red y control de origen. Solo se aceptan llamadas desde las direcciones de señalización y de media declaradas por su carrier. Un origen no declarado se descarta sin respuesta, por eso la lista debe ser completa.
  2. Perfil SIP dedicado para su carrier, aislado del resto de los carriers: un cambio o una prueba suya no afecta a otros clientes, y viceversa.
  3. Certificado TLS de autoridad pública sobre un nombre de dominio de Ocular, compatible con los equipos de los carriers habituales (incluidos los que solo negocian cifrados RSA o no envían SNI).
  4. Normalización del número marcado al formato internacional, según lo que entregue su carrier.
  5. Alta del número con su agente, horario de atención, mensaje fuera de horario y política de desborde.
  6. Monitoreo y evidencia: captura de señalización para su carrier y verificación automática del estado del perfil y del certificado, antes y después de cada cambio.
  7. Prueba conjunta con su equipo y su carrier en línea, siguiendo el guion y el criterio de aceptación acordados.

Dónde puede detenerse una llamada (para diagnosticar juntos)​

Red de Ocular ──► Control de origen ──► Negociación TLS ──► Formato del número ──► Número habilitado,
(IP/puerto) (IPs del carrier) (certificado) (E.164) horario, agente

Cada capa deja una huella distinta. Cuando una prueba falla, la pregunta a su carrier es siempre la misma: a qué destino resolvió, por qué transporte envió la llamada y qué respuesta recibió (Call-ID y código SIP). Con eso Ocular ubica la capa en minutos.

Lo que aprendimos en la primera integración​

  1. Pedir a su carrier las direcciones reales de señalización, no solo el rango "oficial". En el primer caso las llamadas salían de un par de equipos que no estaba en la lista inicial.
  2. Confirmar transporte y puerto en el destino configurado en su carrier: debe apuntar al nombre de dominio y al puerto TLS que entrega Ocular, no a una IP ni al puerto sin cifrar, o la negociación se hace contra el perfil equivocado.
  3. Preguntar por los cifrados TLS que ofrece su carrier. Algunos equipos solo negocian certificados RSA y no envían el nombre del servidor; Ocular ya lo contempla, pero saberlo de antemano ahorra una ronda de pruebas.
  4. Un destino de respaldo sin nada detrás convierte los errores en silencios difíciles de diagnosticar. Si configura uno, que exista.
  5. Acordar la evidencia antes de probar: hora, Call-ID y código SIP de cada intento, de ambos lados.

Lista de verificación​

Del cliente:

  • Formulario de insumos enviado a Customer Success.
  • Destino SIP configurado en su carrier con el nombre de dominio, el puerto y el transporte que entregó Ocular.
  • Direcciones de Ocular autorizadas en su carrier, si este las exige.
  • Números de prueba y ventana de prueba confirmados.

De Ocular:

  • Origen autorizado, perfil SIP, certificado y normalización de número listos.
  • Número dado de alta con agente, horario y desborde.
  • Captura de señalización y verificación automática activas.
  • Llamada de prueba realizada con evidencia compartida.