Clientes

Detalle de seguimiento

GET/clientes/:tkProspecto/seguimientos/:tkSeguimiento

Consulta un seguimiento del cliente. La respuesta exitosa conserva el formato de arreglo. No incluye seguimientos asociados a oportunidades. Requiere el encabezado token de una sesión válida.

El filtro sistema acepta 0 o 1; su valor predeterminado es null, que devuelve todos los valores de sistema y conserva los demás filtros. En la URL, omite sistema para consultar todos; no envíes la cadena null. El filtro se aplica tanto a los resultados como al total del encabezado Row-Count.

La respuesta es un arreglo de seguimientos; puede estar vacío si no hay coincidencias. Row-Count contiene el total antes de paginar para los filtros de sistema, actividad, categoría y búsqueda; no se limita por tkSeguimiento. Si se proporciona un tkSeguimiento inexistente, se devuelve HTTP 404.

Parámetros

Nombre	Tipo	Validación	Descripción
`tkProspecto`	varchar		Identificador del cliente en la URL. El nombre del parámetro es `tkProspecto`. Máximo 64 caracteres.
`actividad`	int		Grupo de actividad en la consulta. 0 no restringe el grupo. Los grupos 1 a 12 incluyen, respectivamente, los tipos (0, 9, 20), (8), (1, 2, 13), (3, 4, 5), (6), (10), (12), (7), (14), (15), (19) y (16). El grupo 12 también incluye ciertos seguimientos automáticos de integración.
`pagina`	int		Número de página en la consulta; inicia en 1. Con 0 se devuelven hasta 1000 registros desde el inicio.
`cantidadRegistros`	int		Cantidad de registros por página en la consulta. Usa un entero mayor que 0. Si pagina es 0, el límite es 1000 y este valor no se utiliza.
`buscar`	varchar		Texto que se busca dentro del comentario del seguimiento. Máximo 256 caracteres. Omítelo o envía una cadena vacía para no limitar por texto.
`tkTipoSeguimiento`	varchar		Identificador de la categoría por la que se filtra en la consulta. Máximo 64 caracteres. Si se omite, está vacío o no corresponde a una categoría, no limita por categoría.
`tkSeguimiento`	varchar		Identificador del seguimiento en la URL. Máximo 64 caracteres.
`sistema`	bit		Consulta opcional: 0 selecciona seguimientos que no son del sistema y 1 los del sistema. El valor predeterminado null incluye todos, también los registros sin indicador. Para todos, omite el parámetro en la URL; no envíes el texto null.
`token`	String	Requerido	Token de sesión enviado en el encabezado HTTP `token`. No lo registres ni lo expongas.

Respuesta

Nombre	Tipo	Descripción
`indice`	Integer	Posición del seguimiento en el listado, considerando la página solicitada.
`tkSeguimiento`	String	Identificador del seguimiento.
`tipoSeguimiento`	Integer	Código del tipo de seguimiento. Puede ser null si no está definido.
`fechaHora`	String	Fecha y hora del seguimiento ajustadas a la configuración del usuario autenticado.
`tkSeguimientoCategoria`	String	Identificador de la categoría del seguimiento; null si no tiene categoría.
`categoria`	String	Nombre de la categoría; null si no tiene categoría.
`seguimiento`	String	Comentario del seguimiento, sin espacios al inicio ni al final.
`tkProspecto`	String	Identificador del contacto al que pertenece el seguimiento.
`tkUsuario`	String	Identificador del ejecutivo que registró el seguimiento.
`ejecutivoNombre`	String	Nombre completo del ejecutivo que registró el seguimiento.
`iniciales`	String	Iniciales del ejecutivo; puede ser null.
`avatar`	String	URL del avatar del ejecutivo; puede ser null.
`latitud`	String\|Number	Latitud registrada; puede recibirse como texto o número. Es null si no está disponible.
`longitud`	String\|Number	Longitud registrada; puede recibirse como texto o número. Es null si no está disponible.
`tkEmail`	String	Identificador del correo asociado; null si no está disponible.
`entrante`	Integer	Para correos: 1 si es entrante y 0 si es saliente. Es null para otros seguimientos.
`fechaApertura`	String	Fecha y hora de apertura del correo; null si no se ha abierto o no aplica.
`estado`	Integer	Código de estado del correo; null cuando el seguimiento no es un correo.
`leido`	Integer	Para correos: 1 si se ha leído y 0 en caso contrario. Es null para otros seguimientos.
`errores`	Integer	Código de errores del correo; null si no está disponible o no aplica.
`tipo`	Integer	Código del tipo de correo; null si no está disponible o no aplica.
`duracion`	Integer	Duración registrada para el seguimiento.
`sistema`	Integer	Indicador numérico: 1 para un seguimiento del sistema y 0 para uno que no es del sistema. Puede ser null si no está definido.
`tkTarea`	String	Identificador de la tarea asociada; null si no aplica.
`grabacion`	String	Referencia a la grabación asociada; puede ser null.
`tkConversacion`	String	Identificador de la conversación asociada; null si no aplica.
`tkSms`	String	Identificador del SMS asociado; null si no aplica.
`tkFlowTarea`	String	Identificador de la tarea de Flow asociada; null si no aplica.
`tkIntegracion`	String	Token de la integración asociada; null si no aplica. No lo registres ni lo expongas.
`tkHistorico`	String	Identificador del evento de integración asociado; null si no aplica.

