Skip to main content
PUT
Actualizar conversación

Autorizaciones

Authorization
string
header
requerido

Token JWT de autenticação

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
additional_attributes
object

Atributos adicionales de la conversación (clave-valor)

custom_attributes
object

Atributos de sistema (deal vinculado, etc.)

who_answering
enum<string>

Quién está respondiendo (AGENT/HUMAN)

Opciones disponibles:
AGENT,
HUMAN,
UNASSIGNED
agent
string

ID del agente

current_step_slug
string

Slug del paso actual

current_step
string

ID del paso actual del flujo

requires_attention
object | null

Atención necesaria

contact_last_activity_at
string

Fecha de la última actividad del contacto

last_activity_at
string

Fecha de la última actividad

allow_send_messages_at
string

Fecha hasta la cual se pueden enviar mensajes (ventana de 24 h de WhatsApp)

referral
object

Datos de referral de la conversación (anuncios, publicaciones)

status
string

Estado de la conversación

custom_fields
object

Actualiza valores de campos personalizados de la conversación, por slug. Cubre select/multi_select (valor = option_id, o lista de ellos) y text (valor = el string). Para number/date, use additional_attributes, que conserva el tipo nativo. Validación atómica: un valor inválido no graba ningún campo y devuelve 422. Los option_id se obtienen de GET /v1/custom-fields/{id}/options.

resume
string

Resumen de la conversación generado por el specialist

temperature
enum<string>

Temperatura comercial clasificada por el specialist

Opciones disponibles:
HOT,
WARM,
COLD,
CLOSED
sentiment
enum<string>

Sentimiento clasificado por el specialist

Opciones disponibles:
POSITIVE,
NEUTRAL,
NEGATIVE
qualification
object

Calificación BANT/GPCT/MEDDIC (specialist)

lead_score
number

Lead score 0-100 basado en la calificación + ICP

Rango requerido: 0 <= x <= 100
safety_scores
object

Puntajes de seguridad (prompt injection, alucinación, etc.)

Respuesta

Conversación actualizada 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)