Skip to main content
PUT
Asignar usuario a la 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
userId
string
requerido

ID del usuario (agente humano) que se va a asignar

isToolCall
boolean
predeterminado:false

Si es una llamada a herramienta (tool call)

preserveWhoAnswering
boolean
predeterminado:false

Si es true, mantiene el who_answering actual (no fuerza HUMAN). Usado en la sincronización de owner de HubSpot.

triggeredBy
enum<string>

Origen de la asignación. Campo puramente de observabilidad, propagado solo para logs.

Opciones disponibles:
ai_tool_assign_user,
ai_tool_assign_team,
ai_tool_distribute_owner,
ai_tool_assign_linked_user,
webhook_hubspot_owner_sync,
campaign_step_config,
campaign_list_owner_reconcile,
ui_user,
ui_admin,
user_offboard_reassign,
manual_template_send,
internal
rejectInactiveUser
boolean

Si es true, asignar a un usuario que no está ACTIVE devuelve error en lugar de ignorar la asignación. Activado solo en la ruta del operador, donde hay alguien para leer el mensaje; todo camino automático (tool, webhook de CRM, campaña) usa el valor predeterminado false.

webhookEventId
string

eventId del webhook de HubSpot cuando la asignación se dispara mediante WebhookOwnerSyncService. Se propaga solo para logs.

Respuesta

Usuario asignado 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)