Listar contactos del Agent Desk
GET
/v1/org/{org_id}/inbox/contact
agent.output.view — OWNER ADMIN OPERATOR VIEWER
Contactos del inbox agrupados con sus conversaciones.
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
Requeridonumber
Parámetros de consulta
scope
mine = contacts where the authenticated user is the operator identity; all = every contact accessible in the org
Tipo
string
Valores válidos
"mine""all"Por defecto
"all"status
Filter conversations by status. ALL returns OPEN + CLOSED.
Tipo
string
Valores válidos
"open""pending""resolved""all"Por defecto
"open"agent_id
Restrict to a single agent
Tipo
number
Mínimo
1channel_id
Restrict to a single channel
Tipo
number
Mínimo
1Respuestas
application/json
JSON "data": [ { "id": 12, "kind": "EXTERNAL", "name": "Maria", "agent": { "id": 3, "name": "Captain", "avatar_url": "string" }, "assignee": { "kind": "AGENT", "id": 5, "name": "Captain", "avatar_url": "string" }, "channels": [ { "id": 2, "transport": "INTERNAL", "name": "Internal operators" } ], "conversations": [ { "id": 7, "status": "OPEN", "session_id": "a1b2…", "opened_at": "string", "last_activity_at": "string", "last_message": { "id": 42, "role": "ASSISTANT", "kind": "TEXT", "preview": "Sí, te llamas Maria Test", "created_at": "string" } } ], "last_activity_at": "string" } ], "total": 0
{
}