Skip to main content
GET
Listar conversaciones

Autorizaciones

Authorization
string
header
requerido

Token JWT de autenticação

Encabezados

x-company-id
string

Identificador de la empresa objetivo. Obligatorio solo para API keys globales (type=global). Se ignora para API keys de empresa y usuarios humanos.

Parámetros de consulta

inboxId
string

Filtrar por ID del inbox

agentId
string

Filtrar por ID del agente

teamId
string

Filtrar por ID del equipo

channel
string

Filtrar por tipo(s) de canal del inbox, separados por coma (ej.: WAP_AUTO_CLOSER,LINKEDIN)

stalled
string

Filtrar conversaciones detenidas (sin actividad del contacto hace más de 24 h)

transferred
string

Filtrar conversaciones transferidas de IA a agente humano

hasFollowUp
string

Filtrar conversaciones con follow-up programado

inCampaign
string

Filtrar conversaciones originadas de una campaña

inService
string

Filtrar conversaciones en atención (excluye follow-up y campaña)

userIds
string

Filtrar por IDs de los usuarios

whoAnswering
string

Filtrar por quién está respondiendo (AGENT/HUMAN)

status
string

Filtrar por estado (OPEN, RESOLVED)

agentStep
string

Filtrar por IDs de los pasos del flujo del agente

engagement
string

Filtrar por niveles de engagement

requiresAttention
string

Filtrar conversaciones que requieren atención

hasScheduledMeeting
string

Filtrar conversaciones con reunión programada (no cancelada)

startDate
string

Fecha inicial para filtrar conversaciones (createdAt >= startDate)

endDate
string

Fecha final para filtrar conversaciones (createdAt <= endDate)

advancedFilters
string

Filtros avanzados en formato JSON: [{ field, operator, value }]

page
string
predeterminado:1

Número de página (empieza en 1)

rowsPerPage
string
predeterminado:10

Cantidad de elementos por página

Respuesta

Lista de conversaciones devuelta correctamente

result
any[]
requerido

Lista de conversaciones

meta
any
requerido

Metadatos de la paginación