Skip to main content
GET
Consulta el historial de intentos de un contacto
Devuelve los intentos ya realizados sobre un contacto dentro del lote. Puedes localizarlo mediante su identifier externo o mediante el contactId interno.
Usa preferentemente identifier para relacionar la consulta con el registro de tu CRM u otro sistema de origen. Envía exactamente uno de los dos identificadores.
El parámetro timezone es opcional y determina la zona horaria de occurredAt. Si lo omites, las fechas se devuelven en UTC.

Ejemplos de consulta

Los campos sin datos se devuelven como null, no como cadenas vacías. Un contacto cargado que todavía no fue marcado devuelve data vacío y pagination.total: 0; esto no significa que el contacto no exista.
occurredAt utiliza el formato YYYY-MM-DD HH:mm:ss.SSS y no incluye un offset. Interprétalo junto con el campo timezone de la respuesta. Evita pasarlo directamente a new Date(occurredAt), porque JavaScript usaría la zona horaria del cliente, que puede ser distinta de la solicitada.
Consulta Códigos de resultado para interpretar result.

Authorizations

apikey
string
header
required

API key obtenida desde la interfaz de Inagent, dentro del marcador.

Path Parameters

batchId
string<uuid>
required

Id del lote.

Query Parameters

identifier
string

Identificador del contacto en el sistema de origen. Recomendado.

contactId
string<uuid>

Identificador interno asignado por Inagent al importar el contacto.

timezone
string
default:UTC

Zona horaria IANA utilizada para expresar occurredAt.

limit
integer

Cantidad máxima de intentos que se devolverán.

offset
integer

Desplazamiento desde el primer intento.

Required range: x >= 0

Response

200 - application/json

Historial de intentos del contacto.

contact
object
required
data
object[]
required
pagination
object
required
timezone
string
required