Conversaciones de un Cliente

Obtiene todas las conversaciones de un cliente: con uno o varios agentes y en todos los canales, incluidos los chats creados por la API de Chat . Devuelve un listado ligero sin el contenido de los mensajes (messages no se incluye; usa messageCount para conocer el volumen).

GET https://api.platica.mx/v1/clients/{clientId}/conversations

Nota

Este endpoint reemplaza el comportamiento que antes tenía GET /v1/conversations/{id} al consultarlo con un número de teléfono: la vista de todas las conversaciones de un cliente ahora vive aquí. Para leer el historial de un hilo específico, usa Obtener Conversación con su id único.

Parámetros de URL

Parámetro	Tipo	Descripción	Requerido
`clientId`	string	Puede ser el ID del cliente o su número de teléfono en formato E.164 sin `+`	✓

Parámetros de consulta

Parámetro	Tipo	Descripción	Requerido
`channelId`	string	Filtrar por identificador del canal	—
`agentId`	string	Filtrar por el agente principal de la conversación	—
`limit`	integer	Número máximo de conversaciones a retornar. Máximo: `200`. Por defecto: `50`	—
`offset`	integer	Número de conversaciones a saltar para paginación	—

Respuesta

{
  "clientId": "cliente_123",
  "workspaces": [
    {
      "id": "ws_001",
      "name": "Soporte",
      "conversationsCount": 2,
      "conversations": [
        {
          "id": "conv_001",
          "conversationId": "5215512345678",
          "clientId": "cliente_123",
          "agentId": "agent_001",
          "source": null,
          "canSendDirectMessage": true,
          "workspaceId": "ws_001",
          "channelId": "wb_001",
          "contactName": "Ana López",
          "phoneNumber": "5215512345678",
          "topic": "Consulta de póliza",
          "platform": "whatsapp",
          "status": "active",
          "operation": "automatic",
          "messageCount": 12,
          "owners": ["soporte@empresa.com"],
          "tags": ["vip"],
          "creationDate": "2026-07-20T18:00:00Z",
          "lastUpdate": "2026-07-20T18:15:00Z"
        },
        {
          "id": "conv_002",
          "conversationId": "chat_01JCHAT23456789",
          "clientId": "cliente_123",
          "agentId": "agent_002",
          "source": "api_chat",
          "canSendDirectMessage": true,
          "workspaceId": "ws_001",
          "channelId": "workspace-ws_001-agent-agent_002",
          "contactName": "Ana López",
          "phoneNumber": "5215512345678",
          "topic": "Renovación",
          "platform": "platica",
          "status": "finished",
          "operation": "automatic",
          "messageCount": 6,
          "owners": [],
          "tags": [],
          "creationDate": "2026-07-15T09:00:00Z",
          "lastUpdate": "2026-07-15T09:20:00Z"
        }
      ],
      "pagination": {
        "limit": 50,
        "offset": 0,
        "hasMore": false
      }
    }
  ]
}

Campo	Descripción
`id`	ID único y canónico del documento de conversación. Úsalo en `GET` y `PATCH /v1/conversations/{id}`
`conversationId`	ID del hilo de chat. En Chat API tiene formato `chat_*`; no identifica al cliente
`clientId`	ID del cliente atribuido a la conversación
`agentId`	ID del agente principal; no cambia durante una delegación temporal
`source`	Origen interno cuando aplica (por ejemplo `api_chat`); puede ser `null` en conversaciones legacy
`canSendDirectMessage`	Solo puede ser `false` en WhatsApp, Instagram y Messenger/Facebook; se calcula desde el último mensaje del usuario. En chats internos de Platica siempre es `true`
`workspaceId`	ID del workspace al que pertenece la conversación
`channelId`	ID del canal de comunicación
`contactName`	Nombre del contacto/cliente
`phoneNumber`	Número de teléfono del cliente
`topic`	Tema o asunto de la conversación
`platform`	Plataforma de mensajería (`whatsapp`, `instagram`, `facebook`, `platica`, etc.)
`status`	Etapa operativa: `initiated`, `active`, `finished`, `spam` o `expired`
`operation`	Modo de operación de la conversación
`messageCount`	Número total de mensajes. El listado no incluye el contenido de los mensajes
`owners`	Lista de correos de usuarios responsables
`tags`	Etiquetas asociadas a la conversación
`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

Anterior Eliminar un Cliente Siguiente Moderar un Cliente