Analítica

Sucesos comerciales observados

GET/analitica/eventos

Consulta sucesos CRM persistidos, por contacto, entidad, tipo y periodo. Requiere un lote o un intervalo de hasta 366 días. No reconstruye cambios desde estados actuales, fechas agregadas o semejanzas de nombres.

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: evento, aplicado a la fecha guardada en el suceso.
`orden`	varchar	Requerido	ascendente o descendente por creación, con desempate estable por identidad.
`fuente`	varchar	Requerido	todas o suceso; la fuente habilitada es el registro de sucesos CRM.
`tipoEvento`	varchar		creacion, reasignacion, cambioFase, conversion, descarte, reactivacion, nota, seguimiento, edicion, eliminacion, compartido, noCompartido, etiquetado, fusion, completado, cancelado, comunicacion o desconocido.
`entidad`	varchar	Requerido	todas, contacto, oportunidad, venta, cita o tarea.
`tkEntidad`	varchar		Token de una entidad concreta. Requiere entidad distinta de todas y mantiene los filtros de contacto/periodo. Una entidad no visible o inexistente devuelve 404.

Respuesta

Nombre	Tipo	Descripción
`idEvento`	String	Identidad estable y única del suceso dentro de la cuenta.
`fuente`	String	suceso.
`idRegistroFuente`	String	Identidad opaca del registro fuente.
`tkEvento`	String	Token público persistido del suceso; puede ser null.
`tipoFuente`	Integer	Código numérico original del suceso; puede ser null.
`tipoEvento`	String	Tipo normalizado según el catálogo comprobado; desconocido cuando no hay correspondencia acreditada.
`entidad`	String	Entidad principal observada: contacto, oportunidad, venta, cita o tarea.
`tkProspecto`	String	Contacto asociado cuando sólo existe uno en el conjunto consultado; null si hay varios.
`contactosRelacionados`	Array<Object>	Contactos autorizados enlazados al mismo suceso y al lote; cada objeto contiene tkProspecto. No multiplica filas.
`tkOportunidad`	String	Oportunidad relacionada y perteneciente al contacto, o null.
`tkVenta`	String	Venta relacionada y autorizada; puede ser null.
`tkCita`	String	Cita relacionada y autorizada; puede ser null.
`tkTarea`	String	Tarea relacionada y autorizada; puede ser null.
`tkActor`	String	null si el registro no acredita al actor. No se sustituye por el responsable actual.
`tipoActor`	String	desconocido cuando la fuente no permite acreditar al actor.
`tkUsuarioRegistro`	String	Usuario asociado al registro; puede ser responsable y no demuestra autoría.
`tkUsuarioTokenOrigen`	String	Usuario de token de origen conservado por la fuente; null si está ausente. No se interpreta como responsable anterior ni actor comprobado.
`valorAnterior`	String	null: la fuente no conserva un valor anterior acreditado.
`valorNuevo`	String	tkUsuario destino persistido en una reasignación; null si no está guardado o no aplica.
`campoModificado`	String	tkUsuario para reasignación; null para otros tipos sin valores guardados.
`descripcion`	String	Descripción permitida, hasta 512 caracteres; null para comunicaciones o tipos no clasificados.
`contenidoTruncado`	Boolean	Indica que el texto fuente supera el máximo de 512 caracteres.
`fechaEvento`	String	Instante propio de la actividad con zona explícita; null si no se puede determinar.
`fechaRegistro`	String	null: no existe una fecha independiente de inserción acreditada.
`fechaActualizacion`	String	Fecha de modificación de esta fuente cuando existe; de otro modo null.
`fechaOriginal`	String	Fecha original del evento, incluso cuando no se puede convertir; puede ser null.
`baseTemporal`	String	evento o desconocido según la presencia de fecha fuente.
`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/eventos?tkContactos=P-EJEMPLO&cantidadRegistros=3' --header 'token: 00000000-0000-4000-8000-000000000001'const respuesta = await fetch("https://api.upnify.com/v4/analitica/eventos?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/eventos?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/eventos?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/eventos?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/eventos?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

[
  [
    {
      "idEvento": "suceso:5",
      "fuente": "suceso",
      "idRegistroFuente": "suceso:5",
      "tkEvento": "SUC-EJEMPLO",
      "tipoFuente": 9,
      "tipoEvento": "creacion",
      "entidad": "venta",
      "tkProspecto": "P-EJEMPLO",
      "contactosRelacionados": [
        {
          "tkProspecto": "P-EJEMPLO"
        }
      ],
      "tkOportunidad": "O-EJEMPLO",
      "tkVenta": "V-EJEMPLO",
      "tkCita": null,
      "tkTarea": null,
      "tkActor": null,
      "tipoActor": "desconocido",
      "tkUsuarioRegistro": "U-EJEMPLO",
      "tkUsuarioTokenOrigen": null,
      "valorAnterior": null,
      "valorNuevo": null,
      "campoModificado": null,
      "descripcion": "Venta sintetica",
      "contenidoTruncado": false,
      "fechaEvento": "2026-09-12T16:00:00Z",
      "fechaRegistro": null,
      "fechaActualizacion": "2026-09-22T02:45:31.617Z",
      "fechaOriginal": "2026-09-12T10:00:00",
      "baseTemporal": "evento"
    },
    {
      "idEvento": "suceso:2",
      "fuente": "suceso",
      "idRegistroFuente": "suceso:2",
      "tkEvento": "SUC-EJEMPLO",
      "tipoFuente": 5,
      "tipoEvento": "reasignacion",
      "entidad": "contacto",
      "tkProspecto": "P-EJEMPLO",
      "contactosRelacionados": [
        {
          "tkProspecto": "P-EJEMPLO"
        }
      ],
      "tkOportunidad": null,
      "tkVenta": null,
      "tkCita": null,
      "tkTarea": null,
      "tkActor": null,
      "tipoActor": "desconocido",
      "tkUsuarioRegistro": "U-EJEMPLO",
      "tkUsuarioTokenOrigen": null,
      "valorAnterior": null,
      "valorNuevo": "U-EJEMPLO",
      "campoModificado": "tkUsuario",
      "descripcion": "Reasignacion sintetica",
      "contenidoTruncado": false,
      "fechaEvento": "2026-09-10T16:00:00Z",
      "fechaRegistro": null,
      "fechaActualizacion": "2026-09-22T02:45:31.617Z",
      "fechaOriginal": "2026-09-10T10:00:00",
      "baseTemporal": "evento"
    },
    {
      "idEvento": "suceso:3",
      "fuente": "suceso",
      "idRegistroFuente": "suceso:3",
      "tkEvento": "SUC-EJEMPLO",
      "tipoFuente": 23,
      "tipoEvento": "cambioFase",
      "entidad": "contacto",
      "tkProspecto": "P-EJEMPLO",
      "contactosRelacionados": [
        {
          "tkProspecto": "P-EJEMPLO"
        }
      ],
      "tkOportunidad": null,
      "tkVenta": null,
      "tkCita": null,
      "tkTarea": null,
      "tkActor": null,
      "tipoActor": "desconocido",
      "tkUsuarioRegistro": "U-EJEMPLO",
      "tkUsuarioTokenOrigen": null,
      "valorAnterior": null,
      "valorNuevo": null,
      "campoModificado": null,
      "descripcion": "Cambio de fase sintetico",
      "contenidoTruncado": false,
      "fechaEvento": "2026-09-10T16:00:00Z",
      "fechaRegistro": null,
      "fechaActualizacion": "2026-09-22T02:45:31.617Z",
      "fechaOriginal": "2026-09-10T10:00:00",
      "baseTemporal": "evento"
    }
  ],
  [
    {
      "cobertura": {
        "estado": "parcial",
        "fuentes": [
          "suceso"
        ],
        "capacidadesFaltantes": [
          "historialCompleto",
          "valoresAnterioresNoPersistidos",
          "actorNoAcreditado",
          "aliasContactosAbsorbidos",
          "sucesosSinRelacionAutorizable",
          "sucesosDeOtrosModulos"
        ],
        "integridadHistorica": "desconocida"
      },
      "advertencias": [
        {
          "codigo": "HISTORIA_PARCIAL",
          "mensaje": "Solo sucesos CRM persistidos y relacionados con contactos autorizados; se excluyen resúmenes, exportaciones, sesiones y sucesos de otros módulos. No se reconstruyen fases agregadas ni aliases de contactos absorbidos.",
          "fuente": "suceso"
        },
        {
          "codigo": "ACTOR_NO_ACREDITADO",
          "mensaje": "El usuario del registro puede ser el responsable. El usuario de token se conserva como procedencia, sin afirmar actor o usuario anterior.",
          "fuente": "suceso"
        }
      ],
      "consistencia": "sinInstantanea",
      "fechaGeneracion": "2026-09-21T18:00:00Z"
    }
  ]
]

Sucesos comerciales observados

Parámetros

Respuesta

Solicitud

Sucesos comerciales observados de un contacto

Respuesta

HTTP 200; Row-Count: 4