Listar conversas

Retorna uma lista paginada de conversas com filtros opcionais (inbox, agente, time, usuários, status, período de datas, etc.).

GET /v1/conversations

Listar conversas

cURL

curl --request GET \
  --url https://api.nuvia.ai/v1/conversations \
  --header 'Authorization: Bearer <token>'

200

{
  "result": [
    "<unknown>"
  ],
  "meta": "<unknown>"
}

Authorizations

Authorization · string · header · required

Token JWT de autenticação

Headers

x-company-id · string

Identificador da empresa-alvo. Obrigatório apenas para API Keys globais (type=global). Ignorado para API Keys de empresa e usuários humanos.

Query Parameters

inboxId · string

Filtrar por ID do inbox

agentId · string

Filtrar por ID do agente

teamId · string

Filtrar por ID do time

channel · string[]

Filtrar por tipo(s) de canal do inbox, separados por virgula (ex: WAP_AUTO_CLOSER,LINKEDIN)

stalled · string

Filtrar conversas paradas (sem atividade do contato há mais de 24h)

transferred · string

Filtrar conversas transferidas de IA para atendente humano

hasFollowUp · string

Filtrar conversas com follow-up agendado

inCampaign · string

Filtrar conversas originadas de campanha

inService · string

Filtrar conversas em atendimento (exclui follow-up e campanha)

userIds · string[]

Filtrar por IDs dos usuários

search · string

whoAnswering · string

Filtrar por quem está respondendo (AGENT/HUMAN)

status · string[]

Filtrar por status (OPEN, RESOLVED)

agentStep · string[]

Filtrar por IDs dos passos do fluxo do agente

engagement · string[]

Filtrar por níveis de engajamento

requiresAttention · string

Filtrar conversas que requerem atenção

startDate · string

Data inicial para filtrar conversas (createdAt >= startDate)

endDate · string

Data final para filtrar conversas (createdAt <= endDate)

advancedFilters · object[]

Filtros avançados em formato JSON: [{ field, operator, value }]

Maximum array length: 20

Show child attributes

page · string · default: 1

Número da página (começa em 1)

rowsPerPage · string · default: 10

Quantidade de itens por página

Response

200

application/json

Lista de conversas retornada com sucesso

result · any[] · required

Lista de conversas

meta · any · required

Metadados da paginação