Solicitud

curl --request GET 'https://api.upnify.com/v4/clientes/00000000-0000-4000-8000-000000000010/seguimientos/00000000-0000-4000-8000-000000000020?pagina=1&cantidadRegistros=50' \
  --header 'token: 00000000-0000-4000-8000-000000000001'const response = await fetch('https://api.upnify.com/v4/clientes/00000000-0000-4000-8000-000000000010/seguimientos/00000000-0000-4000-8000-000000000020?pagina=1&cantidadRegistros=50', {
  method: 'GET',
  headers: { token: '00000000-0000-4000-8000-000000000001' }
});
console.log(response.headers.get('Row-Count'));
console.log(await response.json());const response = await fetch('https://api.upnify.com/v4/clientes/00000000-0000-4000-8000-000000000010/seguimientos/00000000-0000-4000-8000-000000000020?pagina=1&cantidadRegistros=50', {
  method: 'GET',
  headers: { token: '00000000-0000-4000-8000-000000000001' }
});
console.log(response.headers.get('Row-Count'));
console.log(await response.json());import requests

response = requests.get(
    'https://api.upnify.com/v4/clientes/00000000-0000-4000-8000-000000000010/seguimientos/00000000-0000-4000-8000-000000000020?pagina=1&cantidadRegistros=50',
    headers={'token': '00000000-0000-4000-8000-000000000001'}
)
print(response.headers.get('Row-Count'))
print(response.json())package main

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

func main() {
    req, err := http.NewRequest("GET", "https://api.upnify.com/v4/clientes/00000000-0000-4000-8000-000000000010/seguimientos/00000000-0000-4000-8000-000000000020?pagina=1&cantidadRegistros=50", nil)
    if err != nil { panic(err) }
    req.Header.Set("token", "00000000-0000-4000-8000-000000000001")
    res, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer res.Body.Close()
    data, err := io.ReadAll(res.Body)
    if err != nil { panic(err) }
    fmt.Println(string(data))
}using System;
using System.Net.Http;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("token", "00000000-0000-4000-8000-000000000001");
using var response = await client.GetAsync("https://api.upnify.com/v4/clientes/00000000-0000-4000-8000-000000000010/seguimientos/00000000-0000-4000-8000-000000000020?pagina=1&cantidadRegistros=50");
Console.WriteLine(await response.Content.ReadAsStringAsync());

Respuesta

[
  {
    "indice": 1,
    "tkSeguimiento": "00000000-0000-4000-8000-000000000020",
    "tipoSeguimiento": 0,
    "fechaHora": "2026-09-22 10:30:00.000",
    "tkSeguimientoCategoria": null,
    "categoria": null,
    "seguimiento": "Se registró una nota de seguimiento.",
    "tkProspecto": "00000000-0000-4000-8000-000000000010",
    "tkUsuario": "00000000-0000-4000-8000-000000000030",
    "ejecutivoNombre": "Ejecutivo de ejemplo",
    "iniciales": "EE",
    "avatar": null,
    "latitud": null,
    "longitud": null,
    "tkEmail": null,
    "entrante": null,
    "fechaApertura": null,
    "estado": null,
    "leido": null,
    "errores": null,
    "tipo": null,
    "duracion": 0,
    "sistema": 0,
    "tkTarea": null,
    "grabacion": null,
    "tkConversacion": null,
    "tkSms": null,
    "tkFlowTarea": null,
    "tkIntegracion": null,
    "tkHistorico": null
  }
]

[
  {
    "code": 404,
    "msg": "El recurso no ha sido encontrado."
  }
]

Detalle de seguimiento

Parámetros

Respuesta

Solicitud

Consultar un seguimiento

Respuesta

HTTP 200: ejemplo de seguimiento con sistema=0

HTTP 404: tkSeguimiento inexistente