Get a Conversation
Returns the current state and message history of a specific conversation.
GET https://api.platica.mx/v1/conversations/{conversationId}Query parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
channelId | string | Narrows the lookup by channel when multiple conversations share the same conversationId | — |
URL parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
conversationId | string | Unique identifier of the conversation | ✓ |
Response
{
"workspaces": [
{
"id": "ws_001",
"name": "Soporte General",
"conversationsCount": 1,
"conversations": [
{
"id": "conv_001",
"conversationId": "987654321098",
"canSendDirectMessage": true,
"workspaceId": "ws_001",
"channelId": "channel_001",
"contactName": "Juan Pérez",
"phoneNumber": "1234567890",
"topic": "Consulta General",
"platform": "whatsapp",
"owners": [
"soporte@empresa.com"
],
"tags": [
"prioridad-alta"
],
"creationDate": "2025-03-15T10:00:00Z",
"lastUpdate": "2025-03-15T10:15:00Z",
"status": "active",
"operation": "assistance",
"messageCount": 4,
"messages": [
{
"content": "Hola, necesito información sobre sus servicios.",
"contentType": "text",
"creationDate": "2025-03-15T09:58:00Z",
"direction": "incoming",
"files": [],
"id": "msg_001",
"images": [],
"owner": {
"id": "user_001"
},
"lastUpdate": "2025-03-15T09:58:00Z",
"role": "user",
"status": "received"
},
{
"content": "Hola, ¿cómo puedo ayudarte hoy?",
"contentType": "text",
"creationDate": "2025-03-15T10:00:00Z",
"direction": "outgoing",
"files": [],
"id": "msg_002",
"images": [],
"owner": {
"id": "agent_001"
},
"lastUpdate": "2025-03-15T10:00:00Z",
"role": "assistant",
"status": "delivered"
},
{
"content": "Tengo una duda sobre el producto que compré.",
"contentType": "text",
"creationDate": "2025-03-15T10:05:00Z",
"direction": "incoming",
"files": [],
"id": "msg_003",
"images": [],
"owner": {
"id": "user_001"
},
"lastUpdate": "2025-03-15T10:05:00Z",
"role": "user",
"status": "received"
},
{
"content": "Gracias por tu consulta. Te ayudaré con eso.",
"contentType": "text",
"creationDate": "2025-03-15T10:10:00Z",
"direction": "outgoing",
"files": [],
"id": "msg_004",
"images": [],
"owner": {
"id": "agent_001"
},
"lastUpdate": "2025-03-15T10:10:00Z",
"role": "assistant",
"status": "delivered"
}
]
}
]
}
]
}| Field | Description |
|---|---|
id | Internal conversation ID |
conversationId | Public conversation ID (hash or customer phone number) |
canSendDirectMessage | Indicates whether direct messages can be sent (24-hour window active) |
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, telegram, etc.) |
owners | List of responsible-user emails |
tags | Tags associated with the conversation |
status | Conversation status. Can currently be active, finished, spam, or expired |
operation | Conversation operation mode |
messageCount | Total number of messages in the conversation |
messages | List of messages in the conversation |
creationDate | Creation date in ISO 8601 format |
lastUpdate | Last update date in ISO 8601 format |
| Field | Description |
|---|---|
id | Unique identifier of the message |
content | Message content |
contentType | Content type: text, image, audio, etc. |
creationDate | Message creation date and time |
direction | Direction of the message: incoming or outgoing |
files | List of files attached to the message |
images | List of images attached to the message |
lastUpdate | Date the message was last updated |
owner | Object with minimal sender information. Currently includes id when available |
role | Sender role: user (customer) or assistant (agent/AI) |
status | Message status: received, delivered, read, failed |
Consejo
If you need to change owners or status, use the update conversation endpoint.