Skip to main content
GET
Consulta el estado de una operación
Utiliza el operationId devuelto por una operación con respuesta 202 para seguir su progreso y recuperar su resultado. Revisa primero el campo kind: contacts.load devuelve el desglose de los contactos cargados, mientras que batch.lifecycle informa del progreso y la etapa de una operación sobre el lote. En una carga de contactos, recontactedCount indica cuántos contactos existentes se volvieron a poner en marcación mediante onDuplicate: "recontact".

Authorizations

apikey
string
header
required

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

Path Parameters

operationId
string<uuid>
required

Identificador de la operación, devuelto por la operación asíncrona que se desea consultar.

Response

Estado de la operación.

Una operación asincrónica. Las dos variantes se distinguen por kind: no son el mismo recurso con campos opcionales, sino dos formas distintas que informan cosas distintas.

kind
enum<string>
required

Identifica el tipo de operación. Utilice este campo para determinar la estructura de la respuesta.

Available options:
contacts.load
operationId
string<uuid>
required
batchId
string<uuid>
required

El lote sobre el que corrió la carga. Viaja en la respuesta para que no tengas que recordarlo.

type
enum<string>
required
Available options:
contacts.insert
status
enum<string>
required

partial significa que entró una parte de los contactos. En una carga masiva es un desenlace normal, no un error.

Available options:
pending,
running,
succeeded,
partial,
failed
requestedCount
integer
required

Número de contactos enviados en la petición.

Example:

150

totalChunks
integer
required

Bloques en los que se partió la carga. La operación cierra cuando todos reportaron.

Example:

3

chunksCompleted
integer
required

Bloques ya procesados. Con chunksCompleted < totalChunks los contadores todavía están incompletos.

Example:

3

insertedCount
integer
required

Contactos que entraron como nuevos.

invalidCount
integer
required

Rechazados por validación de datos.

duplicateCount
integer
required

Descartados por la política de duplicados del lote.

updatedCount
integer
required

Ya existían y se les aplicó lo enviado. Cubre tanto el merge como el reemplazo: la diferencia entre los dos la decide la política del lote, no el resultado de la carga.

recontactedCount
integer
required

Contactos existentes que volvieron a ponerse en marcación mediante onDuplicate: recontact.

errors
object[]
required

Muestra de rechazos, hasta 20. Los contadores son el dato preciso; esto sirve para entender por qué se rechazaron.

Maximum array length: 20
createdAt
string<date-time>
required
completedAt
string<date-time> | null

Cuándo terminó de procesarse. null mientras status sea pending o running.