Saltar al contenido principal

SIP REFER de vuelta a PSTN (y alternativas)

Cómo sacar una llamada de Ocular y dejarla en un destino de la red telefónica pública: un asesor humano, una sucursal, un número del propio cliente. Esta página describe el estado actual, las opciones técnicas (SIP REFER ciego, REFER atendido, puente en Ocular, redirección 302), qué exige cada una del carrier y cómo elegir.

Sin IPs, hosts, números ni credenciales reales. Los destinos de transferencia nunca los escribe el modelo: se resuelven en el servidor desde una lista configurada por proyecto.

Estado actual​

Hoy Ocular no ejecuta SIP REFER. Lo que existe es la transferencia de consulta (ver Flujo de una llamada): el agente pide consultar un destino, el motor abre una segunda llamada con un agente enlace, el cliente espera con música en la llamada original y el resultado vuelve al agente. La llamada del cliente queda siempre anclada en Ocular.

El traspaso real, es decir conectar al cliente con el destino y que Ocular deje de estar en medio, está diseñado (contrato del orquestador v1.1, modos blind y attended, lista blanca de destinos por tenant y DID, política de fallo) pero no está construido. Esta página recoge ese diseño y las alternativas para decidir con el carrier.

Las opciones​

1. REFER ciego (blind transfer)​

Ocular envía al carrier, dentro del diálogo de la llamada, un REFER con Refer-To: sip:<destino E.164>@<carrier>. El carrier responde 202 Accepted, origina la nueva pata hacia el destino, informa el progreso con NOTIFY (100, 180, 200) y, cuando el destino contesta, la pata de Ocular recibe BYE. El audio deja de pasar por Ocular.

Cliente ──PSTN── Carrier ──SIP── Ocular (agente)
│ ◄── REFER (Refer-To: destino)
│ ──► 202 Accepted
│ ──► INVITE destino ... 200 OK
│ ──► NOTIFY (200 OK) a Ocular, luego BYE
Cliente ──PSTN── Carrier ──PSTN── Destino (Ocular ya no está en la llamada)

En FreeSWITCH, sobre una llamada ya contestada, es la aplicación deflect (o uuid_deflect <uuid> <sip-uri> por ESL), que envía el REFER en el diálogo existente.

VentajasLibera canal, sesión de IA y ancho de banda en Ocular; no hay "tromboning" de audio; una sola pata facturada después del traspaso (según carrier).
Exige del carrierSoportar REFER desde el lado llamado (la mayoría de los carriers mayoristas lo aceptan solo desde el lado que originó; muchos responden 403, 603 o 501). Permitir que el Refer-To sea un número PSTN arbitrario de la cuenta y que la nueva pata se facture a la cuenta del socio.
RiesgosOcular pierde visibilidad y control una vez aceptado el REFER (no hay grabación ni disposición del tramo final). Si el destino no contesta, el carrier puede devolver la llamada a Ocular con NOTIFY 4xx/5xx o cortar; hay que manejar ambos.
CuándoCarrier que confirma soporte de REFER in-dialog desde el callee y el socio no necesita que Ocular siga en la llamada.

2. REFER atendido (attended transfer)​

Ocular primero abre una segunda llamada al destino por su trunk (consulta), y cuando el destino acepta, envía al carrier un REFER con Refer-To que incluye ?Replaces=<Call-ID de la consulta>. El carrier junta las dos patas y Ocular sale. Es la variante que la consulta de hoy dejaría lista: la segunda llamada ya existe.

VentajasEl cliente nunca cae en un destino que no contesta; Ocular confirma antes de soltar.
Exige del carrierTodo lo del REFER ciego y soporte de Replaces entre dos diálogos de la misma cuenta. Es lo menos soportado por carriers mayoristas.
CuándoMismo carrier para ambas patas y confirmación explícita de Replaces.

3. Puente en Ocular (bridge, "handoff" en el motor)​

Ocular origina una pata hacia el destino por su trunk saliente (el del país, con el caller ID de la campaña) y, cuando contesta, puentea las dos patas en FreeSWITCH (uuid_bridge). Ocular sigue en medio del audio hasta que una de las partes cuelga.

Cliente ──PSTN── Carrier ──SIP── Ocular ──SIP── Trunk saliente ──PSTN── Destino
│ uuid_bridge (RTP pasa por Ocular)
VentajasFunciona con cualquier carrier, sin negociar REFER. Ocular conserva control: puede grabar con consentimiento, medir, volver al agente si el destino cuelga, aplicar horario y lista blanca al destino con las mismas reglas que una llamada saliente. Es la fase 2 ya prevista en el contrato de transferencias (mode: "handoff").
CostoDos patas facturadas mientras dure la llamada y canal ocupado en Ocular. Latencia de audio mínima adicional.
Exige del carrierNada nuevo: usa el trunk saliente existente. Si la pata de entrada llega por un carrier solo de entrada (como el perfil TLS del primer socio), la salida va por el trunk del país.
CuándoOpción por defecto mientras el carrier no confirme REFER, o siempre que se necesite supervisión, grabación o retorno al agente.

