Analítica

Pendientes de atención

GET/analitica/pendientes

Consulta agenda, tareas de CRM/Flow y conversaciones COM autorizadas. Conserva un registro por pendiente, aunque tenga varios responsables o contactos. Usa los estados observables, sin deducir realización de citas ni respuesta a mensajes.

Parámetros

Nombre	Tipo	Validación	Descripción
`params`	varchar
`pagina`	varchar	Requerido	Entero entre 1 y 2147483647. Página de resultados; no admite descarga ilimitada.
`cantidadRegistros`	varchar	Requerido	Entero de 1 a 200. Cantidad máxima de filas de la página.
`tkContactos`	varchar		Hasta 100 tokens separados por coma, máximo 128 caracteres cada uno y 8192 en total. Los duplicados no multiplican resultados.
`fechaInicio`	varchar		Inicio incluido, ISO 8601 con offset; requiere fechaFin. Se requiere un intervalo de hasta 366 días o tkContactos.
`fechaFin`	varchar		Fin excluido, ISO 8601 con offset, posterior al inicio y hasta 366 días después. Requiere fechaInicio.
`fechaBase`	varchar	Requerido	Valor habilitado: vencimiento. En citas corresponde al inicio programado; COM no registra vencimiento y queda fuera al filtrar un intervalo.
`orden`	varchar	Requerido	ascendente o descendente por creación, con desempate estable por identidad.
`fuente`	varchar	Requerido	todas, agenda, flujo o com. Cada fuente aplica sus permisos de módulo y entidad.
`permitirParciales`	varchar	Requerido	true o false. Con fuente=todas admite omitir Flow o COM si no están habilitados en la cuenta, con advertencia. La falta de permiso sigue devolviendo 403.
`tipo`	varchar		recordatorio, llamada, visita, tarea, cita, conversacion o desconocido.
`estado`	varchar	Requerido	todos, pendiente, completado, cancelado o desconocido. El valor predeterminado incluye los estados disponibles.
`vencido`	varchar		true, false o desconocido. La falta de vencimiento o de estado fiable queda desconocida; un completado o cancelado no es un pendiente vencido.
`tkUsuario`	varchar		Identificador del responsable; no amplía permisos.
`tkGrupo`	varchar		Identificador del grupo de responsables; no amplía permisos.

Respuesta

Nombre	Tipo	Descripción
`idPendiente`	String	Identidad estable y única del pendiente dentro de la cuenta.
`fuente`	String	agenda, flujo o com.
`idRegistroFuente`	String	Identidad opaca del registro de origen.
`tkProspecto`	String	Contacto asociado cuando sólo existe uno en el conjunto consultado; null si hay varios.
`contactosRelacionados`	Array<Object>	Contactos autorizados asociados al pendiente y al lote solicitado; cada objeto contiene tkProspecto.
`tipo`	String	recordatorio, llamada, visita, tarea, cita, conversacion o desconocido.
`asunto`	String	Título o asunto, acotado a 512 caracteres; puede ser null.
`estado`	String	pendiente, completado, cancelado o desconocido. Una cita inactiva no acredita realización ni cancelación.
`estadoFuente`	Object	Indicadores originales. Agenda: completado/tipo, estado o activo. Flow: completada, cancelada y archivada. COM: turno, archivado y noLeidosAgente. Los códigos conservan su valor fuente.
`vencido`	Boolean	true sólo para un pendiente con vencimiento anterior al instante de la consulta; null cuando no puede determinarse.
`criterioPendiente`	String	Regla sustentada por la fuente: indicadorCompletado, estadoTareaCrm, citaActivaSinResultado, indicadoresTareaFlujo o turnoAgenteConversacionNoArchivada.
`resultadoCita`	String	null cuando no existe un resultado registrado que acredite realización o cancelación.
`responsables`	Array<Object>	Usuarios responsables o invitados autorizados de la misma cuenta; cada objeto contiene tkUsuario, nombre y apellidos.
`fechaVencimiento`	String	Vencimiento registrado con zona; en citas es el inicio programado. null si no existe.
`fechaFin`	String	Fin programado de la cita con zona; null para otras fuentes.
`fechaCreacion`	String	Instante de creación con zona explícita; puede ser null.
`fechaActualizacion`	String	Fecha de modificación de esta fuente cuando existe; de otro modo null.
`fechaCompletado`	String	Fecha registrada de completado de Flow con zona; null si no existe.
`fechaCancelado`	String	Fecha registrada de cancelación de Flow con zona; null si no existe.
`fechaOriginal`	String	Fecha original del evento, incluso cuando no se puede convertir; puede ser null.
`baseTemporal`	String	vencimiento o desconocido según la presencia de la fecha fuente.
`fechaInicioPendiente`	String	null: las fuentes consultadas no acreditan el instante exacto de entrada al estado pendiente.
`cobertura`	Object	Estado, fuentes consultadas, capacidadesFaltantes e integridadHistorica.
`advertencias`	Array<Object>	Lista de objetos con codigo, mensaje y fuente que explican límites de cobertura.
`consistencia`	String	Siempre sinInstantanea; los cambios concurrentes pueden alterar la navegación.
`fechaGeneracion`	String	Instante de generación de la respuesta, con zona explícita.
`Row-Count`	Integer	Total del conjunto autorizado y filtrado, antes de paginar.

