Obtener un lote

Consulta un lote

curl --request GET \
  --url https://api.backend.inconcertcc.com/autocontact/api/v1/batches/{batchId} \
  --header 'apikey: <api-key>'

import requests

url = "https://api.backend.inconcertcc.com/autocontact/api/v1/batches/{batchId}"

headers = {"apikey": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {apikey: '<api-key>'}};

fetch('https://api.backend.inconcertcc.com/autocontact/api/v1/batches/{batchId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.backend.inconcertcc.com/autocontact/api/v1/batches/{batchId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "apikey: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.backend.inconcertcc.com/autocontact/api/v1/batches/{batchId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("apikey", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.backend.inconcertcc.com/autocontact/api/v1/batches/{batchId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["apikey"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "e8b63614-f5db-4fd4-84ab-258b7070262e",
  "name": "lote_ventas",
  "channelName": "Marcador_ventas",
  "channelType": "Livekit_SipCall",
  "channelId": "55210458-1957-4023-b7cc-82bbb5124aaa",
  "status": "archived",
  "displayStatus": "archived",
  "statusReason": "manual",
  "statusChangedAt": "2026-09-07T11:28:37.000Z",
  "statusChangedBy": "b5860478-5927-4362-8b59-c8f42149d045",
  "totalContacts": 6,
  "fileRowCount": 1,
  "contactedCount": 0,
  "processedCount": 2,
  "finishedCount": 2,
  "uploadStatus": "completed",
  "uploadProgress": 1,
  "mapping": {
    "name": "nombre",
    "priority": "",
    "addresses": [
      {
        "column": "telefono",
        "priority": 1
      }
    ],
    "identifier": "id",
    "customFields": [],
    "identifierLooksConstant": false
  },
  "filters": null,
  "schedule": null,
  "rules": {
    "amd": {
      "amdAction": "HANGUP",
      "amdEnabled": true
    },
    "strategy": {
      "timezone": "Europe/Madrid",
      "daysOfWeek": [1, 2, 3, 4, 5],
      "scheduleEnd": "19:00",
      "scheduleStart": "08:00",
      "timeBetweenAttempts": 3,
      "maxAttemptsPerAddress": 2,
      "maxAttemptsPerContact": 4,
      "processAllContactsFirst": false
    },
    "channelType": "livekit_sipcall",
    "resultRules": {
      "busy": { "maxRetries": 2, "retryDelay": 15 },
      "failed": { "maxRetries": 2, "retryDelay": 15 },
      "noAnswer": { "maxRetries": 2, "retryDelay": 15 },
      "voicemail": { "maxRetries": 2, "retryDelay": 15 }
    },
    "addressPriority": {
      "tryAllBeforeRetry": true
    }
  },
  "duplicateStrategy": {
    "action": "update_always",
    "enabled": true,
    "detectionCriteria": "phone"
  },
  "channelPriority": 1,
  "statusDetail": null,
  "queueSyncStatus": "completed",
  "isFavorite": false,
  "enabled": true,
  "deleted": false,
  "createdAt": "2026-09-07T10:53:45.000Z",
  "updatedAt": "2026-09-07T11:28:37.000Z",
  "channel": {
    "id": "55210458-1957-4023-b7cc-82bbb5124aaa",
    "crewId": "3de07003-adc0-4b7a-b1d4-333220d51fb4.equipo-ventas.latest"
  },
  "crewId": "3de07003-adc0-4b7a-b1d4-333220d51fb4.equipo-ventas.latest"
}

GET

batches

{batchId}

Consulta un lote

curl --request GET \
  --url https://api.backend.inconcertcc.com/autocontact/api/v1/batches/{batchId} \
  --header 'apikey: <api-key>'

import requests

url = "https://api.backend.inconcertcc.com/autocontact/api/v1/batches/{batchId}"

headers = {"apikey": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {apikey: '<api-key>'}};

