Get chat
Returns the current state and complete message history of a chat. The response uses the same detail format as Get conversation .
GET https://api.platica.mx/v1/chat/{id}URL parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
id | string | Unique chat ID returned when creating or listing chats. | ✓ |
Response
{
"id": "conversation_doc_01JCHAT",
"conversationId": "chat_01JCHAT23456789",
"clientId": "client_123",
"agentId": "agent_01JABCDEF23456789",
"canSendDirectMessage": true,
"workspaceId": "ws_001",
"channelId": "workspace-ws_001-agent-agent_01JABCDEF23456789",
"contactName": "Ana López",
"phoneNumber": "5215512345678",
"topic": "Plan selection",
"platform": "platica",
"source": "api_chat",
"status": "active",
"operation": "automatic",
"messageCount": 2,
"owners": ["sales@example.com"],
"tags": ["prospect"],
"creationDate": "2026-07-20T18:00:00.000Z",
"lastUpdate": "2026-07-20T18:30:00.000Z",
"messages": [
{
"id": "msg_user_01JCHAT98765432",
"role": "user",
"content": "Help me choose the right plan for my team.",
"contentType": "text",
"direction": "incoming",
"status": "received",
"creationDate": "2026-07-20T18:29:40.000Z"
},
{
"id": "msg_assistant_01JCHAT98765433",
"role": "assistant",
"content": "For a team of 25 people using WhatsApp, these are the best options...",
"contentType": "text",
"direction": "outgoing",
"status": "delivered",
"creationDate": "2026-07-20T18:30:00.000Z"
}
]
}| Field | Description |
|---|---|
id | Unique, canonical document ID |
conversationId | Thread ID (chat_*). It does not identify the client |
clientId | Client the chat is attributed to |
agentId | Principal agent; temporary delegation to a subagent does not change it |
canSendDirectMessage | Always true for internal Platica chats |
workspaceId | Authorized workspace ID |
channelId | Internal channel ID |
contactName | Contact/customer name |
phoneNumber | Customer phone number, when available |
topic | Chat topic or subject |
platform | Platform; platica for these chats |
source | Always api_chat |
status | Chat status: active, finished, or expired |
operation | Operation mode |
messageCount | Stored thread count |
owners | List of responsible-user emails |
tags | Associated tags |
creationDate | Creation date in ISO 8601 format |
lastUpdate | Last update date in ISO 8601 format |
messages | Full chat message history, in chronological order |
| Field | Description |
|---|---|
id | Unique identifier of the message |
role | Sender role: user (customer) or assistant (agent/AI) |
content | Message content |
contentType | Content type: text, image, audio, etc. |
direction | Direction of the message: incoming or outgoing |
status | Message status: received, delivered, read, failed |
creationDate | Message creation date and time |
Consejo
Access requires an authorized workspace and a document with source: "api_chat".