Skip to main content
Una gestión es el registro de un intento de contacto contra una cuenta. Cada intento produce exactamente una gestión, que se va enriqueciendo a medida que llegan señales del canal: la confirmación de entrega, la transcripción de una llamada, una respuesta del cliente o el análisis de IA. Esta página enumera todo lo que una gestión puede contener. Úsela para interpretar una fila de Gestiones en la consola, o para saber qué valores esperar al leer gestiones por la API.

Los tres ejes

Cada gestión responde hasta tres preguntas independientes. Que una tenga respuesta no implica nada sobre las otras.

Entrega

¿El intento llegó al teléfono o al buzón de la persona? Nunca está vacío. En la API: delivery.

Camino

¿Qué recorrido tuvo la interacción una vez entregada? Vacío cuando no se observó ninguna. En la API: path.

Resultado

¿Qué salió de la interacción? Vacío en la mayoría de los casos, y eso es una respuesta válida, no un dato faltante. En la API: outcome.
Los ejes son independientes a propósito. Una entrega fallida puede traer un resultado (alguien contesta y dice que no es la persona buscada), y una entrega exitosa muy a menudo no trae ni camino ni resultado.

Entrega

En voz, Conectada significa que la llamada se contestó y que QCobro reprodujo el mensaje completo. No afirma que la persona lo haya escuchado.
La entrega solo avanza. Una vez que una gestión sale de Despachado, ninguna señal posterior la devuelve a ese estado ni la cambia entre Entregado y Fallido.

Razón del fallo

Acompaña a Fallido y a ningún otro estado. En la consola se muestra junto a la entrega, separada por un punto: Fallido · Sin respuesta.
En las llamadas, la razón del fallo viene del registro que la red telefónica guarda de cada llamada, así que distingue entre una llamada que sonó sin respuesta, una que encontró la línea ocupada y una que nunca llegó a realizarse. Error del proveedor queda reservado para fallos que el proveedor no explica.
No se realizó y Resultado desconocido son transitorios: la cuenta sigue siendo elegible para un intento posterior según las reglas de reintento de la campaña.

Camino

En la API este eje es path. En la consola se sigue llamando Camino.
ABANDONED y VOICEMAIL están definidos pero todavía no se detectan: distinguir un buzón de voz de una persona requiere detección automática de contestador, que aún no está disponible.
La consola muestra el camino como una progresión, por ejemplo Despachado → Recibido. En los canales de mensajería puede aparecer una etapa intermedia Leído, tomada del acuse de lectura. Leído es solo visual: no es un valor de camino y no aparece en la API.

Resultado

En la API este eje es outcome. En la consola se sigue llamando Resultado.
Los siete resultados marcados con No forman parte del contrato y la API los acepta, pero hoy el análisis automático solo está instruido para reconocer promesas de pago, bajas y personas equivocadas. Un pago parcial se registra como Promesa de pago con el monto acordado.
Una Promesa de pago crea una promesa con seguimiento propio, visible en la lista de promesas de pago. Ningún otro resultado crea una entidad con seguimiento.

Qué puede producir cada canal

El canal limita físicamente qué ejes son alcanzables. QCobro rechaza al escribir cualquier combinación fuera de esta tabla. El SMS no tiene canal de entrada, así que nunca produce camino ni resultado. La voz pregrabada tampoco tiene canal de entrada propio, salvo el menú de opciones: reproducir el guion completo marca Recibido, y pulsar la opción de baja marca además Baja.

Campos de la gestión

Las gestiones no se editan ni se borran. Se enriquecen con las señales que van llegando del canal, y las correcciones se expresan escribiendo una gestión nueva.
Los tres ejes se llamaban entrega, camino y resultado. Ahora son delivery, path y outcome. Si lee gestiones por la API o envía resultados al endpoint de gestiones, actualice los nombres de esos campos. Los valores no cambian.

Campos que hoy no se completan

Estos campos existen en el modelo pero ningún flujo los escribe todavía. Aparecen siempre vacíos.
La duración que muestra la consola la mide QCobro durante la llamada. La grabación la produce la red telefónica sobre un intervalo distinto, así que su duración y la duración mostrada no tienen por qué coincidir.

Siguientes pasos

Canales

Cómo QCobro contacta a sus cuentas por voz, SMS, correo y WhatsApp.

Endpoint de gestiones

Registrar el resultado de una gestión desde un sistema externo.

Promesas de pago

Qué pasa cuando una gestión termina en una promesa de pago.

Análisis con IA

Cómo se generan el resumen, el sentimiento y el siguiente paso.