fetch('https://api.backend.inconcertcc.com/autocontact/api/v1/batches/{batchId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.backend.inconcertcc.com/autocontact/api/v1/batches/{batchId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "apikey: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.backend.inconcertcc.com/autocontact/api/v1/batches/{batchId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("apikey", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.backend.inconcertcc.com/autocontact/api/v1/batches/{batchId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["apikey"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "e8b63614-f5db-4fd4-84ab-258b7070262e",
  "name": "lote_ventas",
  "channelName": "Marcador_ventas",
  "channelType": "Livekit_SipCall",
  "channelId": "55210458-1957-4023-b7cc-82bbb5124aaa",
  "status": "archived",
  "displayStatus": "archived",
  "statusReason": "manual",
  "statusChangedAt": "2026-09-07T11:28:37.000Z",
  "statusChangedBy": "b5860478-5927-4362-8b59-c8f42149d045",
  "totalContacts": 6,
  "fileRowCount": 1,
  "contactedCount": 0,
  "processedCount": 2,
  "finishedCount": 2,
  "uploadStatus": "completed",
  "uploadProgress": 1,
  "mapping": {
    "name": "nombre",
    "priority": "",
    "addresses": [
      {
        "column": "telefono",
        "priority": 1
      }
    ],
    "identifier": "id",
    "customFields": [],
    "identifierLooksConstant": false
  },
  "filters": null,
  "schedule": null,
  "rules": {
    "amd": {
      "amdAction": "HANGUP",
      "amdEnabled": true
    },
    "strategy": {
      "timezone": "Europe/Madrid",
      "daysOfWeek": [1, 2, 3, 4, 5],
      "scheduleEnd": "19:00",
      "scheduleStart": "08:00",
      "timeBetweenAttempts": 3,
      "maxAttemptsPerAddress": 2,
      "maxAttemptsPerContact": 4,
      "processAllContactsFirst": false
    },
    "channelType": "livekit_sipcall",
    "resultRules": {
      "busy": { "maxRetries": 2, "retryDelay": 15 },
      "failed": { "maxRetries": 2, "retryDelay": 15 },
      "noAnswer": { "maxRetries": 2, "retryDelay": 15 },
      "voicemail": { "maxRetries": 2, "retryDelay": 15 }
    },
    "addressPriority": {
      "tryAllBeforeRetry": true
    }
  },
  "duplicateStrategy": {
    "action": "update_always",
    "enabled": true,
    "detectionCriteria": "phone"
  },
  "channelPriority": 1,
  "statusDetail": null,
  "queueSyncStatus": "completed",
  "isFavorite": false,
  "enabled": true,
  "deleted": false,
  "createdAt": "2026-09-07T10:53:45.000Z",
  "updatedAt": "2026-09-07T11:28:37.000Z",
  "channel": {
    "id": "55210458-1957-4023-b7cc-82bbb5124aaa",
    "crewId": "3de07003-adc0-4b7a-b1d4-333220d51fb4.equipo-ventas.latest"
  },
  "crewId": "3de07003-adc0-4b7a-b1d4-333220d51fb4.equipo-ventas.latest"
}

Devuelve la información de un lote concreto, incluidos su estado, métricas, configuración y canal asociado.

Autenticación

string

required

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

Parámetros de ruta

string

required

Identificador único del lote.

Ejemplo

cURL

curl --request GET \
  --url 'https://api.backend.inconcertcc.com/autocontact/api/v1/batches/e8b63614-f5db-4fd4-84ab-258b7070262e' \
  --header 'apikey: TU_API_KEY'

{
  "id": "e8b63614-f5db-4fd4-84ab-258b7070262e",
  "name": "lote_ventas",
  "channelName": "Marcador_ventas",
  "channelType": "Livekit_SipCall",
  "channelId": "55210458-1957-4023-b7cc-82bbb5124aaa",
  "status": "archived",
  "displayStatus": "archived",
  "statusReason": "manual",
  "statusChangedAt": "2026-09-07T11:28:37.000Z",
  "statusChangedBy": "b5860478-5927-4362-8b59-c8f42149d045",
  "totalContacts": 6,
  "fileRowCount": 1,
  "contactedCount": 0,
  "processedCount": 2,
  "finishedCount": 2,
  "uploadStatus": "completed",
  "uploadProgress": 1,
  "mapping": {
    "name": "nombre",
    "priority": "",
    "addresses": [
      {
        "column": "telefono",
        "priority": 1
      }
    ],
    "identifier": "id",
    "customFields": [],
    "identifierLooksConstant": false
  },
  "filters": null,
  "schedule": null,
  "rules": {
    "amd": {
      "amdAction": "HANGUP",
      "amdEnabled": true
    },
    "strategy": {
      "timezone": "Europe/Madrid",
      "daysOfWeek": [1, 2, 3, 4, 5],
      "scheduleEnd": "19:00",
      "scheduleStart": "08:00",
      "timeBetweenAttempts": 3,
      "maxAttemptsPerAddress": 2,
      "maxAttemptsPerContact": 4,
      "processAllContactsFirst": false
    },
    "channelType": "livekit_sipcall",
    "resultRules": {
      "busy": { "maxRetries": 2, "retryDelay": 15 },
      "failed": { "maxRetries": 2, "retryDelay": 15 },
      "noAnswer": { "maxRetries": 2, "retryDelay": 15 },
      "voicemail": { "maxRetries": 2, "retryDelay": 15 }
    },
    "addressPriority": {
      "tryAllBeforeRetry": true
    }
  },
  "duplicateStrategy": {
    "action": "update_always",
    "enabled": true,
    "detectionCriteria": "phone"
  },
  "channelPriority": 1,
  "statusDetail": null,
  "queueSyncStatus": "completed",
  "isFavorite": false,
  "enabled": true,
  "deleted": false,
  "createdAt": "2026-09-07T10:53:45.000Z",
  "updatedAt": "2026-09-07T11:28:37.000Z",
  "channel": {
    "id": "55210458-1957-4023-b7cc-82bbb5124aaa",
    "crewId": "3de07003-adc0-4b7a-b1d4-333220d51fb4.equipo-ventas.latest"
  },
  "crewId": "3de07003-adc0-4b7a-b1d4-333220d51fb4.equipo-ventas.latest"
}

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.

