Listar conversas (Lista de Conversas — ISSUE-5636)

Retorna conversas paginadas para a página Lista de Conversas. Filtros, sort e paginação são otimizados via aggregation com $facet.

GET /v1/conversations/list

Listar conversas (Lista de Conversas — ISSUE-5636)

cURL

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

200

{}

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

status · enum<string>

Available options: OPEN, RESOLVED

who_answering · enum<string>

Available options: AGENT, HUMAN, UNASSIGNED

priority · enum<string>

Available options: 4, 3, 2, 1

agent · string

user · string

inbox · string

current_step · string

last_activity_at_from · string

last_activity_at_to · string

search · string

Maximum string length: 200

has_referral · string

sentiment · string

Maximum string length: 40

lead_score_min · string

lead_score_max · string

sort_by · enum<string> · default: last_activity_at

Available options: last_activity_at, createdAt, updatedAt, status, priority, lead_score, contact.name, inbox.name, agent.name, user.name

sort_dir · enum<string> · default: desc

Available options: asc, desc

page · string

page_size · string

requested_columns · string[]

Maximum array length: 200

Maximum string length: 120

advancedFilters · object[]

Maximum array length: 20

Show child attributes

Response

200 - application/json

The response is of type object.