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.
| Ventajas | Libera 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 carrier | Soportar 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. |
| Riesgos | Ocular 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ándo | Carrier 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.
| Ventajas | El cliente nunca cae en un destino que no contesta; Ocular confirma antes de soltar. |
| Exige del carrier | Todo lo del REFER ciego y soporte de Replaces entre dos diálogos de la misma cuenta. Es lo menos soportado por carriers mayoristas. |
| Cuándo | Mismo 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)
| Ventajas | Funciona 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"). |
| Costo | Dos patas facturadas mientras dure la llamada y canal ocupado en Ocular. Latencia de audio mínima adicional. |
| Exige del carrier | Nada 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ándo | Opció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.
| Ventajas | Cero recursos en Ocular, sin REFER. Útil para desborde a un humano fuera de horario. |
| Límites | Solo 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
| Criterio | REFER ciego | REFER atendido | Puente en Ocular | 302 pre-answer |
|---|---|---|---|---|
| Depende del carrier | Alto | Muy alto | No | Bajo |
| Ocular sale de la llamada | Sí | Sí | No | Sí (nunca entró) |
| Visibilidad y grabación del tramo final | No | No | Sí | No |
| Retorno al agente si falla | Limitado | Sí (antes de soltar) | Sí | No |
| Costo de canales/minutos | Mínimo | Mínimo | Doble pata | Cero |
| Estado en Ocular | Diseñado | Diseñado | Diseñado (fase 2) | No evaluado |
Qué confirmar con el carrier antes de elegir REFER
- ¿Acepta
REFERin-dialog enviado por el lado llamado (Ocular es el callee en inbound)? - ¿El
Refer-Topuede ser cualquier número PSTN en E.164, o solo números de la cuenta? - ¿Devuelve
NOTIFYcon el progreso y el resultado final? ¿Qué pasa si el destino no contesta: retorna la llamada o la corta? - ¿Soporta
Replacespara transferencia atendida? - ¿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.
- ¿Hay límite de tiempo entre
202 Acceptedy elBYE? - ¿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 undestination_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,voicemailocourtesy_hangupcuando 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
transferdel pack de jurisdicción exime topes de intentos y descanso, no las demás reglas. - Estados del intento:
TRANSFERRING→TRANSFERRED(o vuelta aIN_CONVERSATIONsi aplica la política de retorno). - Eventos:
transfer.initiatedytransfer.completedcon 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_humancontransfer { to, mode, completed_at }. - Ejecución en FreeSWITCH:
deflectpara blind, originación +REFERconReplacespara attended,uuid_bridgepara 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.