Atribuir usuário à conversa

curl --request PUT \ --url https://api.nuvia.ai/v1/conversations/{id}/assign-user \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "userId": "<string>", "isToolCall": false, "preserveWhoAnswering": false, "webhookEventId": "<string>" } '

{ "last_activity_at": "<unknown>", "contact": "<unknown>", "inbox": "<unknown>", "company": "<unknown>", "_id": "<string>", "additional_attributes": "<unknown>", "agent_last_activity_at": "<unknown>", "contact_last_activity_at": "<unknown>", "allow_send_messages_at": "<unknown>", "agent": "<unknown>", "current_step": "<unknown>", "user": "<unknown>", "requires_attention": { "requested_at": "<unknown>" }, "referral": "<unknown>", "createdAt": "<unknown>", "updatedAt": "<unknown>", "resolved_count": 123 }

Authorizations

Authorization

string

header

required

Token JWT de autenticação

Headers

x-company-id

string

Identificador da empresa-alvo. Obrigatório apenas para API Keys globais (type=global). Ignorado para API Keys de empresa e usuários humanos.

Path Parameters

string

required

ID da conversa

Body

application/json

userId

string

required

ID do usuário (atendente) a ser atribuído

isToolCall

boolean

default:false

Se é uma chamada de ferramenta (tool call)

preserveWhoAnswering

boolean

default:false

Se true, mantém o who_answering atual (não força HUMAN). Usado na sincronização de owner HubSpot.

triggeredBy

enum<string>

Origem da atribuição. Campo puramente de observabilidade, propagado apenas para logs.

Available options:

ai_tool_assign_user,

ai_tool_assign_team,

ai_tool_assign_linked_user,

webhook_hubspot_owner_sync,

ui_user,

ui_admin,

internal

webhookEventId

string

eventId do webhook HubSpot quando a atribuição é disparada via WebhookOwnerSyncService. Propagado apenas para logs.

Response

Usuário atribuído com sucesso

last_activity_at

any

required

Data da última atividade

status

enum<string>

required

Status da conversa

Available options:

OPEN,

RESOLVED

who_answering

enum<string>

required

Quem está respondendo (AGENT/HUMAN)

Available options:

AGENT,

HUMAN,

UNASSIGNED

contact

any

required

Contato da conversa

inbox

any

required

Inbox da conversa

company

any

required

Empresa da conversa

_id

string

ID da conversa

additional_attributes

any

Atributos adicionais da conversa

agent_last_activity_at

any

Data da última atividade do agente

contact_last_activity_at

any

Data da última atividade do contato

allow_send_messages_at

any

Data permitida para enviar mensagens

priority

enum<number>

Prioridade da conversa

Available options:

4,

3,

2,

1

agent

any

Agente atribuído à conversa

current_step

any

Passo atual do fluxo do agente

user

any

Usuário atribuído à conversa

requires_attention

object

Atenção necessária

Show child attributes

referral

any

Dados de referral da conversa

createdAt

any

Data de criação da conversa

updatedAt

any

Data de atualização da conversa

resolved_count

number

Quantidade de conversas resolvidas do contato (apenas quando agrupado)