Client Conversations

Returns every conversation of a client: with one or several agents and across all channels, including chats created by the Chat API . It is a lightweight listing without message content (messages is not included; use messageCount to gauge the volume).

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

Nota

This endpoint replaces the behavior GET /v1/conversations/{id} used to have when queried with a phone number: the view of every conversation of a client now lives here. To read the history of a specific thread, use Get Conversation with its unique id.

URL parameters

Parameter	Type	Description	Required
`clientId`	string	Can be the client's ID or their phone number in E.164 format without `+`	✓

Query parameters

Parameter	Type	Description	Required
`channelId`	string	Filter by channel identifier	—
`agentId`	string	Filter by the conversation's principal agent	—
`limit`	integer	Maximum number of conversations to return. Maximum: `200`. Default: `50`	—
`offset`	integer	Number of conversations to skip for pagination	—

Response

{
  "clientId": "client_123",
  "workspaces": [
    {
      "id": "ws_001",
      "name": "Support",
      "conversationsCount": 2,
      "conversations": [
        {
          "id": "conv_001",
          "conversationId": "5215512345678",
          "clientId": "client_123",
          "agentId": "agent_001",
          "source": null,
          "canSendDirectMessage": true,
          "workspaceId": "ws_001",
          "channelId": "wb_001",
          "contactName": "Ana López",
          "phoneNumber": "5215512345678",
          "topic": "Policy question",
          "platform": "whatsapp",
          "status": "active",
          "operation": "automatic",
          "messageCount": 12,
          "owners": ["support@example.com"],
          "tags": ["vip"],
          "creationDate": "2026-07-20T18:00:00Z",
          "lastUpdate": "2026-07-20T18:15:00Z"
        },
        {
          "id": "conv_002",
          "conversationId": "chat_01JCHAT23456789",
          "clientId": "client_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": "Renewal",
          "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
      }
    }
  ]
}

Field	Description
`id`	Unique, canonical document ID of the conversation. Use it in `GET` and `PATCH /v1/conversations/{id}`
`conversationId`	Chat thread ID. It uses the `chat_*` format in the Chat API and does not identify the client
`clientId`	ID of the client attributed to the conversation
`agentId`	Principal agent ID; temporary delegation does not change it
`source`	Internal origin when available (for example `api_chat`); may be `null` for legacy conversations
`canSendDirectMessage`	Can only be `false` on WhatsApp, Instagram, and Messenger/Facebook; calculated from the latest user message. Always `true` for internal Platica chats
`workspaceId`	ID of the workspace the conversation belongs to
`channelId`	Communication channel ID
`contactName`	Contact/customer name
`phoneNumber`	Customer phone number
`topic`	Conversation topic or subject
`platform`	Messaging platform (`whatsapp`, `instagram`, `facebook`, `platica`, etc.)
`status`	Operational stage: `initiated`, `active`, `finished`, `spam`, or `expired`
`operation`	Conversation operation mode
`messageCount`	Total number of messages. The listing does not include message content
`owners`	List of responsible-user emails
`tags`	Tags associated with the conversation
`creationDate`	Creation date in ISO 8601 format
`lastUpdate`	Last update date in ISO 8601 format

Field	Description
`limit`	Maximum number of results per page
`offset`	Number of results skipped
`hasMore`	Indicates whether more results are available

Previous Delete a Customer Next Moderate a Customer