Analítica

Evidencias de campañas y secuencias

GET/analitica/secuencias

Distingue elegibilidad por etiqueta, participación/control y comunicación. Requiere lote, campaña o intervalo de hasta 366 días. Usa campañas CRM de la cuenta y comunicaciones del buzón propio; no ejecuta inscripciones ni envíos.

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	evidencia. Conserva la base particular de cada fuente; no inventa una fecha de inscripción.
`orden`	varchar	Requerido	ascendente o descendente por creación, con desempate estable por identidad.
`tkCampania`	varchar		Token de campaña o secuencia de la cuenta. Inexistente o ajeno devuelve 404.
`tipoEvidencia`	varchar	Requerido	todas, elegibilidad, inscripcion o comunicacion. inscripcion identifica participación/control, sin afirmar ejecución activa.

Respuesta

Nombre	Tipo	Descripción
`idEvidencia`	String	Identidad estable de etiqueta, membresía, control de pieza o comunicación.
`fuente`	String	etiqueta, membresiaCampania, controlSecuencia, correo o mensaje.
`idRegistroFuente`	String	Identidad opaca del registro fuente.
`tipoEvidencia`	String	todas, elegibilidad, inscripcion o comunicacion. inscripcion identifica participación/control, sin afirmar ejecución activa.
`criterio`	String	coincidenciaEtiquetaYTipoContacto, registroParticipacion, registroControlPieza o registroComunicacion.
`tkProspecto`	String	Contacto asociado cuando sólo existe uno en el conjunto consultado; null si hay varios.
`tkCampania`	String	Token público de la campaña o secuencia.
`tipoCampania`	String	campania o secuencia.
`nombreCampania`	String	Título de la campaña o secuencia de la cuenta.
`tkPieza`	String	Token de pieza relacionado y comprobado dentro de su secuencia; null si no aplica.
`tkPiezaSiguienteRegistrada`	String	Token siguiente explícitamente guardado en el control y perteneciente a la misma secuencia; null si falta. No afirma próxima ejecución.
`ordenPiezaFuente`	Integer	Orden actual guardado en el catálogo de piezas; no es el paso actual del contacto.
`tkEtiqueta`	String	Token público de la etiqueta.
`canal`	String	correo, telefono, visita, WhatsApp, interno o desconocido. En COM se conserva el nombre y código del canal fuente; la clasificación no comprobada queda desconocida.
`estadoFuente`	Object	Indicadores originales permitidos de la fuente; no se reinterpretan como un estado distinto.
`estadoInscripcion`	String	desconocido: los registros consultados no demuestran una inscripción durable activa.
`pasoActual`	Integer	null: no se deduce del orden de una pieza pasada.
`proximaEjecucion`	String	null: no se calcula a partir de intervalos de la configuración.
`envioRegistrado`	Boolean	true si existe fecha de envío guardada, false si sólo hay registro sin fecha de envío; null para otras evidencias.
`abierto`	Boolean	Indicador guardado de apertura; null si no existe. No prueba respuesta humana.
`entregado`	Boolean	null: estas fuentes no acreditan por sí solas entrega.
`respuestaHumana`	Boolean	null: ni apertura ni respuesta técnica del proveedor acreditan respuesta humana.
`fechaEvidencia`	String	Fecha propia de etiquetado, último envío de control o comunicación con zona. Membresía sin fecha queda null.
`fechaOriginal`	String	Fecha original del evento, incluso cuando no se puede convertir; puede ser null.
`baseTemporal`	String	Hecho de la fecha original: etiquetado, sinFechaInscripcion, ultimoEnvioControl, envio, registroComunicacion o desconocido.
`fechaEnvio`	String	Fecha de envío guardada con zona; null si no existe.
`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/secuencias?tkContactos=P-EJEMPLO&cantidadRegistros=3' --header 'token: 00000000-0000-4000-8000-000000000001'const respuesta = await fetch("https://api.upnify.com/v4/analitica/secuencias?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/secuencias?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/secuencias?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/secuencias?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/secuencias?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

[
  [
    {
      "idEvidencia": "registro:28",
      "fuente": "correo",
      "idRegistroFuente": "registro:28",
      "tipoEvidencia": "comunicacion",
      "criterio": "registroComunicacion",
      "tkProspecto": "TK-EJEMPLO-2",
      "tkCampania": "TK-EJEMPLO-29",
      "tipoCampania": "secuencia",
      "nombreCampania": "Secuencia sintetica deshabilitada",
      "tkPieza": "TK-EJEMPLO-30",
      "tkPiezaSiguienteRegistrada": null,
      "ordenPiezaFuente": 1,
      "tkEtiqueta": null,
      "canal": "correo",
      "estadoFuente": {
        "estadoCampania": 0,
        "estado": 2,
        "abierto": 0,
        "clic": 0
      },
      "estadoInscripcion": "desconocido",
      "pasoActual": null,
      "proximaEjecucion": null,
      "envioRegistrado": true,
      "abierto": false,
      "entregado": null,
      "respuestaHumana": null,
      "fechaEvidencia": "2026-09-10T16:00:00Z",
      "fechaOriginal": "2026-09-10T10:00:00",
      "baseTemporal": "envio",
      "fechaEnvio": "2026-09-10T16:00:00Z"
    },
    {
      "idEvidencia": "registro:31",
      "fuente": "controlSecuencia",
      "idRegistroFuente": "registro:31",
      "tipoEvidencia": "inscripcion",
      "criterio": "registroControlPieza",
      "tkProspecto": "TK-EJEMPLO-2",
      "tkCampania": "TK-EJEMPLO-29",
      "tipoCampania": "secuencia",
      "nombreCampania": "Secuencia sintetica deshabilitada",
      "tkPieza": "TK-EJEMPLO-30",
      "tkPiezaSiguienteRegistrada": null,
      "ordenPiezaFuente": 1,
      "tkEtiqueta": "TK-EJEMPLO-32",
      "canal": null,
      "estadoFuente": {
        "estadoCampania": 0,
        "estadoPieza": 0,
        "abierto": 1,
        "sinPiezaSiguienteFuente": true
      },
      "estadoInscripcion": "desconocido",
      "pasoActual": null,
      "proximaEjecucion": null,
      "envioRegistrado": null,
      "abierto": null,
      "entregado": null,
      "respuestaHumana": null,
      "fechaEvidencia": "2026-09-10T15:00:00Z",
      "fechaOriginal": "2026-09-10T09:00:00",
      "baseTemporal": "ultimoEnvioControl",
      "fechaEnvio": null
    },
    {
      "idEvidencia": "registro:33",
      "fuente": "etiqueta",
      "idRegistroFuente": "registro:33",
      "tipoEvidencia": "elegibilidad",
      "criterio": "coincidenciaEtiquetaYTipoContacto",
      "tkProspecto": "TK-EJEMPLO-2",
      "tkCampania": "TK-EJEMPLO-29",
      "tipoCampania": "secuencia",
      "nombreCampania": "Secuencia sintetica deshabilitada",
      "tkPieza": null,
      "tkPiezaSiguienteRegistrada": null,
      "ordenPiezaFuente": null,
      "tkEtiqueta": "TK-EJEMPLO-32",
      "canal": null,
      "estadoFuente": {
        "estadoCampania": 0,
        "pausado": 1,
        "recibirCorreos": 0
      },
      "estadoInscripcion": "desconocido",
      "pasoActual": null,
      "proximaEjecucion": null,
      "envioRegistrado": null,
      "abierto": null,
      "entregado": null,
      "respuestaHumana": null,
      "fechaEvidencia": "2026-09-10T14:00:00Z",
      "fechaOriginal": "2026-09-10T08:00:00",
      "baseTemporal": "etiquetado",
      "fechaEnvio": null
    }
  ],
  [
    {
      "cobertura": {
        "estado": "parcial",
        "fuentes": [
          "etiqueta",
          "membresiaCampania",
          "controlSecuencia",
          "correo",
          "mensaje"
        ],
        "capacidadesFaltantes": [
          "consentimientoVerificable",
          "estadoInscripcionDurable",
          "pasoActual",
          "proximaEjecucion",
          "fechaInscripcionCampania",
          "comunicacionesOtrosBuzones",
          "historialEliminaciones"
        ],
        "integridadHistorica": "desconocida"
      },
      "advertencias": [
        {
          "codigo": "EVIDENCIAS_DISTINTAS",
          "mensaje": "Coincidir con reglas de etiqueta no acredita permiso de envio. La participacion y el control de piezas no prueban una inscripcion activa. Las comunicaciones cubren el buzon propio.",
          "fuente": "secuencias"
        },
        {
          "codigo": "FECHAS_PARCIALES",
          "mensaje": "Etiquetado y ultimo envio de control son fechas de esas evidencias, no de inscripcion. La membresia sin fecha queda fuera de filtros temporales.",
          "fuente": "secuencias"
        }
      ],
      "consistencia": "sinInstantanea",
      "fechaGeneracion": "2026-09-21T18:00:00Z"
    }
  ]
]

Evidencias de campañas y secuencias

Parámetros

Respuesta

Solicitud

Evidencias de campañas y secuencias de un contacto

Respuesta

HTTP 200; Row-Count: 4