Response

El lote.

Lote de marcación. Es la estructura que devuelven tanto la consulta de un lote como cada elemento del listado.

string<uuid>

name

string

channelId

string<uuid>

channelName

string

channelType

string

Tipo de canal, tal como lo expone el catálogo de canales. Por ejemplo Livekit_SipCall.

Example:

"Livekit_SipCall"

channelPriority

integer

Peso al repartir la capacidad del canal entre lotes que corren a la vez.

Required range: 1 <= x <= 10

crewId

string | null

status

enum<string>

Estado persistido.

deleting y archiving son transitorios: el lote no admite ninguna acción mientras está en uno de ellos, y cualquier intento responde 409.

Available options:

stopped,

running,

completed,

archived,

deleting,

archiving

displayStatus

string

Estado efectivo del lote en el momento de la consulta. Es el valor recomendado para mostrar o evaluar la situación del lote.

Puede no coincidir con status: un lote con status: running fuera de su ventana horaria devuelve scheduled, ya que no realizará llamadas hasta que la ventana se abra.

Example:

"scheduled"

statusReason

enum<string>

Por qué está en ese estado. manual y scheduled son los que puede declarar un cliente al arrancar o detener; el resto los escribe el servicio.

Available options:

created,

manual,

scheduled,

no more contacts,

system

statusChangedAt

string<date-time> | null

statusChangedBy

string | null

statusDetail

string | null

nextActivationAt

string<date-time> | null

Fecha y hora en que un lote en espera reanudará la marcación. null si no procede.

En el listado puede venir vacío aunque el lote tenga una ventana horaria configurada, ya que allí solo se calcula para los lotes en curso. Para obtener el valor en cualquier estado, consulte el lote por su identificador.

totalContacts

integer

Contactos del lote.

fileRowCount

integer

Filas del CSV original. Puede ser mayor que totalContacts: las filas sin dirección utilizable, o descartadas por filtros o duplicados, no llegan a ser contactos.

processedCount

integer

Número de contactos ya procesados. En un lote en curso refleja el estado actual de la marcación; si esa información no está disponible momentáneamente, se devuelve el último valor registrado.

contactedCount

integer

Contactos efectivamente contactados.

finishedCount

integer

Contactos cerrados sin haber sido contactados: se agotaron sus intentos o sus direcciones.

uploadStatus

string

Estado de la importación del CSV.

uploadProgress

integer

Required range: 0 <= x <= 100

queueSyncStatus

enum<string>

Estado de la carga de los contactos en el motor de marcación.

Es necesario para distinguir un lote que está arrancando de uno que ya está marcando: el lote pasa a running antes de que la carga finalice.

Available options:

pending,

syncing,

completed,

failed

mapping

object

Qué columna del CSV es cada cosa.

filters

object | null

schedule

object | null

Ventana horaria propia. null si hereda la de la cuenta.

Show child attributes

rules

object | null

Reglas de marcación del lote. null si usa las reglas globales de la cuenta.

duplicateStrategy

object | null

isFavorite

boolean

s3CsvKey

string

Ubicación interna del CSV importado.

s3SnapshotKey

string | null

Ubicación interna del snapshot, en lotes archivados.

channel

object | null

Datos del canal resuelto.

enabled

boolean

deleted

boolean

TenantId

string

createdAt

string<date-time>

updatedAt

string<date-time>

createdBy

string

updatedBy

string

Introducción a la API

Endpoints principales

Eventos

Marcador de Inagent

Reportes

Obtener un lote

Autenticación

Parámetros de ruta

Ejemplo

Authorizations

Path Parameters

Response

​Autenticación

​Parámetros de ruta

​Ejemplo

Authorizations

Path Parameters

Response

Autenticación

Parámetros de ruta

Ejemplo