Actualizar Conversación
Permite actualizar los owners y el status de una conversación. La actualización aplica solo a la conversación indicada por su id único.
PATCH https://api.platica.mx/v1/conversations/{id}Parámetros de URL
| Parámetro | Tipo | Descripción | Requerido |
|---|---|---|---|
id | string | Identificador único de la conversación: el campo id que devuelven los listados. Consulta Cómo funcionan los IDs | ✓ |
Advertencia
Por compatibilidad, el endpoint todavía acepta como fallback el teléfono del cliente o el conversationId. Este comportamiento está deprecado: usa siempre el id único para actualizar exactamente el hilo que quieres modificar.
Cuerpo de la solicitud
Debes enviar al menos uno de los siguientes campos:
| Campo | Tipo | Descripción |
|---|---|---|
owners | array | Lista de correos de usuarios responsables |
status | string | Nuevo estado de la conversación |
Ejemplo
{
"owners": [
"soporte@empresa.com",
"ventas@empresa.com"
],
"status": "finished"
}Reglas de owners
- Deben enviarse como correos electrónicos
- Cada correo debe existir como usuario del workspace
Reglas de transición de status
Valores permitidos: active, finished, spam, expired.
Expirar una conversación es una forma de cierre (isFinished): el status final puede quedar finished o expired según si el cliente llegó a responder en el hilo.
- Canales externos (WhatsApp, Instagram, Facebook):
expiredes un estado terminal. El siguiente contacto del cliente comenzará una nueva conversación. - Chats internos de la API: un chat cerrado o expirado sí puede reabrirse, ya sea con un
PATCHastatus: "active"o automáticamente al recibir un mensaje nuevo vía la API de Chat .
Respuesta
{
"status": "success",
"message": "Conversation updated successfully",
"data": {
"ids": [
"conv_001"
]
}
}