Solicitud

curl --request GET --url 'https://api.upnify.com/v4/analitica/pendientes?tkContactos=P-EJEMPLO&cantidadRegistros=3' --header 'token: 00000000-0000-4000-8000-000000000001'const respuesta = await fetch("https://api.upnify.com/v4/analitica/pendientes?tkContactos=P-EJEMPLO&cantidadRegistros=3", { headers: { token: "00000000-0000-4000-8000-000000000001" } });
console.log(await respuesta.json());const respuesta = await fetch("https://api.upnify.com/v4/analitica/pendientes?tkContactos=P-EJEMPLO&cantidadRegistros=3", { headers: { token: "00000000-0000-4000-8000-000000000001" } });
console.log(await respuesta.json());import requests

respuesta = requests.get("https://api.upnify.com/v4/analitica/pendientes?tkContactos=P-EJEMPLO&cantidadRegistros=3", headers={"token": "00000000-0000-4000-8000-000000000001"})
respuesta.raise_for_status()
print(respuesta.json())package main

import (
 "net/http"
 "io"
 "os"
)

func main() {
 solicitud, err := http.NewRequest(http.MethodGet, "https://api.upnify.com/v4/analitica/pendientes?tkContactos=P-EJEMPLO&cantidadRegistros=3", nil)
 if err != nil { panic(err) }
 solicitud.Header.Set("token", "00000000-0000-4000-8000-000000000001")
 respuesta, err := http.DefaultClient.Do(solicitud)
 if err != nil { panic(err) }
 defer respuesta.Body.Close()
 io.Copy(os.Stdout, respuesta.Body)
}using System;
using System.Net.Http;

using var cliente = new HttpClient();
using var solicitud = new HttpRequestMessage(HttpMethod.Get, "https://api.upnify.com/v4/analitica/pendientes?tkContactos=P-EJEMPLO&cantidadRegistros=3");
solicitud.Headers.Add("token", "00000000-0000-4000-8000-000000000001");
using var respuesta = await cliente.SendAsync(solicitud);
respuesta.EnsureSuccessStatusCode();
Console.WriteLine(await respuesta.Content.ReadAsStringAsync());

Respuesta

