Skip to main content
PUT
Reagenda un contacto ya cargado en el lote. En el body debes enviar exactamente uno de estos campos:
  • contactId: identificador interno que genera Inagent al importar el contacto.
  • identifier: identificador externo definido en el sistema de origen.
El campo scheduledAt fija cuándo se realizará el próximo intento. Debe contener una fecha futura en UTC, con formato ISO 8601, y estar situada dentro de los próximos 30 días.
Usa resetAttempts: true si el contacto ya agotó sus intentos o ya fue contactado. Sin este campo, la fecha se guarda, pero el contacto no vuelve a ponerse en marcación en esos casos. La respuesta 200 confirma que la solicitud fue aceptada; el motor de marcación puede tardar en reflejar la nueva fecha.

Ejemplos de body

No envíes contactId e identifier en la misma petición.

Authorizations

apikey
string
header
required

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

Headers

Idempotency-Key
string

Clave para hacer el reintento seguro. Opcional.

Un UUID por operación lógica, reusado en los reintentos de ese mismo envío. Ver "Reintentos seguros" en la descripción de la API.

Maximum string length: 255
Pattern: ^[\x20-\x7E]+$

Path Parameters

batchId
string<uuid>
required

Id del lote.

Body

application/json
contactId
string<uuid>
required

Identificador interno asignado por el servicio al importar el contacto.

Example:

"7d2f8a1b-3c4e-4f50-9a6b-2c3d4e5f6a7b"

scheduledAt
string<date-time>
required

Fecha y hora del próximo intento. Debe ser futura y estar dentro de los próximos 30 días.

Example:

"2026-09-23T08:41:43.522Z"

identifier
string

Identificador del contacto en el sistema de origen.

Example:

"CLI-001"

resetAttempts
boolean

Indica si se reinicia el contador de intentos al reagendar. Es necesario para volver a marcar un contacto que agotó sus intentos o que ya fue contactado.

Example:

true

reason
string

Motivo de la reprogramación. Queda registrado a título informativo y no afecta al comportamiento de la marcación.

Example:

"El cliente pidió que lo llamen más tarde"

Response

Reprogramación aceptada.

contactId
string<uuid>
required
batchId
string<uuid>
required
scheduledAt
string<date-time>
required
scheduled
boolean
required
reason
string