Saltar al contenido principal
PUT
Actualizar estado de la conversación

Autorizaciones

Authorization
string
header
requerido

Token JWT de autenticación

Encabezados

x-company-id
string

Identificador de la empresa objetivo. Obligatorio solo para API keys globales (type=global). Se ignora para API keys de empresa y usuarios humanos.

Parámetros de ruta

id
string
requerido

ID de la conversación

Cuerpo

application/json
status
enum<string>
requerido

Status de la conversación (OPEN, RESOLVED)

Opciones disponibles:
OPEN,
RESOLVED
close_reason_ids
string[]

Motivos del cierre (ids de GET /v1/conversation-close-reasons), solo con status RESOLVED. Más de uno solo cuando la empresa acepta varios. Un id inválido, inexistente, inactivo o de otra empresa responde 400 CLOSE_REASON_INVALID.

Maximum array length: 50
Maximum string length: 64
close_note
string

Observación del cierre, hasta 1000 caracteres. Obligatoria cuando algún motivo exige observación.

Maximum string length: 1000

Respuesta

Status actualizado correctamente

last_activity_at
any
requerido

Fecha de la última actividad

status
enum<string>
requerido

Estado de la conversación

Opciones disponibles:
OPEN,
RESOLVED
who_answering
enum<string>
requerido

Quién está respondiendo (AGENT/HUMAN)

Opciones disponibles:
AGENT,
HUMAN,
UNASSIGNED
contact
any
requerido

Contacto de la conversación

inbox
any
requerido

Inbox de la conversación

company
any
requerido

Empresa de la conversación

_id
string

ID de la conversación

additional_attributes
any

Atributos adicionales de la conversación

agent_last_activity_at
any

Fecha de la última actividad del agente

contact_last_activity_at
any

Fecha de la última actividad del contacto

allow_send_messages_at
any

Fecha permitida para enviar mensajes

priority
enum<number>

Prioridad de la conversación

Opciones disponibles:
4,
3,
2,
1
agent
any

Agente asignado a la conversación

current_step
any

Paso actual del flujo del agente

user
any

Usuario asignado a la conversación

requires_attention
object

Atención necesaria

referral
any

Datos de referral de la conversación

createdAt
any

Fecha de creación de la conversación

updatedAt
any

Fecha de actualización de la conversación

resolved_count
number

Cantidad de conversaciones resueltas del contacto (solo cuando está agrupado)

closure
object

Cierre registrado: motivos, quién cerró y la foto de la conversación. Ausente con la conversación abierta o cerrada automáticamente.