KUJIRA

Español

English

Español

English

Apariencia

Listar todas las conversaciones​

GET
/v1/org/{org_id}/conversation

conversation.view — OWNER ADMIN

Todas las conversaciones de la organización — vista unificada, filtrada y paginada.

Autorizaciones​

bearer

Token de servicio (kjtk_live_…), creado desde el panel en Ajustes → Tokens de servicio. Pertenece a una organización y lleva sus propios permisos.

Tipo
HTTP (bearer)
o
JWT

Sesión de una persona en el panel. No sirve para integrar.

Tipo
HTTP (bearer)

Parámetros​

Parámetros de la ruta

org_id*
Tipo
number
Requerido

Parámetros de consulta

id

Exact conversation id (deep-link).

Tipo
number
Mínimo
1
agent_id

Filter by the owning agent id.

Tipo
number
Mínimo
1
contact_id

Filter by contact id.

Tipo
number
Mínimo
1
channel_id

Filter by a specific channel id.

Tipo
number
Mínimo
1
transport

Filter by channel transport (TELEGRAM, GMAIL, DISCORD…).

Tipo
string
Longitud mín.
1
Longitud máx.
32
status

Filter by conversation status (OPEN, PENDING, RESOLVED, ARCHIVED).

Tipo
string
Valores válidos
"OPEN""PENDING""RESOLVED""ARCHIVED"
model

Filter by the model last observed.

Tipo
string
Longitud mín.
1
Longitud máx.
120
ref

Opaque conversation ref (case-insensitive).

Tipo
string
Longitud mín.
1
Longitud máx.
40
search

Free-text search over the contact name + channel name.

Tipo
string
Longitud mín.
1
Longitud máx.
200
sort

Sort column: activity (last message), created (opened), contact (name), agent (name), channel (transport), model, status. Default: activity.

Tipo
string
Valores válidos
"activity""created""contact""agent""channel""model""status"
order

Sort direction. Default: desc.

Tipo
string
Valores válidos
"asc""desc"
limit

Page size (1–200, default 50).

Tipo
number
Mínimo
1
Máximo
200
offset

Rows to skip (default 0).

Tipo
number
Mínimo
0

Respuestas​

application/json
JSON
{
  
"rows": [
  
  
{
  
  
  
"id": 1,
  
  
  
"ref": "MZROL9UC",
  
  
  
"status": "OPEN",
  
  
  
"model": "claude-haiku-4-5",
  
  
  
"model_override": "claude-haiku-4-5",
  
  
  
"effort_override": "HIGH",
  
  
  
"effective_model": "claude-opus-5",
  
  
  
"context_tokens": 96000,
  
  
  
"context_window": 1000000,
  
  
  
"agent": {
  
  
  
  
"id": 5,
  
  
  
  
"name": "soki",
  
  
  
  
"avatar_url": "string",
  
  
  
  
"provider": "anthropic"
  
  
  
},
  
  
  
"contact": {
  
  
  
  
"id": 1,
  
  
  
  
"kind": "INTERNAL_USER",
  
  
  
  
"name": "Alice",
  
  
  
  
"user_id": 0
  
  
  
},
  
  
  
"channel": {
  
  
  
  
"id": 1,
  
  
  
  
"transport": "TELEGRAM",
  
  
  
  
"name": "Chat interno"
  
  
  
},
  
  
  
"last_activity_at": "string",
  
  
  
"debug_visible_until": "string"
  
  
}
  
],
  
"total": 1234,
  
"limit": 50,
  
"offset": 0
}

Pruébalo​

Autorización
Variables
Clave
Valor

Ejemplos​