[
  [
    {
      "idPendiente": "tarea:15",
      "fuente": "agenda",
      "idRegistroFuente": "tarea:15",
      "tkProspecto": "P-EJEMPLO",
      "contactosRelacionados": [
        {
          "tkProspecto": "P-EJEMPLO"
        }
      ],
      "tipo": "tarea",
      "asunto": "Tarea cancelada sintetica",
      "estado": "cancelado",
      "estadoFuente": {
        "estado": 5
      },
      "vencido": false,
      "criterioPendiente": "estadoTareaCrm",
      "resultadoCita": null,
      "responsables": [
        {
          "tkUsuario": "U-EJEMPLO",
          "nombre": "Prueba",
          "apellidos": "Analitica"
        }
      ],
      "fechaVencimiento": "2026-09-10T19:00:00Z",
      "fechaFin": null,
      "fechaCreacion": "2026-09-22T02:45:31.6133333Z",
      "fechaActualizacion": "2026-09-22T02:45:31.6133333Z",
      "fechaCompletado": null,
      "fechaCancelado": null,
      "fechaOriginal": "2026-09-10T13:00:00",
      "baseTemporal": "vencimiento",
      "fechaInicioPendiente": null
    },
    {
      "idPendiente": "tarea:14",
      "fuente": "agenda",
      "idRegistroFuente": "tarea:14",
      "tkProspecto": "P-EJEMPLO",
      "contactosRelacionados": [
        {
          "tkProspecto": "P-EJEMPLO"
        }
      ],
      "tipo": "tarea",
      "asunto": "Tarea completada sintetica",
      "estado": "completado",
      "estadoFuente": {
        "estado": 2
      },
      "vencido": false,
      "criterioPendiente": "estadoTareaCrm",
      "resultadoCita": null,
      "responsables": [
        {
          "tkUsuario": "U-EJEMPLO",
          "nombre": "Prueba",
          "apellidos": "Analitica"
        }
      ],
      "fechaVencimiento": "2026-09-10T18:00:00Z",
      "fechaFin": null,
      "fechaCreacion": "2026-09-22T02:45:31.6133333Z",
      "fechaActualizacion": "2026-09-22T02:45:31.6133333Z",
      "fechaCompletado": null,
      "fechaCancelado": null,
      "fechaOriginal": "2026-09-10T12:00:00",
      "baseTemporal": "vencimiento",
      "fechaInicioPendiente": null
    },
    {
      "idPendiente": "tarea:13",
      "fuente": "agenda",
      "idRegistroFuente": "tarea:13",
      "tkProspecto": "P-EJEMPLO",
      "contactosRelacionados": [
        {
          "tkProspecto": "P-EJEMPLO"
        }
      ],
      "tipo": "tarea",
      "asunto": "Tarea pendiente sintetica",
      "estado": "pendiente",
      "estadoFuente": {
        "estado": 1
      },
      "vencido": true,
      "criterioPendiente": "estadoTareaCrm",
      "resultadoCita": null,
      "responsables": [
        {
          "tkUsuario": "U-EJEMPLO",
          "nombre": "Prueba",
          "apellidos": "Analitica"
        }
      ],
      "fechaVencimiento": "2026-09-10T17:00:00Z",
      "fechaFin": null,
      "fechaCreacion": "2026-09-22T02:45:31.6133333Z",
      "fechaActualizacion": "2026-09-22T02:45:31.6133333Z",
      "fechaCompletado": null,
      "fechaCancelado": null,
      "fechaOriginal": "2026-09-10T11:00:00",
      "baseTemporal": "vencimiento",
      "fechaInicioPendiente": null
    }
  ],
  [
    {
      "cobertura": {
        "estado": "parcial",
        "fuentes": [
          "agenda",
          "flujo",
          "com"
        ],
        "capacidadesFaltantes": [
          "resultadoCitasInactivas",
          "inicioExactoPendiente",
          "vencimientoConversaciones"
        ],
        "integridadHistorica": "desconocida"
      },
      "advertencias": [
        {
          "codigo": "ESTADOS_OBSERVADOS",
          "mensaje": "Cita inactiva no acredita realizada ni cancelada; no se fabrica la fecha inicial del pendiente.",
          "fuente": "agenda"
        },
        {
          "codigo": "VENCIMIENTO_DESCONOCIDO",
          "mensaje": "Las conversaciones no registran vencimiento y no participan en un filtro por vencimiento.",
          "fuente": "com"
        }
      ],
      "consistencia": "sinInstantanea",
      "fechaGeneracion": "2026-09-21T18:00:00Z"
    }
  ]
]

Pendientes de atención

Parámetros

Respuesta

Solicitud

Pendientes de atención de un contacto

Respuesta

HTTP 200; Row-Count: 9