Listar chats

Obtiene todos los chats con source: "api_chat" de los workspaces autorizados por la API key, sin restringirlos al usuario que los creó. Incluye el mismo resumen que Listar Conversaciones , sin messages.

GET https://api.platica.mx/v1/chat

Ejemplo filtrando por cliente:

GET https://api.platica.mx/v1/chat?clientId=cliente_123&limit=20

Parámetros de consulta

Parámetro	Tipo	Descripción	Requerido
`clientId`	string	Filtra los chats atribuidos a un cliente específico	—
`agentId`	string	Filtra por el agente principal del chat	—
`limit`	integer	Número máximo de chats a retornar. Máximo: `200`. Por defecto: `50`	—
`offset`	integer	Número de chats a saltar para paginación	—

Respuesta

{
  "chats": [
    {
      "id": "conversation_doc_01JCHAT",
      "conversationId": "chat_01JCHAT23456789",
      "clientId": "cliente_123",
      "agentId": "agent_01JABCDEF23456789",
      "canSendDirectMessage": true,
      "workspaceId": "ws_001",
      "channelId": "workspace-ws_001-agent-agent_01JABCDEF23456789",
      "contactName": "Ana López",
      "phoneNumber": "5215512345678",
      "topic": "Selección de plan",
      "platform": "platica",
      "source": "api_chat",
      "status": "active",
      "operation": "automatic",
      "messageCount": 4,
      "owners": ["ventas@empresa.com"],
      "tags": ["prospecto"],
      "creationDate": "2026-07-20T18:00:00.000Z",
      "lastUpdate": "2026-07-20T18:30:00.000Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "hasMore": false
  }
}

Campo	Descripción
`id`	ID único y canónico del documento. Úsalo en `GET /v1/chat/{id}` y en los endpoints de Conversaciones
`conversationId`	ID del hilo (`chat_*`). Cada nuevo Chat API genera uno distinto; úsalo para continuar con `POST /v1/chat`. No es un ID de cliente
`clientId`	Cliente al que está atribuido el chat
`agentId`	Agente principal del chat; no cambia cuando delega temporalmente a un subagente
`canSendDirectMessage`	Siempre `true` en los chats internos de Platica
`workspaceId`	ID del workspace autorizado al que pertenece el chat
`channelId`	ID del canal interno
`contactName`	Nombre del contacto/cliente
`phoneNumber`	Número de teléfono del cliente, cuando existe
`topic`	Tema o asunto del chat
`platform`	Plataforma; para estos chats es `platica`
`source`	Siempre `api_chat`
`status`	Estado del chat: `active`, `finished` o `expired`
`operation`	Modo de operación del chat
`messageCount`	Número total de mensajes; el listado no incluye `messages`
`owners`	Lista de correos de usuarios responsables
`tags`	Etiquetas asociadas
`creationDate`	Fecha de creación en formato ISO 8601
`lastUpdate`	Fecha de última actualización en formato ISO 8601

Campo	Descripción
`limit`	Número máximo de resultados por página
`offset`	Número de resultados omitidos
`hasMore`	Indica si hay más resultados disponibles

Consejo

Este listado se determina por los workspaces autorizados y source: "api_chat", no por quién creó el chat. Para consultar hilos de todos los canales, usa Listar Conversaciones .

Anterior Enviar mensaje al agente Siguiente Obtener chat