Analítica

Actividades observadas

GET/analitica/actividades

Consulta seguimientos, correos propios y mensajes COM autorizados. Requiere periodo de hasta 366 días o lote de contactos. Separa notas, intentos y contacto efectivo según campos de la fuente; conserva desconocidos y evita duplicar correos enlazados a seguimientos.

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. Seguimiento usa su fecha registrada; correo entrante usa su fecha de mensaje; saliente usa envío; COM usa la fecha del mensaje.
`orden`	varchar	Requerido	ascendente o descendente por creación, con desempate estable por identidad.
`fuente`	varchar	Requerido	todas, seguimiento, correoEntrante, correoSaliente o com. Se aplican permisos del contacto y de cada fuente.
`permitirParciales`	varchar	Requerido	true o false. Con fuente=todas permite omitir COM si no está habilitado en la cuenta. No omite falta de permiso ni errores de ejecución.
`canal`	varchar		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.
`direccion`	varchar		entrante, saliente, interna o desconocida, sustentada por campos de la fuente.
`tipo`	varchar		nota, intento, contactoEfectivo, automatismo, mensaje o desconocido. No se clasifica a partir del texto.
`tipoActor`	varchar		humano, automatico, sistema o desconocido según la evidencia registrada.

Respuesta

Nombre	Tipo	Descripción
`idActividad`	String	Identidad estable de la actividad dentro de la cuenta.
`fuente`	String	seguimiento, correoEntrante, correoSaliente o com.
`idRegistroFuente`	String	Identidad opaca del registro fuente.
`tkProspecto`	String	Contacto autorizado al que corresponde la actividad.
`tkOportunidad`	String	Oportunidad relacionada y perteneciente al contacto, o null.
`tkConversacion`	String	Conversación COM autorizada, o null.
`idComunicacion`	String	Identidad compartida de una comunicación enlazada; permite relacionarla con su seguimiento. Puede ser null.
`idMensajeProveedor`	String	Identificador del mensaje guardado por el proveedor, o null.
`proveedor`	Integer	Código de proveedor del buzón de correo cuando está registrado; de otro modo null.
`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.
`canalFuente`	String	Nombre original del canal COM; puede ser null. No determina por texto la clasificación.
`tipoCanalFuente`	Integer	Código original del tipo de canal COM, o null.
`estadosProveedor`	Object	Estados persistidos de COM: envioOriginal, entregaOriginal, lecturaOriginal y falloOriginal. Sus tiempos conservan el formato fuente; no se presentan como instantes normalizados. Puede ser null.
`direccion`	String	entrante, saliente, interna o desconocida, sustentada por campos de la fuente.
`tipo`	String	nota, intento, contactoEfectivo, automatismo, mensaje o desconocido. No se clasifica a partir del texto.
`tipoActor`	String	humano, automatico, sistema o desconocido según la evidencia registrada.
`tkActor`	String	Usuario que la evidencia identifica como actor humano; null si no se puede identificar.
`tipoFuente`	Integer	Tipo numérico original del seguimiento, o null.
`estadoFuente`	String	Estado original del proveedor o buzón, o null. Los códigos externos se conservan.
`resultado`	String	Resultado comprobado: efectivo, sinContactoEfectivo, recibido, enviado, entregado, rebotado, leido, fallido o desconocido.
`extracto`	String	Texto o asunto permitido, hasta 512 caracteres; null para contenido no autorizado o ausente.
`contenidoTruncado`	Boolean	Indica que el texto fuente supera el máximo de 512 caracteres.
`ventasRelacionadas`	Array<Object>	Ventas vinculadas a la oportunidad del mismo contacto; cada objeto contiene tkVenta. No multiplica la actividad.
`fechaEvento`	String	Instante propio de la actividad con zona explícita; null si no se puede determinar.
`fechaRegistro`	String	Fecha independiente de registro o descarga cuando existe; de otro modo null.
`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	seguimiento, fechaCorreo, envio, mensaje o desconocido; identifica la procedencia temporal.
`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/actividades?tkContactos=P-EJEMPLO&fuente=todas&cantidadRegistros=3&fechaInicio=2026-09-10T16%3A00%3A00Z&fechaFin=2026-09-11T16%3A00%3A00Z' --header 'token: 00000000-0000-4000-8000-000000000001'const respuesta = await fetch("https://api.upnify.com/v4/analitica/actividades?tkContactos=P-EJEMPLO&fuente=todas&cantidadRegistros=3&fechaInicio=2026-09-10T16%3A00%3A00Z&fechaFin=2026-09-11T16%3A00%3A00Z", { headers: { token: "00000000-0000-4000-8000-000000000001" } });
console.log(await respuesta.json());const respuesta = await fetch("https://api.upnify.com/v4/analitica/actividades?tkContactos=P-EJEMPLO&fuente=todas&cantidadRegistros=3&fechaInicio=2026-09-10T16%3A00%3A00Z&fechaFin=2026-09-11T16%3A00%3A00Z", { headers: { token: "00000000-0000-4000-8000-000000000001" } });
console.log(await respuesta.json());import requests

respuesta = requests.get("https://api.upnify.com/v4/analitica/actividades?tkContactos=P-EJEMPLO&fuente=todas&cantidadRegistros=3&fechaInicio=2026-09-10T16%3A00%3A00Z&fechaFin=2026-09-11T16%3A00%3A00Z", 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/actividades?tkContactos=P-EJEMPLO&fuente=todas&cantidadRegistros=3&fechaInicio=2026-09-10T16%3A00%3A00Z&fechaFin=2026-09-11T16%3A00%3A00Z", 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/actividades?tkContactos=P-EJEMPLO&fuente=todas&cantidadRegistros=3&fechaInicio=2026-09-10T16%3A00%3A00Z&fechaFin=2026-09-11T16%3A00%3A00Z");
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

[
  [
    {
      "idActividad": "com:1",
      "fuente": "com",
      "idRegistroFuente": "com:1",
      "tkProspecto": "P-EJEMPLO",
      "tkOportunidad": null,
      "tkConversacion": "CONV-EJEMPLO",
      "idComunicacion": "com:1",
      "idMensajeProveedor": "ID-PROVEEDOR-SINTETICO",
      "proveedor": null,
      "canal": "desconocido",
      "canalFuente": "Canal sintetico",
      "tipoCanalFuente": 1,
      "estadosProveedor": {
        "envioOriginal": 1000,
        "entregaOriginal": 1001,
        "lecturaOriginal": null,
        "falloOriginal": null
      },
      "direccion": "saliente",
      "tipo": "automatismo",
      "tipoActor": "automatico",
      "tkActor": null,
      "tipoFuente": null,
      "estadoFuente": "delivered",
      "resultado": "entregado",
      "extracto": "Mensaje automatico sintetico",
      "contenidoTruncado": false,
      "ventasRelacionadas": [],
      "fechaEvento": "2026-09-10T17:00:00Z",
      "fechaRegistro": null,
      "fechaActualizacion": null,
      "fechaOriginal": "2026-09-10 11:00:00",
      "baseTemporal": "mensaje"
    },
    {
      "idActividad": "com:2",
      "fuente": "com",
      "idRegistroFuente": "com:2",
      "tkProspecto": "P-EJEMPLO",
      "tkOportunidad": null,
      "tkConversacion": "CONV-EJEMPLO",
      "idComunicacion": "com:2",
      "idMensajeProveedor": null,
      "proveedor": null,
      "canal": "desconocido",
      "canalFuente": "Canal sintetico",
      "tipoCanalFuente": 1,
      "estadosProveedor": {
        "envioOriginal": null,
        "entregaOriginal": null,
        "lecturaOriginal": null,
        "falloOriginal": null
      },
      "direccion": "entrante",
      "tipo": "mensaje",
      "tipoActor": "humano",
      "tkActor": null,
      "tipoFuente": null,
      "estadoFuente": null,
      "resultado": "desconocido",
      "extracto": "Mensaje entrante sintetico",
      "contenidoTruncado": false,
      "ventasRelacionadas": [],
      "fechaEvento": "2026-09-10T16:00:00Z",
      "fechaRegistro": null,
      "fechaActualizacion": null,
      "fechaOriginal": "2026-09-10 10:00:00",
      "baseTemporal": "mensaje"
    },
    {
      "idActividad": "correoEntrante:3",
      "fuente": "correoEntrante",
      "idRegistroFuente": "correoEntrante:3",
      "tkProspecto": "P-EJEMPLO",
      "tkOportunidad": null,
      "tkConversacion": null,
      "idComunicacion": "correoEntrante:3",
      "idMensajeProveedor": null,
      "proveedor": null,
      "canal": "correo",
      "canalFuente": null,
      "tipoCanalFuente": null,
      "estadosProveedor": null,
      "direccion": "entrante",
      "tipo": "mensaje",
      "tipoActor": "desconocido",
      "tkActor": null,
      "tipoFuente": null,
      "estadoFuente": null,
      "resultado": "recibido",
      "extracto": "Correo entrante sintetico",
      "contenidoTruncado": false,
      "ventasRelacionadas": [],
      "fechaEvento": "2026-09-10T16:00:00Z",
      "fechaRegistro": "2026-09-22T02:30:11.3933333Z",
      "fechaActualizacion": null,
      "fechaOriginal": "2026-09-10T10:00:00",
      "baseTemporal": "fechaCorreo"
    }
  ],
  [
    {
      "cobertura": {
        "estado": "parcial",
        "fuentes": [
          "seguimiento",
          "correoEntrante",
          "correoSaliente",
          "com"
        ],
        "capacidadesFaltantes": [
          "mensajesSinIdentidadPersistida",
          "correoDeOtrosUsuarios",
          "historialCompleto"
        ],
        "integridadHistorica": "desconocida"
      },
      "advertencias": [
        {
          "codigo": "ALCANCE_CORREOS",
          "mensaje": "Inbox y outbox conservan el alcance del buzon de la sesion; un seguimiento no concede acceso al contenido de mensajes privados.",
          "fuente": "correo"
        },
        {
          "codigo": "COBERTURA_COM",
          "mensaje": "Se proyectan mensajes con identificador persistido; El tipo y nombre fuente del canal se conservan sin clasificar por texto; los estados del proveedor solo se proyectan cuando estan guardados.",
          "fuente": "com"
        }
      ],
      "consistencia": "sinInstantanea",
      "fechaGeneracion": "2026-09-21T18:00:00Z"
    }
  ]
]

Actividades observadas

Parámetros

Respuesta

Solicitud

Actividad reciente de un contacto

Respuesta

HTTP 200; Row-Count: 8