Obtener chat
Obtiene el estado actual y el historial completo de un chat. La respuesta usa el mismo formato de detalle que Obtener conversación .
GET https://api.platica.mx/v1/chat/{id}Parámetros de URL
| Parámetro | Tipo | Descripción | Requerido |
|---|---|---|---|
id | string | ID único del chat, devuelto al crear o listar chats. | ✓ |
Respuesta
{
"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": 2,
"owners": ["ventas@empresa.com"],
"tags": ["prospecto"],
"creationDate": "2026-07-20T18:00:00.000Z",
"lastUpdate": "2026-07-20T18:30:00.000Z",
"messages": [
{
"id": "msg_user_01JCHAT98765432",
"role": "user",
"content": "Ayúdame a elegir el plan adecuado para mi equipo.",
"contentType": "text",
"direction": "incoming",
"status": "received",
"creationDate": "2026-07-20T18:29:40.000Z"
},
{
"id": "msg_assistant_01JCHAT98765433",
"role": "assistant",
"content": "Para un equipo de 25 personas con WhatsApp, estas son las mejores opciones...",
"contentType": "text",
"direction": "outgoing",
"status": "delivered",
"creationDate": "2026-07-20T18:30:00.000Z"
}
]
}| Campo | Descripción |
|---|---|
id | ID único y canónico del documento |
conversationId | ID del hilo (chat_*). No identifica al cliente |
clientId | Cliente al que está atribuido el chat |
agentId | Agente principal; una delegación temporal a un subagente no lo modifica |
canSendDirectMessage | Siempre true en los chats internos de Platica |
workspaceId | ID del workspace autorizado |
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 |
messageCount | Conteo almacenado del hilo |
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 |
messages | Historial completo de mensajes del chat, en orden cronológico |
| Campo | Descripción |
|---|---|
id | Identificador único del mensaje |
role | Rol del emisor: user (cliente) o assistant (agente/IA) |
content | Contenido del mensaje |
contentType | Tipo de contenido: text, image, audio, etc. |
direction | Dirección del mensaje: incoming (entrante) o outgoing (saliente) |
status | Estado del mensaje: received, delivered, read, failed |
creationDate | Fecha y hora de creación del mensaje |
Consejo
El acceso exige que el workspace esté autorizado y que el documento tenga source: "api_chat".