4. Redirección antes de contestar (SIP 302)​

Si la decisión de a dónde enviar la llamada se puede tomar antes de contestar (por horario, por DID, por carga), Ocular responde al INVITE con 302 Moved Temporarily y Contact: sip:<destino>@<carrier>. El carrier reenruta y Ocular nunca atiende.

VentajasCero recursos en Ocular, sin REFER. Útil para desborde a un humano fuera de horario.
LímitesSolo pre-answer: no sirve una vez que el agente ya conversó. Depende de que el carrier acepte 302 hacia PSTN (la mayoría sí).

5. Lo que no es una transferencia​

  • Re-INVITE cambia parámetros de media (códec, dirección, IP de RTP), no mueve la llamada.
  • Transferencia dentro de la plataforma (el agente de IA pasa la conversación a un humano en la consola web de Ocular): el audio sigue entrando por SIP a Ocular; cambia quién habla, no la señalización. Es la opción más corta cuando el humano es un operador de Ocular y no un número PSTN.

Comparación rápida​

CriterioREFER ciegoREFER atendidoPuente en Ocular302 pre-answer
Depende del carrierAltoMuy altoNoBajo
Ocular sale de la llamadaSíSíNoSí (nunca entró)
Visibilidad y grabación del tramo finalNoNoSíNo
Retorno al agente si fallaLimitadoSí (antes de soltar)SíNo
Costo de canales/minutosMínimoMínimoDoble pataCero
Estado en OcularDiseñadoDiseñadoDiseñado (fase 2)No evaluado

Qué confirmar con el carrier antes de elegir REFER​

  1. ¿Acepta REFER in-dialog enviado por el lado llamado (Ocular es el callee en inbound)?
  2. ¿El Refer-To puede ser cualquier número PSTN en E.164, o solo números de la cuenta?
  3. ¿Devuelve NOTIFY con el progreso y el resultado final? ¿Qué pasa si el destino no contesta: retorna la llamada o la corta?
  4. ¿Soporta Replaces para transferencia atendida?
  5. ¿Cómo factura la pata nueva y qué caller ID presenta al destino (el del cliente original, el del socio, el de Ocular)? Esto tiene implicancias legales en Chile y Estados Unidos.
  6. ¿Hay límite de tiempo entre 202 Accepted y el BYE?
  7. ¿Pueden entregar evidencia de un REFER de prueba (Call-ID, códigos, NOTIFY)?

Si cualquiera de las respuestas 1, 2 o 3 es negativa o incierta, elegir el puente en Ocular.

Diseño de referencia en el motor (contrato v1.1, pendiente de construir)​

  • Señal del orquestador al motor por el canal de control del WebSocket de media: { "type": "transfer", "to": "<E.164 o URI SIP>", "mode": "blind" | "attended", "reason": "…" }. El destino lo resuelve el servidor desde la configuración del agente en Ocular OS; el modelo solo elige un destination_id.
  • Lista blanca de destinos por tenant y DID, default deny. Con la lista vacía, la transferencia falla cerrada.
  • Política de fallo por DID: return_to_agent, voicemail o courtesy_hangup cuando el REFER es rechazado o el destino no contesta.
  • Gates legales aplicados al destino como a cualquier llamada saliente: ventana horaria, lista No Molestar, clase de numeración, lista blanca del piloto. El perfil transfer del pack de jurisdicción exime topes de intentos y descanso, no las demás reglas.
  • Estados del intento: TRANSFERRING → TRANSFERRED (o vuelta a IN_CONVERSATION si aplica la política de retorno).
  • Eventos: transfer.initiated y transfer.completed con el código SIP del REFER (202, 4xx) y si se aplicó fallback. Se entregan por webhook al OS como el resto de eventos.
  • Disposición: outcome: transferred_human con transfer { to, mode, completed_at }.
  • Ejecución en FreeSWITCH: deflect para blind, originación + REFER con Replaces para attended, uuid_bridge para el puente. Se detiene el audio fork antes de mover la llamada.
  • Pruebas: escenario SIPp que simula un carrier que acepta y uno que rechaza el REFER, contra el orquestador mock.

Recomendación​

Construir primero el puente en Ocular como mode: "handoff" del contrato de transferencias: no depende del carrier, reutiliza la consulta ya existente (la segunda pata ya se abre hoy) y conserva grabación y retorno al agente. Dejar el REFER ciego como optimización por carrier, activable por DID, una vez que el carrier confirme por escrito los puntos 1 a 3 de la lista anterior y haya una prueba con evidencia.